本文へジャンプします。

ニフティクラウド APIリファレンス

Get Bucket (List Object)

処理概要

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

1リクエストで取得できるオブジェクト数は、1000オブジェクトとなります。1000オブジェクト以上存在する場合は、各リクエストパラメーターを指定してください。

指定するパラメーター

パラメーター 説明 必須 サンプル値
delimiter 区切り文字列
Type : String
  %2F
marker 開始文字列
指定した文字列からアルファベット順でリストを表示します。
Type : String
   
max-keys 最大一覧表示数
Type : Int
Default : 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(返却できている)
NextKeyMarker 次リクエスト検索キー
(max-key件数で返しきれなかった場合、次リクエスト時のmarkerに指定すべきオブジェクト検索キー)
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.ncss.nifty.com
Date: Thu, 29 Sep 2011 12:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:l+yOSNiZjp587YJsms9KoNHMcrU=

応答サンプル

<ListBucketResult xmlns="http://doc.ncss.nifty.com/2011-09-29">
  <Name>my-first-bucket</Name>
  <Prefix/>
  <Marker/>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>sample.txt</Key>
    <LastModified>2011-09-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>2011-09-29T00:30: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>

推奨画面サイズ 1024×768 以上