本文へジャンプします。

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

Get Bucket Object versions

処理概要

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

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

指定するパラメーター

パラメーター 説明 必須 サンプル値
versions versionsリクエスト
値 : なし
 
delimiter 区切り文字列
Type : String
  %2F
marker 開始文字列
指定した文字列からアルファベット順でリストを表示します。
Type : String
   
max-keys 最大一覧表示数
Type : Int
Default : 1000
   
prefix 前方一致文字列
Type : String
   
version-id-marker 開始オブジェクトバージョンID
Type : String
   

指定するヘッダー

必要なヘッダーはありません。

指定するボディ

必要なボディはありません。

応答ヘッダー

必要なヘッダーはありません。

応答フィールド

フィールド 説明 サンプル値
ListversionsResult ListversionsResultレスポンス
Type : Container
Ancestor : なし
Children : すべてのelements
 
Name バケット名
Type : xsd:string
Ancestor : ListVersionsResult
Children : なし
 
Prefix 指定した前方一致文字列
Type : xsd:string
Ancestor : ListVersionsResult
Children : なし
 
KeyMarker 指定した開始文字列
Type : xsd:string
Ancestor : ListVersionsResult.version
Children : なし
 
VersionIdMarker 指定した開始オブジェクトバージョンID
type : xsd:string
Ancestor : ListVersionsResult
Children : なし
 
MaxKeys 指定した最大一覧表示数
type : xsd:string
Default : 1000
Ancestor : ListVersionsResult
Children : なし
 
IsTruncated 全結果取得フラグ
リクエスト件数がすべて返却できたかどうか
Type : xsd:boolean
Ancestor : ListVersionsResult
Children : なし
true(取得できていない)
false(取得できている)
NextKeyMarker 次リクエスト検索キー
(max-key件数で返しきれなかった場合に、次リクエストのmarkerに指定すべきオブジェクト検索キー)
Type : xsd:string
Ancestor : ListVersionsResult
Children : なし
 
NextVersionIdMarker 次リクエスト検索バージョンID
(max-key件数で返しきれなかった場合に、次リクエストのversion-id-markerに指定すべきオブジェクトのバージョンID)
Type : int
Ancestor : ListVersionsResult
Children : なし
 
DeleteMarker DeleteMarkerレスポンス
(オブジェクトがすでに削除されている場合)
Type : Container
Ancestor : ListVersionsResult
Children : key,VersionId,IsLatest,LastModified,Owner
 
Version Versionレスポンス
Type : Container
Ancestor : ListVersionsResult
Children :Key,VersionId,IsLatest,LastModified,ETag,Size,StorageClass,Owner
 
Key オブジェクト名
Type : xsd:string
Ancestor : ListVersionsResult.version | ListVersionsResult.DeleteMarker
Children : なし
 
VersionId オブジェクトバージョンid
Type : xsd:string
Ancestor : ListVersionsResult.version | ListVersionsResult.DeleteMarker
Children : なし
 
IsLatest オブジェクト最新情報
Type : xsd:boolean
Ancestor : ListVersionsResult.Version
Children : なし
true(最新オブジェクト)
false(最新ではない)
LastModified 最終更新時間
Type : xsd:date
Ancestor : ListVersionsResult.version | ListVersionsResult.DeleteMarker
Children : なし
 
StorageClass ストレージ分類
(STANDARD固定)
Ancestor : ListVersionsResult.version
Children : なし
STANDARD
Size オブジェクトサイズ
Type : xsd:int
Ancestor : ListVersionsResult.version
Children : なし
 
ETag オブジェクトETag
Type : xsd:string
Ancestor : ListVersionsResult.Version
Children : なし
 
Owner Ownerレスポンス
Type : xsd:string
Ancestor : ListVersionsResult.version | ListVersionsResult.DeleteMarker
Children : DisplayName,ID
 
ID オーナーID
Type : xsd:string
Ancestor : ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner
Children : なし
NCSS|ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : ListVersionsResult.version.Owner | ListVersionsResult.DeleteMarker.Owner
Children : なし
ABC12345

リクエストサンプル

GET /?versions HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Wed, 25 Jul 2012 00:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=

応答サンプル

<ListVersionsResult xmlns="http://ncss.nifty.com/doc/2011-09-29/">
 <Name>my-first-bucket</Name>
 <Prefix></Prefix>
 <KeyMarker></KeyMarker>
 <VersionIdMarker></VersionIdMarker>
 <MaxKeys>1000</MaxKeys>
 <IsTruncated>false</IsTruncated>
 <Version>
  <Key>backup.log</Key>
  <VersionId>998668733986120</VersionId>
  <IsLatest>true</IsLatest>
  <LastModified>2012-02-23T06:01:50.000Z</LastModified>
  <ETag>&quot;53f2f2d09a820e40af127ae8b745d7f7&quot;</ETag>
  <Size>250019</Size>
  <Owner>
   <ID>NCSS|ABC12345</ID>
   <DisplayName>ABC12345</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
 </Version>
 <Version>
  <Key>backup.log</Key>
  <VersionId>998668733986121</VersionId>
  <IsLatest>false</IsLatest>
  <LastModified>2012-02-23T06:01:40.000Z</LastModified>
  <ETag>&quot;701f59131868a0523e6d5ae25dd2a967&quot;</ETag>
  <Size>242177</Size>
  <Owner>
   <ID>NCSS|ABC12345</ID>
   <DisplayName>ABC12345</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
 </Version>
 <Version>
  <Key>backup.log</Key>
  <VersionId>998668733986122</VersionId>
  <IsLatest>false</IsLatest>
  <LastModified>2012-02-23T06:01:30.000Z</LastModified>
  <ETag>&quot;64ea72818b8ffa26f8aa30f5b8fed7ba&quot;</ETag>
  <Size>44889</Size>
  <Owner>
   <ID>NCSS|ABC12345</ID>
   <DisplayName>ABC12345</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
 </Version>
</ListVersionsResult>

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