# 更新仓库转移任务状态 - UpdateTransferTask
#### 功能介绍
更新仓库转移任务的状态
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CodeArtsRepo/doc?api=UpdateTransferTask&version=v4)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
PUT /v4/repositories/{repository_id}/transfer-task
表1路径参数 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| repository_id | 是    | Integer | **参数解释：** 仓库的ID，通过[查询用户所有仓库](https://support.huaweicloud.com/api-codeartsrepo/ListUserAllRepositories.html)接口查询项目列表获取。 **约束限制：** 不涉及。 **默认取值：** 不涉及。 **取值范围：** 1\~2147483647 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| status | 否    | String | **参数解释：** 转移任务状态。 **约束限制：** 必填。 **取值范围：** - abort，中止任务。    **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数            | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| status        | String  | **参数解释：** 转移任务状态。 **约束限制：** 不涉及。 **取值范围：** - init，初始化。   - process，处理中。   - abort，已中止。   - failed，失败。   - success，成功。    **默认取值：** 不涉及。 |
| error_message | String  | **参数解释：** 错误信息。 **约束限制：** 不涉及。 **取值范围：** 字符串。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| timeout       | Boolean | **参数解释：** 是否超时。 **约束限制：** 不涉及。 **取值范围：** - true，超时。   - false，未超时。    **默认取值：** 不涉及.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| updated_at    | String  | **参数解释：** 更新时间。 **约束限制：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
**状态码：401**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                    |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。  |
| error_msg  | String | **参数解释：** 错误信息。 |
   
**状态码：403**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                    |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。  |
| error_msg  | String | **参数解释：** 错误信息。 |
   
#### 请求示例
```
PUT /v4/repositories/2112124339/transfer-task
{
  "status" : "abort"
}
```
#### 响应示例
**状态码：200**
仓库转移任务信息
```
{
  "status" : "abort",
  "error_message" : "",
  "timeout" : false,
  "updated_at" : "2024-01-01T12:00:00.000Z"
}
```
**状态码：401**
Unauthorized
```
{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}
```
**状态码：403**
Forbidden
```
{
  "error_code" : "CH.004403",
  "error_msg" : "您没有操作权限，请升级权限后重试。"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | 仓库转移任务信息     |
| 401 | Unauthorized |
| 403 | Forbidden    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-codeartsrepo/ErrorCode.html)。