KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • Upload Part - Copy

Upload Part – Copy

処理概要

ストレージにアップロード済のオブジェクトからパートアップロードを行います。リクエストヘッダーに x-amz-copy-source を指定するか、 x-amz-copy-source-rangeを指定してください。

リクエスト

リクエストパラメタ

なし

リクエストヘッダー

このオペレーションはすべての操作に共通するリクエストヘッダのみを使用しています。詳細については、一般的なリクエストヘッダを参照してください。

リクエストヘッダは最大8KBに制限されます。

Name Type Description Required
x-amz-copy-source string スラッシュ（’/’）で区切られたコピー元Bucket名とコピー元object名。 Yes
x-amz-copy-source-range integer コピー元objectのバイトレンジ。レンジ値は bytes=first-last の形で、ゼロ・ベース・バイトオフセットとして使用しなければなりません。
例えば、 bytes=0-9 は コピー元の先頭から数えて10バイトをコピーしたいことになります。		 No

下記のヘッダーは、 x-amz-copy-source ヘッダーで指定したobjectに基づいています。

Name Type Description Required
x-amz-copy-source-if-match string コピー元objectのETagとヘッダー指定ETagが一致した場合にコピーを実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。 No
x-amz-copy-source-if-none-match string コピー元objectのETagとヘッダー指定ETagが不一致の場合にコピーに実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。 No
x-amz-copy-source-if-unmodified-since string コピー元objectの更新日時がヘッダー指定更新日時以降に更新されていない場合にコピーを実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。 No
x-amz-copy-source-if-modified-since string コピー元objectの更新日時がヘッダー指定更新日時以降に更新されている場合にコピーを実行します。そうでない場合、HTTP status code 412 precondition failed errorを返します。 No

リクエストボディ

なし

リクエストサンプル

PUT /sample-bucket2/sample-object.txt?partNumber=1&uploadId=12345678-9abc-def0-1234-56789abcdef0 HTTP/1.1
Host: 192.168.0.1
Connection: keep-alive
x-amz-copy-source: /sample-bucket/sample-object.txt
Date: Tue, 01 Sep 2015 10:00:00 +0000
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

Name Type Description
x-amz-copy-source-version-id – 使用不可

レスポンスボディ

Name Type Description
CopyPartResult container レスポンス自体のコンテナ
ETag string 新しいパーツのETag
LastModified – 利用不可。valueが常にblank。 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<CopyPartResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <ETag>string</ETag>
    <LastModified></LastModified>
</CopyPartResult>

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
ETag: "abcdef0123456789abcdef0123456789"

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CopyPartResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <LastModified></LastModified>
    <ETag>a6c31ce0a5b58b069c9fbbc360ef3e22</ETag>
</CopyPartResult>
2024/09/15 2024/09/15