このページは Cloud Translation API によって翻訳されました。

Storage S3 REST API

ListObjects

このオペレーションは、バケット内のオブジェクトの一部またはすべてを最大 1,000 個返します。

リクエストの例:

GET /{fully_qualified_bucket_name} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
    x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
    x-amz-request-id: B34E94CACB2CEF6D
    Date: Mon, 17 Oct 2022 22:47:09 GMT
    <ListBucketResult>
        <Name>{fully_qualified_bucket_name}</Name>
        <Prefix></Prefix>
        <Marker></Marker>
        <Contents>
                <Key>example-object.jpg</Key>
                <LastModified>2022-10-17T01:56:20.000Z</LastModified>
                <ETag>"bf1d937a4d46a19f3basdfeg5cc8b902"</ETag>
                <Size>32347</Size>
                <Owner>
                <ID>canonical-user-id</ID>
                <DisplayName>example-display-name</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
        </Contents>
  </ListBucketResult>

ListObjectsV2

このオペレーションは、バケット内のオブジェクトの一部またはすべてを最大 1,000 個返します。

リクエストの例:

GET /{fully_qualified_bucket_name}?list-type=2 HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
    x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
    x-amz-request-id: B34E94CACB2CEF6D
    Date: Mon, 17 Oct 2022 22:47:09 GMT
    <ListBucketResult>
        <Name>{fully_qualified_bucket_name}</Name>
        <Prefix></Prefix>
        <Marker></Marker>
        <Contents>
                <Key>example-object.jpg</Key>
                <LastModified>2022-10-17T01:56:20.000Z</LastModified>
                <ETag>"bf1d937a4d46a19f3basdfeg5cc8b902"</ETag>
                <Size>32347</Size>
                <Owner>
                <ID>canonical-user-id</ID>
                <DisplayName>example-display-name</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
        </Contents>
  </ListBucketResult>

GetObject（versionId は省略可）

このオペレーションは、指定されたオプションのバージョン ID を使用して、バケットからオブジェクトを取得します。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?versionId={object_version_id} HTTP/1.1
Host: host
Content-MD5: request header
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
ETag: "33a64df551425fcc55e4d42a148795d9f25f89d4"
Content-Length: 13432
[13432 bytes of object data]

GetObjectAcl（versionId は省略可）

このオペレーションは、オブジェクトオーナーの ID、DisplayName、Permission を含む肯定的なレスポンスを返します。これは、オーナーがオブジェクトにフルアクセスできることを示します。このオペレーションでは、アカウントのアクセス認証情報を指定する必要があります。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?acl&versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
Content-Length: 157
<AccessControlPolicy>
    <Owner>
        <ID>canonical-user-id</ID>
        <DisplayName>example-display-name</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee>
        <ID>canonical-user-id</ID>
                <DisplayName>example-display-name</DisplayName>
                <Type>CanonicalUser</Type>
            </Grantee>
            <Permission>FULL_CONTROL</Permission>
        </Grant>
</AccessControlList>
</AccessControlPolicy>

GetObjectRetention（versionId は省略可）

このオペレーションは、指定されたオブジェクトの保持モードと、Object Lock 保持の有効期限を取得します。バケットにオブジェクトロック構成が必要です。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?retention&versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
X-amz-expected-bucket-owner: ExpectedBucketOwner (optional)

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
<Retention>
    <Mode>COMPLIANCE</Mode>
    <Timestamp>2022-10-17T01:56:20.000Z</Timestamp>
</Retention>

GetObjectLegalHold（versionId は省略可）

このオペレーションは、オブジェクトの最新の法的保持ステータスを取得します。バケットにオブジェクトロック構成が必要です。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?legal-hold&versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
X-amz-expected-bucket-owner: ExpectedBucketOwner (optional)

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
<LegalHold>
    <Status>ON</Status>
</LegalHold>

GetObjectTagging（versionId は省略可）

このオペレーションは、タグ付けサブリソースを使用して、オブジェクトのすべてのタグを返します。versionId パラメータが指定されていない場合、このオペレーションは、バージョン管理されたバケット内のオブジェクトの最新バージョンからすべてのタグを返します。オブジェクトの現在のバージョンが削除マーカーの場合、x-amz-deletemarker レスポンスヘッダーが true に設定された MethodNotAllowed ステータスが返されます。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?tagging&versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
X-amz-expected-bucket-owner: ExpectedBucketOwner (optional)

