文档首页/ 对象存储迁移服务 OMS/ API参考/ API V2(推荐)/ 桶操作/ 检查url来源列表文件格式 - CheckUrlSourceListFileFormat
更新时间:2026-02-11 GMT+08:00
分享

检查url来源列表文件格式 - CheckUrlSourceListFileFormat

功能介绍

检查url来源列表文件格式是否有效

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    oms::checkUrlSourceListFileFormat

    Read

    -

    -

    -

    -

URI

POST /v2/{project_id}/objectstorage/buckets/url-source-list-file

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

最小长度:1

最大长度:1024

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM Token认证,需要确认Token中包含的Project ID与请求URI中修改资源的Project ID匹配。

最小长度:1

最大长度:16384

表3 请求Body参数

参数

是否必选

参数类型

描述

obs_bucket

String

存放对象列表文件的OBS桶名。

请确保与目的端桶处于同一区域,否则将导致任务创建失败。

最小长度:0

最大长度:1024

list_file_key

String

对象列表文件或URL列表文件对象名。

最小长度:1

最大长度:1024

ak

String

目的端桶的AK(最大长度100个字符)。

最小长度:0

最大长度:100

sk

String

目的端桶的SK(最大长度100个字符)。

最小长度:0

最大长度:100

region

String

桶所处的区域。

响应参数

状态码:200

校验通过无响应体。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

error_code

String

错误码。

请求示例

检查url来源列表文件格式

POST https://{endpoint}/v2/{project_id}/tasks/url-source-file

{
  "obs_bucket" : "obs_bucket_name",
  "list_file_key" : "object_list_file.txt",
  "ak" : "access_key_1234",
  "sk" : "secret_key_1234",
  "region" : "cn-north-1"
}

响应示例

状态码

状态码

描述

200

校验通过无响应体。

400

标准错误响应体。

错误码

请参见错误码

相关文档