GetBucket

指定バケット内のオブジェクトを一覧表示する場合、IAM権限 wos:GetBucket が必要です。

リクエスト構文

GET /?prefix=Prefix&marker=Marker&max-keys=Max-Keys&delimiter=Delimiter&start-time=Start-Time&end-time=End-Time
Host: BucketName.Endpoint
Date: Date
Authorization: <Authorization>

リクエストパラメータ

注意: パラメータ名は大文字・小文字を区別します。たとえば PREFIX=abc では認識されません（認証計算の際には含まれます）。

リクエストヘッダー

common request headers のみご利用ください。

リクエストボディ

ありません

レスポンス構文

HTTP/1.1 StatusCode
x-wos-request-id: RequestId
Date: Date
Content-Type: type
Content-Length: length
Server: WS-web-server

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="https://www.wangsu.com/document">
  <IsTruncated>boolean</IsTruncated>
  <Marker>string</Marker>
  <NextMarker>string</NextMarker>
  <Contents>
    <ETag>string</ETag>
    <Key>string</Key>
    <LastModified>timestamp</LastModified>
    <ExpirationDate>timestamp</ExpirationDate>
    <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
    </Owner>
    <Size>integer</Size>
    <StorageClass>string</StorageClass>
  </Contents>
  ...
  <Name>string</Name>
  <Prefix>string</Prefix>
  <Delimiter>string</Delimiter>
  <MaxKeys>integer</MaxKeys>
  <CommonPrefixes>
    <Prefix>string</Prefix>
  </CommonPrefixes>
  ...
  <EncodingType>string</EncodingType>
</ListBucketResult>

レスポンスヘッダー

common response headers のみご利用ください。

レスポンスボディ

レスポンスはXML形式で返され、指定バケット内のオブジェクト一覧が表示されます。各要素の意味は以下の通りです：

エラーシナリオ