復制對象
更新時間 2024-04-28 17:56:34
最近更新時間: 2024-04-28 17:56:34
分享文章
接口介紹
此接口用于將對象從一個存儲桶復制到另一個存儲桶中。
接口約束
無
請求URI
PUT /v1/{bucket}/{destObjectName}
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
| objectName | 是 | String | 對象名稱 | test |
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| x-amz-copy-source | 是 | String | 源的桶名稱和對象名稱 | {bucket}/{obj} |
此接口涉及的其他公共請求頭，例如Host、Date等的更多信息，請參見公共HTTP頭。
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| CopyObjectResult | 是 | Array of Objects | 返回元素的容器 | CopyObjectResult |
表 CopyObjectResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| LastModified | 是 | String | 源對象的上次修改日期 | 2022-09-16T07:47:34.032Z | |
| Etag | 是 | String | 新對象的Etag | d41d8cd98f00******************* |
請求示例
PUT /v1/testbucket/test HTTP/1.1
請求頭header
Host: gdoss.xstore.daliqc.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
Authorization: authorization string
x-amz-copy-source: "abc222/test1013.txt"
請求體body
無
響應示例
<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<LastModified>2022-09-16T07:47:34.032Z</LastModified>
<ETag>d41d8cd98f00b204e9800998ecf8427e</ETag>
</CopyObjectResult>
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 操作成功。 |
| 400 | 拷貝的對象太大。 |
| 400 | 對象的名字不合法 |
| 403 | 用戶沒有權限執行操作。 |
| 404 | 請求參數中CopySource對應的對象不存在。 |
