GetContainer
    • PDF

    GetContainer

    • PDF

    Article Summary

    最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

    概要

    コンテナ(バケット)に属するオブジェクトリストとコンテナ(バケット)のメタデータを照会します。

    構文

    GET /v1/AUTH_{project_id}/{container}
    

    リクエスト

    NameInTypeDescription
    project_idpathstringプロジェクトIDを入力します。
    containerpathstringコンテナ名を入力します。
    limit (Optional)queryinteger呼び出し結果の最大個数を制限します。
    marker (Optional)querystring特定オブジェクト以降のリストを取得します。
    end_marker (Optional)querystring特定オブジェクト以前のリストを取得します。
    prefix (Optional)querystring該当文字列ではじまるオブジェクトリストを呼び出します。
    format (Optional)querystring呼び出し結果のフォーマットを指定します。(json, xml, plain)
    delimiter (Optional)querystring該当をセパレーターとして使い、オブジェクトリストを階層構造で表現できます。
    path (Optional)querystring該当パス内部のオブジェクトリストを表示します。pathオプションよりprefix/delimiterオプションをお勧めします。
    X-Auth-Token (Optional)headerstring発行したToken値を入力します。
    X-Newest (Optional)headerbooleantrueの場合、すべてのコピー本に対して問合せを行い、一番最近のコピー本情報でレスポンスします。該当ヘッダが省略された場合、一番レスポンスが早い情報でレスポンスします。
    Accept (Optional)headerstring呼び出し結果のフォーマットを指定します。(application/json, application/xml, text/xml)
    X-Container-Meta-Temp-URL-Key (Optional)headerstringtemporary URLのためのSecret Key値を入力します。
    X-Container-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URLのための2番目のSecret Key値を入力します。

    レスポンス

    NameInTypeDescription
    X-Container-Meta-nameheaderstring該当コンテナ(バケット)のメタデータ情報です。 ヘッダ名のname部分がメタデータのキーの役割をします。
    Content-Lengthheaderstringレスポンス結果の長さです。 (Bytes)
    X-Container-Object-Countheaderinteger該当コンテナ(バケット)のオブジェクト個数です。
    X-Container-Bytes-Usedheaderinteger該当コンテナ(バケット)が使う全体容量サイズです。 (Bytes)
    X-Container-Meta-Temp-URL-Key (Optional)headerstringtemporary URLのためのSecret Key 値です。
    X-Container-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URLのための2番目のSecret Key 値です。
    X-Container-Meta-Quota-Count (Optional)headerstring該当コンテナ(バケット)のオブジェクト数の制限値です。
    X-Container-Meta-Quota-Bytes (Optional)headerstring該当コンテナ(バケット)の容量制限値です。
    X-Storage-Policy (Optional)headerstring該当コンテナ(バケット)のstorage policy値です。
    X-Container-Read (Optional)headerstring該当コンテナ(バケット)のREAD ACLです。
    X-Container-Write (Optional)headerstring該当コンテナ(バケット)のWRITE ACLです。
    X-Container-Sync-Key (Optional)headerstringnot supported
    X-Container-Sync-To (Optional)headerstringnot supported
    X-Versions-Location (Optional)headerstringnot supported
    X-History-Location (Optional)headerstringnot supported
    X-Timestampheaderinteger該当コンテナ(バケット)が作成された時刻です。 (UNIX Time)
    X-Trans-Idheaderstring該当リクエストのトランザクションIDです。
    X-Openstack-Request-Idheaderstring該当リクエストのトランザクションIDです。 (X-Trans-Idと同じです。)
    Content-Typeheaderstringレスポンス結果のフォーマットです。
    Dateheaderstring該当リクエストのレスポンス時間です。 (UTC)
    hashbodystring該当オブジェクトのMD5チェックサム値です。
    last_modifiedbodystring該当オブジェクトが最後に変更された時刻です。 (UTC)
    content_typebodystring該当オブジェクトのタイプです。
    bytesbodyinteger該当オブジェクトのサイズです。 (bytes)
    namebodystring該当オブジェクトの名称です。

    例示

    リクエスト例示(JSON)

    curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json
    

    レスポンス例示

    HTTP/1.1 200 OK
    Content-Length: 352
    X-Container-Object-Count: 2
    X-Timestamp: 1536631895.01856
    Accept-Ranges: bytes
    X-Storage-Policy: standard01
    Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
    X-Container-Bytes-Used: 420024
    Content-Type: application/json; charset=utf-8
    X-Trans-Id: tx6bb706abe32b4ae5a49e8-005b978263
    X-Openstack-Request-Id: tx6bb706abe32b4ae5a49e8-005b978263
    Date: Tue, 11 Sep 2018 08:52:51 GMT
    
    [
       {
          "hash":"9bd5b4f25faf491080654a34d57c3636",
          "last_modified":"2018-09-11T02:12:29.991410",
          "bytes":210012,
          "name":"ncloud-test-object-0.txt",
          "content_type":"text/plain"
       },
       {
          "hash":"9bd5b4f25faf491080654a34d57c3636",
          "last_modified":"2018-09-11T02:12:29.992600",
          "bytes":210012,
          "name":"ncloud-test-object-1.txt",
          "content_type":"text/plain"
       }
    ]
    

    リクエスト例示(XML)

    curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=XML
    

    レスポンス例示

    HTTP/1.1 200 OK
    Content-Length: 520
    X-Container-Object-Count: 2
    X-Timestamp: 1536631895.01856
    Accept-Ranges: bytes
    X-Storage-Policy: standard01
    Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
    X-Container-Bytes-Used: 420024
    Content-Type: application/xml; charset=utf-8
    X-Trans-Id: txfff4e8574d7e43f38b8e8-005b9782ef
    X-Openstack-Request-Id: txfff4e8574d7e43f38b8e8-005b9782ef
    Date: Tue, 11 Sep 2018 08:55:11 GMT
    
    <?xml version="1.0" encoding="UTF-8"?>
    <container name="ncloud-container-0">
       
       
    </container>
    

    リクエストが成功するとOK (200), No Content (204)ステータスコードをレスポンスします。
    No Content (204)である場合はContent-Typeがplainであり、リクエストに該当される内容がない場合に発生します。
    コンテナ(バケット)が存在しない場合は、Not Found (404)ステータスコードをレスポンスします。


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

    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.