复制对象

POST 
/v1/storages/copy-objects

注意：该接口仅管理员可调用。

批量复制指定对象至目标路径，可选参数以控制是否覆盖目标路径同名对象或在复制后删除原对象。

Request

application/json

Body

arrayrequired

批量复制对象请求参数，数组格式

• Array [
srcPath 原对象的绝对路径，包含文件名。例如 foo/bar.jpg、foo/bar/baz.jpg 等，不能包含除[0-9 , a-z , A-Z]、/、!、-、_、.、、*和中文以外的字符 (string)required
dstPath 目标对象的绝对路径，包含文件名。例如 foo/bar.jpg、foo/bar/baz.jpg 等，不能包含除[0-9 , a-z , A-Z]、/、!、-、_、.、、*和中文以外的字符；目标路径不可与原路径一致 (string)required
overwrite 当目标对象已经存在时，是否允许覆盖已有对象，默认 true (boolean)

Default value: true

removeOriginal 复制对象后，是否删除原对象，默认 false (boolean)
• ]

Responses

200

调用成功时返回

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

• Array [
oneOf
v1CopyObjectsResponseItemSuccess
cloudObjectId 复制后对象的云端文件 ID (string)
v1CopyObjectsResponseItemError
code 对该对象的请求出错时返回的错误码 (string)
message 对该对象的请求出错时返回的错误描述 (string)
• ]

Example (from schema)

[
  {
    "code": "OBJECT_NOT_EXIST",
    "message": "Storage object not exists."
  },
  {
    "cloudObjectId": "cloud://your-envId.bucket/file.jpg"
  }
]

default

通用报错信息，详见 https://docs.cloudbase.net/error-code/service

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

code 错误码 (string)
message 错误信息 (string)
requestId 请求 ID (string)

Example (from schema)

{
  "code": "string",
  "message": "string",
  "requestId": "string"
}

InvalidHost

请求地址异常

{
  "code": "INVALID_HOST",
  "message": "xxx",
  "requestId": "xxx"
}

Loading...