Get Bucket Object versions#
バケット内のオブジェクトのすべてのバージョンに関するメタデータを一覧表示します。
APIエンドポイント#
リージョン | APIエンドポイント |
---|---|
西日本リージョン3の場合 | https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com |
東日本リージョン3の場合 | https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
GET
/{bucket}?versions
HTTPステータスコード#
正常時:200
エラー時:400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
Bucket | path | string | 必須 | バケット名 |
delimiter | query | string | 任意 | キーをグループ化するために使用する文字 |
encoding-type | query | string | 任意 | レスポンスのエンコード方式を指定します。 |
key-marker | query | string | 任意 | リスト作成時の検索開始位置を指定するオブジェクトキーのマーカー文字列 指定した文字列より辞書的に大きいキーだけがリストに含まれます。 |
max-keys | query | string | 1000 任意 |
レスポンス本文に返されるキーの最大数を設定します。 |
prefix | query | string | 任意 | レスポンス本文に返されるキーを前方一致でフィルタする文字列 |
version-id-marker | query | string | 任意 | 一覧表示を開始するオブジェクトのバージョンを指定します。 |
x-amz-content-sha256 | header | string | 必須 | ペイロード全体の計算されたSHA256チェックサム |
x-amz-date | header | string | 必須 | リクエスト側で生成した現在日時 |
Authorization | header | string | 必須 | リクエスト認証に用いる文字列 |
レスポンスヘッダーの説明#
名前 | Type | Description |
---|---|---|
Date | string | トランザクションが実行された日時 |
Content-Type | string | コンテンツのMIMEタイプ |
Content-Length | string | レスポンスボディのバイト数 |
Connection | string | 持続接続の状態を表示します。 |
x-amz-request-id | string | このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。 |
x-amz-id-2 | string | このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。 |
x-ntap-sg-trace-id | string | このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。 |
X-Fcx-Endpoint-Request | string | APIエンドポイントとしてリクエストを受け付けたことを示す番号 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
ListVersionsResult | container | レスポンスののコンテナ |
Name | string | バケット名 |
VersionIdMarker | string | リクエスト時に指定したVersionIdMarker |
Prefix | string | リクエスト時に指定したPrefix |
KeyMarker | string | リクエスト時に指定したkey-marker |
MaxKeys | string | レスポンスの最大オブジェクト数 |
IsTruncated | boolean | レスポンス数がMaxKeysで指定された値を超えた場合はTRUE、そうでない場合FALSEが表示されます。 |
Version | container | オブジェクトのVersion情報のコンテナ |
Key | string | オブジェクトのキー |
VersionId | string | オブジェクトのバージョンID |
IsLatest | boolean | オブジェクトが現在のバージョンである場合はTRUE、そうでない場合はFASLEが表示されます。 |
LastModified | date | 最終更新日時 |
StorageClass | string | 常に"STANDARD"を返します。 |
Etag | string | オブジェクトのハッシュ |
Size | string | オブジェクトのサイズ |
Owner | container | オブジェクトの所有者情報 |
ID | string | オブジェクト所有者のID |
DisplayName | string | オブジェクトの所有者名 |
リクエスト例#
GET /general-bucket2?versions HTTP/1.1 User-Agent: curl/7.29.0 Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com Accept: */* x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 x-amz-date:20190606T012407Z Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190606/jp-east-3/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=be65f75a76bd431bb77805ba9f0cd2eee733fe723f6df7a2e2d4a2353a7f086d
レスポンス例#
レスポンスヘッダ
HTTP/1.1 200 OK Date: Thu, 06 Jun 2019 01:24:08 GMT Content-Type: application/xml Content-Length: 1077 Connection: keep-alive x-amz-request-id: 742037594 x-amz-id-2: 12174498 x-ntap-sg-trace-id: e756c8c6cdb0931a X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28849-1815777-1_200
レスポンスボディ
<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Name>general-bucket2</Name> <VersionIdMarker/> <Prefix/> <KeyMarker/> <MaxKeys>1000</MaxKeys> <IsTruncated>false</IsTruncated> <Version> <Key>object_data_1</Key> <VersionId>ODBBQzEyQzMtODZBQi0xMUU5LThBQTYtMUYwODAwQzVDRjUx</VersionId> <IsLatest>true</IsLatest> <LastModified>2019-06-04T09:31:16.780Z</LastModified> <StorageClass>STANDARD</StorageClass> <ETag>"0acd0dd3a9121a41ed274bbfb11365cc"</ETag> <Size>252864</Size> <Owner> <ID>42242073901014718119</ID> <DisplayName>fj-k5objt-tenant-99</DisplayName> </Owner> </Version> <Version> <Key>object_data_1</Key> <VersionId>N0VFNEU3M0UtODZBQi0xMUU5LTkzRjctRUIzODAwQkU3RDNF</VersionId> <IsLatest>false</IsLatest> <LastModified>2019-06-04T09:31:13.797Z</LastModified> <StorageClass>STANDARD</StorageClass> <ETag>"0acd0dd3a9121a41ed274bbfb11365cc"</ETag> <Size>252864</Size> <Owner> <ID>42242073901014718119</ID> <DisplayName>fj-k5objt-tenant-99</DisplayName> </Owner> </Version> </ListVersionsResult>