レスポンスの例（成功）:

HTTP/1.1 200 OK
Date: Mon, 17 Oct 2022 22:47:09 GMT
<Tagging>
  <TagSet>
        <Tag>
        <Key>tag1</Key>
        <Value>val1</Value>
      </Tag>
      <Tag>
        <Key>tag2</Key>
        <Value>val2</Value>
      </Tag>
  </TagSet>
</Tagging>

PutObject

このオペレーションは、オブジェクトをバケットに追加します。バケットにオブジェクトを追加するには、バケットに対する適切な書き込み権限が必要です。

暗号化バージョン 2

EV2（Encryption Version 2）バケットの場合、カスタム鍵が指定されていないと、リクエストでは暗号化にデフォルトの AEAD 鍵が使用されます。

暗号化にカスタム AEAD 鍵を使用するには、次の 2 つのヘッダーを設定する必要があります。

x-amz-server-side-encryption: SSE-KMS - このリクエストがカスタム AEAD 鍵を使用しようとしていることを示します。
x-amz-server-side-encryption-aws-kms-key-id: {custom_key_namespace}/{custom_key_name} - 使用する鍵を指定します。キーの Namespace は、バケットと同じプロジェクトに存在する必要があります。

リクエストの例:

PUT /{fully_qualified_bucket_name}/{object_name} HTTP/1.1
Host: host
Content-MD5: request header
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-Length: 5233
Content-type: text/plain
[5233 bytes of object data]

レスポンスの例（成功）:

HTTP/1.1 100 Continue

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
Date: Mon, 17 Oct 2022 22:47:09 GMT
ETag: "33a64df551425fcc55e4d42a148795d9f25f89d4"

PutObjectTagging

このオペレーションでは、タグ付けサブリソースを使用して、既存のオブジェクトに一連のタグを追加します。

リクエストの例:

PUT /{fully_qualified_bucket_name}/{object_name}?tagging HTTP/1.1
Host: host
Content-MD5: +b9TrAB9F8ne7rJpPkqavQ==
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-Length: {length}
Content-type: text/plain
<Tagging>
    <TagSet>
        <Tag>
            <key>my-tag-key</key>
            <value>my-tag-value</value>
        </Tag>
    </TagSet>
</Tagging>

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
Date: Mon, 17 Oct 2022 22:47:09 GMT

DeleteObject（versionId は省略可）

このオペレーションでは、1 つのリクエストで 1 つのバケットから複数のオブジェクトを削除できます。リクエストには、削除するキーのリストを最大 1,000 個含めることができます。

リクエストの例:

DELETE /{fully_qualified_bucket_name}/{object_name}?versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Object>
      <Key>object_one.jpg</Key>
      <VersionId>1234568892</VersionId>
   </Object>
   <Object>
      <Key>object_two.jpg</Key>
   </Object>
</Delete>

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: 5h4FxSNCUS7wP5z92eGCWDshNpMnRuXvETa4HH3LvvH6VAIr0jU7tH9kM7X+njXx
x-amz-request-id: A437B3B641629AEE
Date: Fri, 02 Oct 2023 01:53:42 GMT
Content-Type: application/xml
Content-Length: 251
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Deleted>
        <Key>object_one.jpg</Key>
    </Deleted>
    <Error>
        <Key>object_two.jpg</Key>
        <Code>AccessDenied</Code>
        <Message>Access Denied</Message>
    </Error>
</DeleteResult>

DeleteObjects（versionId は省略可）

バケットからオブジェクトを削除します。動作はバケットのバージョニングの状態によって異なります。バケットのバージョニングが有効になっていない場合、オペレーションはオブジェクトを完全に削除します。- バケットのバージョニングが有効になっている場合、オペレーションは削除マーカーを挿入します。このマーカーがオブジェクトの現行バージョンになります。バージョニングされたバケット内のオブジェクトを完全に削除するには、リクエストにオブジェクトの versionId を含める必要があります。

リクエストの例:

