查询指定ID的任务
功能介绍
查询租户指定ID的任务信息。
请求消息
请求参数
无。
响应消息
响应参数
响应参数如表2所示。
|
参数 |
类型 |
描述 |
|---|---|---|
|
id |
long |
任务ID。 |
|
name |
String |
任务名称。 |
|
src_node |
JSONObject |
源端节点信息，参见表3。 |
|
dst_node |
JSONObject |
目的端节点信息，参见表5。 |
|
thread_num |
int |
迁移线程数。 |
|
status |
int |
任务状态。
|
|
progress |
double |
任务进度，例如：0.522代表任务进度为52.2%，1代表任务进度为100%。 |
|
migrate_speed |
long |
任务迁移速度（Byte/s）。 |
|
enableKMS |
boolean |
是否使用KMS加密。 |
|
description |
String |
任务描述，没有设置时为空字符串。 |
|
error_reason |
JSONObject |
任务失败原因，参见表8。 |
|
total_size |
long |
任务迁移总大小。 |
|
complete_size |
long |
任务迁移完成大小。 |
|
start_time |
long |
任务启动时间。 |
|
left_time |
long |
任务剩余时间。 |
|
total_time |
long |
任务总时间。 |
|
success_num |
long |
迁移成功对象数量。 |
|
fail_num |
long |
迁移失败对象数量。 |
|
total_num |
long |
迁移对象总数量。 |
|
smnInfo |
JSONObject |
SMN消息，参见表6。  说明：
用户可以选择是否发送SMN信息，在迁移任务已经结束的情况下才会有该字段。 |
|
migrate_since |
long |
迁移指定时间，表示仅迁移在指定时间之后修改的源端待迁移对象。默认为0，表示不设置迁移指定时间。 |
|
task_type |
String |
任务类型，为空则默认设置为object。
|
|
source_cdn |
JSONObject |
指定是否启用CDN迁移支持，参见表7。若包含此字段则为支持，否则为不支持。启用CDN迁移支持后，迁移时将从CDN域名获取源端对象。 |
|
auto_restore |
Boolean |
是否自动解冻归档数据。开启后，如果遇到归档类型数据，会自动解冻再进行迁移。 |
|
enable_failed_object_recording |
Boolean |
是否记录失败对象。开启后，如果有迁移失败对象，会在目的端存储失败对象信息。 |
|
failed_object_record |
String |
数据格式为JSON格式，参见表9。 |
|
bandwidth_policy |
JSONArray |
流量控制策略，参见表10。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
region |
String |
源端桶所处的区域。 |
|
list_file |
JSONObject |
数据格式为JSON格式，参见表4。 |
|
object_key |
JSONArray |
源端桶选择的对象名称。每个元素均为对象的绝对路径。 |
|
bucket |
String |
源端桶的名称。 |
|
cloud_type |
String |
源端云服务商。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
region |
String |
目的端桶所处的区域。 |
|
object_key |
String |
目的端桶选择的对象名称。 |
|
bucket |
String |
目的端桶的名称。 |
|
cloud_type |
String |
目的端云服务商。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
notifyResult |
Boolean |
记录迁移任务执行完毕后SMN消息是否发送成功。 |
|
notifyErrorMessage |
String |
记录SMN消息发送失败原因的错误码（迁移任务成功时为空）。 |
|
topicName |
String |
SMN Topic的名称（SMN消息发送成功时为空）。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
protocol |
String |
协议类型：https或http。 |
|
domain |
String |
从指定域名获取对象。 |
|
authentication_type |
String |
鉴权方式。
|
示例
请求示例
GET /v1/{project_id}/objectstorage/task/{task_id}
响应示例
{
"id": 1,
"name": "bucket3-bucket3-20161027211637786_544",
"src_node": {
"region": "us-east-1",
"bucket": "bucket3",
"object_key": "/",
"cloud_type": "xxx"
},
"dst_node": {
"region": "xxx",
"bucket": "bucket3",
"object_key": ["log/object1", "log/object2"],
"cloud_type": "HEC"
},
"thread_num": 50,
"status": 5,
"progress": 1,
"total_num": 2000,
"success_num": 200,
"fail_num": 0,
"migrate_speed": 7213154,
"enableKMS": true,
"description": "ZXCZCZXCDVXVC",
"error_reason": "",
"total_size": 2000000000,
"complete_size": 2000000000,
"start_time": 1477574224062,
"left_time": 0,
"total_time": 88124,
"smnInfo": {
"notifyResult": false,
"notifyErrorMessage": "S3M.0156",
"topicName": "Test"
},
"migrate_since": 123456789,
"source_cdn": {
"protocol": "https",
"domain": "xxx.xxx.xxx",
"authentication_type": "NONE"
},
"bandwidth_policy": [
{
"start": "00:00",
"end": "23:59",
"max_bandwidth": 50000000
}
]
}状态码
状态码请参见状态码。
