オブジェクトを読み取る
AWS S3内のオブジェクトのメタデータを取得します。
読み取りオブジェクトがSSE-Cでアップロードされた場合は、読み取りオブジェクトカードに暗号化キーも指定する必要があり、指定しない場合は400不正リクエストエラーが返されます。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
Region（リージョン） |
AWS S3バケットのリージョン。 使用するAWS S3バケットのリージョンを選択します。 |
ドロップダウン |
TRUE |
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
オプション |
|||
|
Bucket（バケット） |
オブジェクトが含まれるバケットの名前。 |
テキスト |
TRUE |
|
Key（キー） |
読み取るオブジェクトのキー名。 |
テキスト |
TRUE |
|
Version ID（バージョンID） |
読み取るオブジェクトの特定バージョンの参照に使用されるバージョンID。バージョンIDがnullの場合は「null」という文字列値を入力します。 |
テキスト |
FALSE |
|
Request Payer（リクエスト支払者） |
リクエストが課金の対象であることを依頼者が知っていることを確認します。 |
ドロップダウン |
FALSE |
|
Expected Bucket Owner（想定バケット所有者） |
想定されるバケット所有者のアカウントID。 別のアカウントがソースバケットを所有する場合、リクエストはHTTP 403（アクセス拒否）エラーで失敗します。 |
テキスト |
FALSE |
|
Server Side Encryption Customer Algorithm（サーバー側暗号化顧客アルゴリズム） |
オブジェクトの復号時に使用するアルゴリズムを指定します。 |
テキスト |
FALSE |
|
Server Side Encryption Customer Key（サーバー側暗号化顧客キー） |
AWS S3がデータの暗号化に使用した顧客提供の暗号化キーを指定します。 この値は、復元時にオブジェクトの復号に使用され、データの格納時に使用されたものと一致する必要があります。 キーは、SSE顧客アルゴリズムに指定されたアルゴリズムでの使用に適したものである必要があります。 |
テキスト |
FALSE |
|
Server Side Encryption Customer Key MD5（サーバー側暗号化顧客キーMD5） |
RFC 1321に準拠した、暗号化キーの128ビットMD5ダイジェストを指定します。 |
テキスト |
FALSE |
|
If Match（一致した場合） |
オブジェクトのエンティティタグ（ETag）が指定のタグと一致する場合にオブジェクトを参照します。 |
テキスト |
FALSE |
|
If Modified Since（指定日時以降に変更されている場合） |
指定した日時以降に変更されている場合にオブジェクトを参照します。 例：Fri, 14 Jan 2022 23:34:36 GMT。 |
テキスト |
FALSE |
|
If Non Match（一致なしの場合） |
オブジェクトのエンティティタグ（ETag）が指定のETagと異なる場合にオブジェクトを参照します。 |
テキスト |
FALSE |
|
If Unmodified Since（指定日時以降に未変更の場合） |
指定した日時以降に変更されていない場合にオブジェクトを参照します。 例：Fri, 14 Jan 2022 23:34:36 GMT。 |
テキスト |
FALSE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
Response （レスポンス） |
||
|
Version ID（バージョンID） |
オブジェクトのバージョンID。 |
テキスト |
|
Last Modified（最終変更） |
オブジェクトが最後に変更された日付。 |
テキスト |
|
ETag |
URLにあるリソースの特定バージョンに対してWebサーバーが割り当てる不透明識別子。 |
テキスト |
|
Content Type（コンテンツタイプ） |
オブジェクトデータの形式を説明する標準MIMEタイプ。 |
テキスト |
|
Size（サイズ） |
オブジェクトのサイズ（バイト単位）。 |
数値 |
|
Archive Status（アーカイブステータス） |
先頭オブジェクトのアーカイブステータス。 |
テキスト |
|
Delete Marker（削除マーカー） |
読み取るオブジェクトが削除マーカーであるかどうかを指定する場合は［True］、それ以外の場合は［False］を選択します。 ［False］を選択した場合、このレスポンスヘッダーはレスポンスに表示されません。 |
True/False |
|
Expiration（有効期限） |
オブジェクトの有効期限が構成されている場合（PUTバケットライフサイクル）、レスポンスにはこの値が含まれます。 |
テキスト |
|
Parts Count（パーツ数） |
このオブジェクトに含まれるパーツの数。 |
数値 |
|
Object Lock Legal Hold（オブジェクトロック法的保留） |
このオブジェクトの法的保留が有効であるかどうかを指定します。 オブジェクトの指定バージョンに法的保留が一度も適用されていない場合、この値は返されません。 |
True/False |
|
Object Lock Mode（オブジェクトロックモード） |
このオブジェクトの有効オブジェクトロックがこのバケットに含まれるかどうかを指定します。 |
テキスト |
|
Object Lock Retain Until Date（オブジェクトロック保持期限） |
オブジェクトロックの保持期間が終了する日時。 |
テキスト |
|
Replication Status（複製ステータス） |
リクエストが複製ルールの複製元または複製先バケットに関連する場合、AWS S3はこの値を返します。 |
テキスト |
|
Request Charged（リクエスト課金済み） |
存在する場合、リクエストが問題なく依頼者に課金されたことを示します。 |
テキスト |
|
Restore（復元） |
オブジェクトがアーカイブオブジェクトである場合（ストレージクラスはGLACIER）、アーカイブが復元中である（RestoreObjectを参照）またはアーカイブコピーがすでに復元されていれば、レスポンスにこの値が含まれます。 アーカイブコピーがすでに復元されている場合、値はAWS S3がオブジェクトコピーを削除するスケジュールを示します。オブジェクトが復元中である場合、ヘッダーはtrueを返します。 |
テキスト |
|
Server Side Encryption（サーバー側暗号化） |
オブジェクトの保存にAWS KMSキー、またはAWS S3管理の暗号化キーを使ったサーバー側暗号化が使用された場合、レスポンスにはその値と、AWS S3内でこのオブジェクトの保存時に使用されたサーバー側暗号化アルゴリズムの値が含まれます。 |
テキスト |
|
Server Side Encryption AWS KMS Key ID（サーバー側暗号化AWS KMSキーID） |
存在する場合、オブジェクトに使用されたAWSキー管理サービス（AWS KMS）対称顧客管理キーのIDを示します。 |
テキスト |
|
Server Side Encryption Bucket Key Enabled（サーバー側暗号化バケットキー有効） |
オブジェクトが、AWS KMSを使ったサーバー側暗号化（SSE-KMS）のAWS S3バケットキーを使用するかどうかを指定します。 |
テキスト |
|
Server Side Encryption Customer Algorithm（サーバー側暗号化顧客アルゴリズム） |
顧客提供の暗号化キーによるサーバー側暗号化が要求された場合、暗号化アルゴリズムの使用を確認するためにこのヘッダーがレスポンスに含まれます。 |
テキスト |
|
Server Side Encryption Customer Key MD5（サーバー側暗号化顧客キーMD5） |
顧客提供の暗号化キーによるサーバー側暗号化が求められた場合、顧客提供暗号化キーの往復メッセージ整合性検証を提供するためにこのヘッダーがレスポンスに含まれます。 |
テキスト |
|
Storage Class（ストレージクラス） |
オブジェクトのストレージクラス情報を提供します。AWS S3標準ストレージクラスオブジェクト以外のすべてのオブジェクトについて、AWS S3はこのヘッダーを返します。 |
テキスト |
|
Tagging Count（タグ数） |
オブジェクトのタグの数（存在する場合） |
数値 |
|
Website Redirect Location（Webサイトリダイレクトロケーション） |
バケットがWebサイトとして構成されている場合、このオブジェクトへのリクエストを同一バケット内の別のオブジェクトまたは外部URLにリダイレクトします。 |
テキスト |