ListObjects
    • PDF

    ListObjects

    • PDF

    Article Summary

    概要

    バケットにGETリクエストを送ると、オブジェクトリストを返却します。この場合、一度に返却されるオブジェクトの個数は1,000個に制限されるし、任意の順番に返却されます。
    ストレージクラスオペレーションがNCPのオブジェクトストレージに実装されてない場合はレスポンスコードで返却されたStorageClassの値は基本値です。
    オペレーションに使われるヘッダ、ペイロードはありません。

    リクエスト

    構文

    GET https://{endpoint}/{bucket-name} # path style
    GET https://{bucket-name}.{endpoint} # virtual host style
    

    パラメータ

    パラメータ名必須タイプ制約事項説明
    prefixNostringprefixではじまるオブジェクト名のみにレスポンスするように制限します。
    delimiterNostringprefixとdelimiterの間にあるオブジェクトを一つに統合します。
    encoding-typeNostringXMLでサポートしないユニコード文字がオブジェクト名に使われた場合、パラメータをurlに設定するとエンコーディング問題を解決できます。
    max-keysNostringMin: 0
    Max: 1000
    レスポンスに表示するオブジェクト個数を制限します。基本値であり、最大値は1,000です。
    markerNostringUTF-8バイナリ順番でリストがはじまるべきの位置からオブジェクトを指定します。

    例示

    リクエスト例示

    次は名称が'apiary'であるバケットに属するオブジェクト照会をリクエストする例です。

    GET /apiary HTTP/1.1
    Content-Type: text/plain
    Host: kr.object.ncloudstorage.com
    X-Amz-Date: 20160822T225156Z
    Authorization: {authorization-string}
    

    レスポンス例示

    HTTP/1.1 200 OK
    Date: Wed, 24 Aug 2016 17:36:24 GMT
    Accept-Ranges: bytes
    x-amz-request-id: 9f39ff2e-55d1-461b-a6f1-2d0b75138861
    Content-Type: application/xml
    Content-Length: 909
    
    <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Name>apiary</Name>
      <Prefix/>
      <Marker/>
      <MaxKeys>1000</MaxKeys>
      <Delimiter/>
      <IsTruncated>false</IsTruncated>
      <Contents>
        <Key>drone-bee</Key>
        <LastModified>2016-08-25T17:38:38.549Z</LastModified>
        <ETag>"0cbc6611f5540bd0809a388dc95a615b"</ETag>
        <Size>4</Size>
        <Owner>
          <ID>{account-id}</ID>
          <DisplayName>{account-id}</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
      </Contents>
      <Contents>
        <Key>soldier-bee</Key>
        <LastModified>2016-08-25T17:49:06.006Z</LastModified>
        <ETag>"37d4c94839ee181a2224d6242176c4b5"</ETag>
        <Size>11</Size>
        <Owner>
          <ID>{account-id}</ID>
          <DisplayName>{account-id}</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
      </Contents>
      <Contents>
        <Key>worker-bee</Key>
        <LastModified>2016-08-25T17:46:53.288Z</LastModified>
        <ETag>"d34d8aada2996fc42e6948b926513907"</ETag>
        <Size>467</Size>
        <Owner>
          <ID>{account-id}</ID>
          <DisplayName>{account-id}</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
      </Contents>
    </ListBucketResult>
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.