PutObject (Copy)
- 印刷する
- PDF
PutObject (Copy)
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC環境で利用できます。
指定したヘッダを利用してオブジェクトのコピーを作成します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。
参考
- コピーを変更しない限り、コピーのメタデータはソースと同じままです。ただし、コピーを作成したアカウントに適用された ACL設定は、privateに再設定されます。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| PUT | /{bucket-name}/{object-name} |
リクエスト構文
リクエスト構文は次の通りです。
PUT https://{endpoint}/{bucket-name}/{object-name} # path style
PUT https://{bucket-name}.{endpoint}/{object-name} # virtual host style
リクエストヘッダ
PutObject (Copy)ヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、Object Storage共通リクエストヘッダをご参照ください。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
| x-amz-metadata-directive | String | Optional | ソースメタデータの変更を設定
|
| x-amz-copy-source-if-match | String | Optional | 指定した ETag文字列がソースオブジェクトと一致する場合、コピーを作成 |
| x-amz-copy-source-if-none-match | String | Optional | 指定した ETag文字列がソースオブジェクトと異なる場合、コピーを作成 |
| x-amz-copy-source-if-unmodified-since | String | Optional | 指定した日付以降にソースオブジェクトを変更しなかった場合、コピーを作成
|
| x-amz-copy-source-if-modified-since | String | Optional | 指定した日付以降にソースオブジェクトを変更した場合、コピーを作成
|
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
bucket-name | String | Required | オブジェクトのコピーを作成するバケットの名前 |
object-name | String | Required | コピーするオブジェクトの名前 |
リクエスト例
リクエストのサンプルコードは次の通りです。
PUT /example-bucket/wild-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20161130T195251Z
x-amz-copy-source: /garden/bee
Host: kr.object.ncloudstorage.com
レスポンス
レスポンス形式を説明します。
レスポンスヘッダ
Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、Object Storageの共通レスポンスヘッダをご参照ください。
レスポンスステータスコード
Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Object Storageのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
HTTP/1.1 200 OK
Date: Wed, 30 Nov 2016 19:52:52 GMT
Accept-Ranges: bytes
x-amz-request-id: 72992a90-8f86-433f-b1a4-7b1b33714bed
ETag: "853aab195ce770b0dfb294a4e9467e62"
Content-Type: application/xml
Content-Length: 240
<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<LastModified>2016-11-30T19:52:53.125Z</LastModified>
<ETag>"853aab195ce770b0dfb294a4e9467e62"</ETag>
</CopyObjectResult>
この記事は役に立ちましたか?