Get Bucket Object versions
処理概要
バケット内に保存されたオブジェクトのバージョン情報を取得します。
リクエストパラメーターにより、取得条件を指定することができます。
取得にはバケットの読み込み権限が必要となります。
1リクエストで取得できるオブジェクト数の最大は、1000オブジェクトとなります。1000オブジェクト以上存在する場合は、各リクエストパラメーターを指定してください。
また、実際に取得できるオブジェクト数は、max-keysパラメータの指定・未指定に限らず最大数に満たない場合があります。
その際は、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 | 次リクエスト検索キー (全てのオブジェクトが返却できなかった場合、次リクエスト時のmarkerに指定すべきオブジェクト検索キー) delimiter指定必須 Type : xsd:string Ancestor : ListVersionsResult Children : なし |
|
NextVersionIdMarker | 次リクエスト検索バージョンID (全てのオブジェクトが返却できなかった場合、次リクエスト時の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.jp-east-2.storage.api.nifcloud.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=
応答サンプル
<ListVersionsResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<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>"53f2f2d09a820e40af127ae8b745d7f7"</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>"701f59131868a0523e6d5ae25dd2a967"</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>"64ea72818b8ffa26f8aa30f5b8fed7ba"</ETag>
<Size>44889</Size>
<Owner>
<ID>NCSS|ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
</ListVersionsResult>