对象存储迁移服务 OMS-查询指定ID的任务:响应消息

时间：2025-03-04 14:22:24

响应消息

响应参数

响应参数如表2所示。

表2 响应参数
参数	类型	描述
id	long	任务ID。
name	String	任务名称。
src_node	JSONObject	源端节点信息，参见表3。
dst_node	JSONObject	目的端节点信息，参见表5。
thread_num	int	迁移线程数。
status	int	任务状态。 0：初始化 1：等待调度 2：正在执行 3：停止 4：失败 5：成功
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。 list：对象列表迁移 object：文件/文件夹迁移 prefix：对象前缀迁移
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。

表3 src_node数据结构说明
参数	类型	描述
region	String	源端桶所处的区域。
list_file	JSONObject	数据格式为JSON格式，参见表4。
object_key	JSONArray	源端桶选择的对象名称。每个元素均为对象的绝对路径。
bucket	String	源端桶的名称。
cloud_type	String	源端云服务商。

表4 list_file数据结构
参数	参数类型	描述
obs_bucket	String	存放对象列表文件的OBS桶名。
list_file_key	String	对象列表文件对象名。

表5 dst_node数据结构说明
参数	类型	描述
region	String	目的端桶所处的区域。
object_key	String	目的端桶选择的对象名称。
bucket	String	目的端桶的名称。
cloud_type	String	目的端云服务商。

表6 smnInfo数据结构说明
参数	类型	描述
notifyResult	Boolean	记录迁移任务执行完毕后SMN消息是否发送成功。
notifyErrorMessage	String	记录SMN消息发送失败原因的错误码（迁移任务成功时为空）。
topicName	String	SMN Topic的名称（SMN消息发送成功时为空）。

表7 source_cdn数据结构
参数	类型	描述
protocol	String	协议类型：https或http。
domain	String	从指定域名获取对象。
authentication_type	String	鉴权方式。无需鉴权：NONE Qiniu：QINIU_PRIVATE_AUTHENTICATION

表8 error_reason数据结构说明
参数	类型	描述
error_code	String	迁移失败的错误码。
error_msg	String	迁移失败的原因。

表9 failed_object_record结构说明
参数	参数类型	描述
result	Boolean	是否支持失败对象重传。
list_file_key	String	失败对象列表文件路径。
errorCode	String	不支持失败重传的错误码。

**表10** bandwidth_policy数据结构
参数	参数类型	描述
start	String	流量控制开始时间（包含），格式为“hh:mm”。例如“10:03”表示10时03分。
end	String	流量控制结束时间（包含），格式和start参数相同。
max_bandwidth	int	时段内允许的最大流量带宽，单位Byte/s。