ニフクラAPI（オブジェクトストレージ：Get Bucket）

Get Bucket (List Object)

処理概要

バケット内に保存されたオブジェクト情報を取得します。
リクエストパラメーターにより、取得条件を指定することができます。
取得にはバケットの読み込み権限が必要となります。

１リクエストで取得できるオブジェクト数の最大は、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:  NIFTY 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>&quot;62cff0140e0931c345c25795689032ca&quot;</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>&quot;d41d8cd98f00b204e9800998ecf8457e&quot;</ETag>

				    <Owner>

				      <ID>NCSS|ABC12345</ID>

				      <DisplayName>ABC12345</DisplayName>

				    </Owner>

				  </Contents>

				</ListBucketResult>

※本ページ記載の金額は、すべて税抜表示です。
※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
※本ページの内容は、2021年7月27日時点の情報です。