DELETE /{fully_qualified_bucket_name}/{object_name}?versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 204 NoContent
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
Date: Mon, 17 Oct 2022 22:47:09 GMT

DeleteObjectTagging（versionId は省略可）

このオペレーションでは、タグ付けサブリソースを使用して、オブジェクトからすべてのタグを削除します。

リクエストの例:

DELETE /{fully_qualified_bucket_name}/{object_name}?tagging&versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 204 NoContent
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
Date: Mon, 17 Oct 2022 22:47:09 GMT

HeadObject（versionId は省略可）

HEAD オペレーションは、オブジェクト自体を返さずにオブジェクトからメタデータを取得します。このオペレーションは、オブジェクトのメタデータのみに関心がある場合に便利です。

リクエストの例:

HEAD /{fully_qualified_bucket_name}/{object_name}?versionId={VersionId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 200
x-amz-id-2: ef8yU9AS1ed4OpIszj7UDNEHGran
x-amz-request-id: 318BC8BC143432E5
x-amz-version-id: 3HL4kqtJlcpXroDTDmjVBH40Nrjfkd
Date: Wed, 28 Oct 2023 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 434234
Content-Type: text/plain
Connection: close

CreateMultipartUpload

このアクションは、マルチパートアップロードを開始し、アップロード ID を返します。

マルチパートアップロードでは、1 つのオブジェクトをパーツのセットとして追加できます。各パートは、オブジェクトのデータの連続した部分です。これらのオブジェクトパーツは、個別に任意の順序でアップロードします。

返されたアップロード ID は、特定のマルチパートアップロードのすべてのパートを関連付けるために使用されます。このアップロード ID は、後続のアップロードパートリクエストで指定します。このアップロード ID は、マルチパートアップロードリクエストを完了または中止する最終リクエストでも使用します。

暗号化バージョン 2

EV2（暗号化バージョン 2）バケットに対して返されるアップロード ID は、1 回だけ生成されます。このオペレーションから返されたアップロード ID が失われた場合、ListMultipartUploads から復元することはできません。ただし、ListMultipartUploads から返されたアップロード ID は、AbortMultipartUpload または ListParts に使用できます。UploadPart または CompleteMultipartUpload に使用できるのは、CreateMultipartUpload から返された ID のみです。

リクエストの例:

POST /{fully_qualified_bucket_name}/{object_name}?uploads HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
    <InitiateMultipartUploadResult>
        <Bucket>{fully_qualified_bucket_name}</Bucket>
        <Key>{object_name}</Key>
        <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
  </InitiateMultipartUploadResult>

ListMultipartUploads（max-uploads は省略可）

このオペレーションは、バケットの進行中のマルチパートアップロードを一覧表示します。

暗号化バージョン 2

このオペレーションから返されるアップロード ID は、ListParts と AbortMultipartUpload でのみ機能します。

リクエストの例:

GET /{fully_qualified_bucket_name}?uploads&max-uploads={max-uploads} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
<ListMultipartUploadsResult>
<Bucket>{fully_qualified_bucket_name}</Bucket>
<KeyMarker></KeyMarker>
<UploadIdMarker></UploadIdMarker>
<NextKeyMarker>my-movie.m2ts</NextKeyMarker>
    <NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
    <MaxUploads>3</MaxUploads>
    <IsTruncated>true</IsTruncated>
    <Upload>
            <Key>{object_name}</Key>
            <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
            <Initiator>
            <ID>{canonical-user-id}</ID>
            <DisplayName>InitiatorDisplayName</DisplayName>
            </Initiator>
            <Owner>
            <ID>{canonical-owner-user-id}</ID>
            <DisplayName>OwnerDisplayName</DisplayName>
            </Owner>
            <StorageClass>STANDARD</StorageClass>
            <Initiated>2022-10-17T01:56:20.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

ListParts（max-parts は省略可）

このオペレーションは、特定のマルチパートアップロード用にアップロードされたパーツを一覧表示し、デフォルトの最大 1,000 個のアップロードされたパーツを返します。CreateMultipartUpload リクエストで取得したアップロード ID を含める必要があります。

暗号化バージョン 2

このリクエストには、CreateMultipartUpload または ListMultipartUploads から返されたアップロード ID を使用できます。

リクエストの例:

GET /{fully_qualified_bucket_name}/{object_name}?uploadId={uploadId}&max-parts={max-parts} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
<ListPartsResult>
        <Bucket>{fully_qualified_bucket_name}</Bucket>
        <Key>{object_name}</Key>
        <UploadId>{uploadId}</UploadId>
        <Initiator>
            <ID>{canonical-user-id}</ID>
            <DisplayName>InitiatorDisplayName</DisplayName>
          </Initiator>
        <Owner>
                <ID>{canonical-owner-id}</ID>
                <DisplayName>OwnerDisplayName</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <PartNumberMarker></PartNumberMarker>
        <NextPartNumberMarker></NextPartNumberMarker>
        <MaxParts>{max-parts}</MaxParts>
        <IsTruncated>true</IsTruncated>
        <Part>
                <PartNumber>2</PartNumber>
                <LastModified>2022-10-17T01:56:20.000Z</LastModified>
                <ETag>"7778aef8t866abc1fa1e8466f296d394"</ETag>
                <Size>10485769</Size>
        </Part>
        <Part>
                <PartNumber>3</PartNumber>
                <LastModified>2022-10-17T01:56:20.000Z</LastModified>
                <ETag>"aaab18db4cc2f85cedef854fccci24x8"</ETag>
                <Size>10423760</Size>
        </Part>
</ListPartsResult>

UploadPart

このオペレーションは、オブジェクトのマルチパートアップロードでパートをアップロードします。

暗号化バージョン 2

EV2（暗号化バージョン 2）バケットの場合、CreateMultipartUpload から返された ID を使用する必要があります。ListMutlipartUploads から返された ID は、このリクエストでは機能しません。

リクエストの例:

PUT /{fully_qualified_bucket_name}/{object_name}?uploadId={uploadId}&partNumber={partNumber} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-Length: 345442
Content-MD5: +b9TrAB9F8ne7rJpPkqavQ==
[part data omitted, 345442 bytes of part data]

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
ETag: "33a64df551425fcc55e4d42a148795d9f25f89d4"

AbortMultipartUpload

このアクションは、マルチパートアップロードを中止し、追加のパートをアップロードするためのアップロード ID を無効にします。以前にアップロードされたパーツによって消費されたストレージが解放されます。

暗号化バージョン 2

EV2（暗号化バージョン 2）バケットの場合、このオペレーションには CreateMultipartUpload または ListMultipartUploads から返された ID を使用できます。

リクエストの例:

DELETE /{fully_qualified_bucket_name}/{object_name}?uploadId={uploadId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-type: text/plain

レスポンスの例（成功）:

HTTP/1.1 204 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
Date: Mon, 17 Oct 2022 22:47:09 GMT

CompleteMultipartUpload

このオペレーションは、以前にアップロードされたパーツを組み立てて、オブジェクトのマルチパートアップロードを完了します。

暗号化バージョン 2

EV2（暗号化バージョン 2）バケットの場合、CreateMultipartUpload から返された ID を使用する必要があります。ListMutlipartUploads から返された ID は、このリクエストでは使用できません。

暗号化にカスタム AEAD 鍵を使用するには、次の 2 つのヘッダーを設定する必要があります。

x-amz-server-side-encryption: SSE-KMS - このリクエストがカスタム AEAD 鍵を使用しようとしていることを示します。
x-amz-server-side-encryption-aws-kms-key-id: {custom_key_namespace}/{custom_key_name} - 使用する鍵を指定します。キーの Namespace は、バケットと同じプロジェクトに存在する必要があります。

リクエストの例:

POST /{fully_qualified_bucket_name}/{object_name}?uploadId={uploadId} HTTP/1.1
Host: host
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string
Content-Length: 391
Content-type: text/plain
<CompleteMultipartUpload>
<Part>
    <PartNumber>1</PartNumber>
    <ETag>"a54357aff0632cce46d942af68356b38"</ETag>
</Part>
<Part>
    <PartNumber>2</PartNumber>
    <ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
</Part>
<Part>
      <PartNumber>3</PartNumber>
      <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
</Part>
</CompleteMultipartUpload>

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6D
Date: Mon, 17 Oct 2022 22:47:09 GMT
<CompleteMultipartUploadResult>
<Location>http://{host}/{fully_qualified_bucket_name}/{object_name}</Location>
        <Bucket>{fully_qualified_bucket_name}</Bucket>
        <Key>{object_name}</Key>
        <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
</CompleteMultipartUploadResult>

CopyObject

このオペレーションは、オブジェクトストレージにすでに存在するソースオブジェクトからデータが pull される特別なタイプの PutObject です。

ソースバケットとオブジェクトキーは、/ で区切られた x-amz-copy-source ヘッダーの値として指定されます。たとえば、バケット my_bucket からオブジェクト images/my_image.jpg をコピーするには、設定する値は my_bucket/images/my_image.jpg です。

暗号化バージョン 2

EV2（暗号化バージョン 2）バケットの場合、このソースオブジェクトは暗号化バージョン 2 バケットのものである必要があります。そうでない場合、オペレーションは失敗します。

暗号化にカスタム AEAD 鍵を使用するには、次の 2 つのヘッダーを設定する必要があります。

x-amz-server-side-encryption: SSE-KMS - このリクエストがカスタム AEAD 鍵を使用しようとしていることを示します。
x-amz-server-side-encryption-aws-kms-key-id: {custom_key_namespace}/{custom_key_name} - 使用する鍵を指定します。キーの Namespace は、バケットと同じプロジェクトに存在する必要があります。

リクエストの例:

PUT /{fully_qualified_bucket_name}/{object_name} HTTP/1.1
Host: host
X-Amz-Copy-Source: my_bucket/images/my_image.jpg
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
x-amz-copy-source-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo
Date: Mon, 17 Oct 2022 22:47:09 GMT

<CopyObjectResult>
    <LastModified>2009-10-12T17:50:30.000Z</LastModified>
    <ETag>"9b2cf535f27731c974343645a3985328"</ETag>
</CopyObjectResult>

UploadPartCopy

このオペレーションでは、オブジェクトストレージにすでに存在するオブジェクトを、マルチパートアップロードの単一パートのデータとして使用します。

暗号化バージョン 2

このオペレーションは、EV2（暗号化バージョン 2）バケットではサポートされていません。

リクエストの例:

PUT /{fully_qualified_bucket_name}/{object_name}?uploadId={uploadId}&partNumber={partNumber} HTTP/1.1
Host: host
X-Amz-Copy-Source: my_bucket/images/my_image.jpg
X-Amz-Date: date
X-Amz-Content-SHA256: authorization string

レスポンスの例（成功）:

HTTP/1.1 200 OK
x-amz-id-2: iVmcB7OXXJRkRH1FiVq1151/T24gRfpwpuZrEG11Bb9ImOMAAe98oxSpXlknabA0LTvBYJpSIX
x-amz-request-id: B34E94CACB2CEF6C
x-amz-copy-source-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo
Date: Mon, 17 Oct 2022 22:47:09 GMT

<CopyPartResult>
   <ETag>string</ETag>
   <LastModified>timestamp</LastModified>
   <ChecksumCRC32>string</ChecksumCRC32>
   <ChecksumCRC32C>string</ChecksumCRC32C>
   <ChecksumSHA1>string</ChecksumSHA1>
   <ChecksumSHA256>string</ChecksumSHA256>
</CopyPartResult>

Storage S3 REST API コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ListObjects

ListObjectsV2

GetObject（versionId は省略可）

GetObjectAcl（versionId は省略可）

GetObjectRetention（versionId は省略可）

GetObjectLegalHold（versionId は省略可）

GetObjectTagging（versionId は省略可）

PutObject

暗号化バージョン 2

PutObjectTagging

DeleteObject（versionId は省略可）

DeleteObjects（versionId は省略可）

DeleteObjectTagging（versionId は省略可）

HeadObject（versionId は省略可）

CreateMultipartUpload

暗号化バージョン 2

ListMultipartUploads（max-uploads は省略可）

暗号化バージョン 2

ListParts（max-parts は省略可）

暗号化バージョン 2

UploadPart

暗号化バージョン 2

AbortMultipartUpload

暗号化バージョン 2

CompleteMultipartUpload

暗号化バージョン 2

CopyObject

暗号化バージョン 2

UploadPartCopy

暗号化バージョン 2

Storage S3 REST API