对象存储 Move Object

功能描述
在同一媒体库内将对象（文件或目录）移动到新位置。
注意：
当 COS Agent Bucket 收到移动请求或 COS Agent Bucket 正在移动对象时可能会返回错误。如果在移动操作开始之前发生错误，则会收到标准的错误返回。如果在移动操作执行期间发生错误，则依然会返回 HTTP 200 OK，并将错误作为响应体返回。这意味着 HTTP 200 OK 响应既可以包含成功也可以包含错误，在使用此接口时应当进一步根据响应体的内容来判断移动请求的成功与失败并正确地处理结果。
请求
请求语法
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
x-cos-move-source: <BucketName-APPID>.cos.<Region>.myqcloud.com/<SourceObjectKey>
Authorization: Auth String
﻿
说明：
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 smhxxxxxxxxxxxxx-1250000000；<Region> 为可用地域，可参见 产品概述 文档。
SourceObjectKey：移动对象路径。
Authorization: Auth String（详情请参见 请求签名 文档）。
请求参数
名称
描述
类型
是否必选
conflict_resolution_strategy
目标已存在时的冲突解决策略。有效值：ask、rename、overwrite
ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码。
rename: 冲突时自动重命名最后一级目录。
overwrite: 冲突目标为目录时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码，否则覆盖已有文件
string
否
请求体
此接口无请求体。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
请求成功，返回 application/xml 数据。
<MoveObjectResult>
  <ETag>&#34;etag-value&#34;</ETag>
  <LastModified>2025-01-15T10:30:00Z</LastModified>
  <CRC64>xxx</CRC64>  
</MoveObjectResult>
具体的节点描述如下：
节点名称（关键字）
父节点
描述
类型
MoveObjectResult
无
保存 Move Object Recursive 结果的所有信息
Container
Container 节点 MoveObjectResult 的内容：
节点名称（关键字）
父节点
描述
类型
ETag
MoveObjectResult
目标对象的 ETag 值（带双引号）。
string
LastModified
MoveObjectResult
目标对象的最后修改时间，RFC 3339 格式。
date
CRC64
MoveObjectResult
目标对象的 CRC64 值。
integer
实际案例
请求
PUT /myspace/bbb HTTP/1.1
Host: smhxxx-1250000000.cos.ap-chengdu.myqcloud.com
x-cos-move-source: smhxxx-1250000000.cos.ap-chengdu.myqcloud.com/myspace/aaa
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1566302375;1566309575&q-key-time=1566302375;1566309575&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=****************************************
﻿
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Transfer-Encoding: chunked
Connection: keep-alive
Date: Tue, 20 Aug 2019 11:59:35 GMT
x-cos-request-id: NWQ1YmUwYTdfM2FiMDJhMDlfYzczN18zMGM1****
﻿
<MoveObjectResult>
  <ETag>&#34;d-1780579801973809791&#34;</ETag>
  <LastModified>2026-06-04T13:30:01Z</LastModified>
  <CRC64>5404623458528365127</CRC64>  
</MoveObjectResult>

名称	描述	类型	是否必选
conflict_resolution_strategy	目标已存在时的冲突解决策略。有效值：ask、rename、overwrite ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码。 rename: 冲突时自动重命名最后一级目录。 overwrite: 冲突目标为目录时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码，否则覆盖已有文件	string	否

节点名称（关键字）	父节点	描述	类型
MoveObjectResult	无	保存 Move Object Recursive 结果的所有信息	Container

Move Object

本页目录：

功能描述

请求

请求语法

请求参数

请求体

响应

响应头

响应体

实际案例

请求

响应