Get Bucket (List Object)
処理概要
バケット内に保存されたオブジェクト情報を取得します。
リクエストパラメーターにより、取得条件を指定することができます。
取得にはバケットの読み込み権限が必要となります。
1リクエストで取得できるオブジェクト数の最大は、1000オブジェクトとなります。1000オブジェクト以上存在する場合は、各リクエストパラメーターを指定してください。
また、実際に取得できるオブジェクト数は、max-keysパラメータの指定・未指定に限らず最大数に満たない場合があります。
その際は、1000オブジェクト以上存在する場合と同様に、各リクエストパラメーターを指定してください。
指定するパラメーター
パラメーター | 説明 | 必須 | サンプル値 |
---|---|---|---|
delimiter | 区切り文字列 Type : String |
%2F(/ スラッシュ) | |
marker | 開始文字列 指定した文字列からアルファベット順でリストを表示します。 Type : String |
||
max-keys | 最大一覧表示数 Type : Int Default : 1000 |
1000以下のみ指定可能 | |
prefix | 前方一致文字列 Type : String |
指定するヘッダー
必要なヘッダーはありません。
指定するボディ
必要なボディはありません。
応答フィールド
フィールド | 説明 | サンプル値 |
---|---|---|
ListBucketResult | ListBucketResultレスポンス Type : Container Ancestor : なし Children : Name, Prefix,Marker,MaxKeys, IsTruncated,Contents |
|
Name | バケット名 Type : xsd:string Ancestor : ListBucketResult Children : なし |
|
Marker | 指定した開始文字列 Type : xsd:string Ancestor : ListBucketResult Children : なし |
|
MaxKeys | 指定した最大一覧表示数 Type : xsd:int Ancestor : ListBucketResult Children : なし |
|
Prefix | 指定した前方一致文字列 Type : xsd:string Ancestor : ListBucketResult Children : なし |
|
IsTruncated | 全結果取得フラグ 全てのオブジェクトが返却できたかどうか Type : xsd:boolean Ancestor : ListBucketResult Children : なし |
true(返却できていない) false(返却できている) |
NextMarker | 次リクエスト検索キー (全てのオブジェクトが返却できなかった場合、次リクエスト時のmarkerに指定すべきオブジェクト検索キー) delimiter の指定が必須 Type : xsdstring Ancestor : ListVersionsResult Children : なし |
|
Contents | Contentsレスポンス Type : Container Ancestor : ListBucketResult Children : ETag, Key, LastModified, Size, StorageClass, Owner |
|
ETag | オブジェクトETag Type : xsd:string Ancestor : ListBucketResult.Contents Children : なし |
|
Key | オブジェクト名 Type : xsd:string Ancestor : ListBucketResult.Contents Children : なし |
|
LastModified | 最終更新日時 Type : xsd:date Ancestor : ListBucketResult.Contents Children : なし |
|
Size | オブジェクトサイズ Type : xsd:int Ancestor : ListBucketResult.Contents Children : なし |
|
StorageClass | ストレージ分類 Type : xsd:string Ancestor : ListBucketResult.Contents Children : なし |
STANDARD |
Owner | Ownerレスポンス Type : Container Ancestor : ListBucketResult.Contents Children : なし |
|
ID | オーナーID Type : xsd:string Ancestor : ListBucketResult.Contents.Owner Children : なし |
ABC12345 |
DisplayName | オーナー名 Type : xsd:string Ancestor : ListBucketResult.Contents.Owner Children : なし |
ABC12345 |
リクエストサンプル
GET /?delimiter=%2F HTTP/1.1
Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:l+yOSNiZjp587YJsms9KoNHMcrU=
応答サンプル
<ListBucketResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Name>my-first-bucket</Name>
<Prefix/>
<Marker/>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>sample.txt</Key>
<LastModified>2016-06-29T00:00:00.000Z</LastModified>
<StorageClass>STANDARD</StorageClass>
<Size>138</Size>
<ETag>"62cff0140e0931c345c25795689032ca"</ETag>
<Owner>
<ID>NCSS|ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
</Contents>
<Contents>
<Key>test.txt</Key>
<LastModified>2016-06-29T00:00:00.000Z</LastModified>
<StorageClass>STANDARD</StorageClass>
<Size>298</Size>
<ETag>"d41d8cd98f00b204e9800998ecf8457e"</ETag>
<Owner>
<ID>NCSS|ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
</Contents>
</ListBucketResult>