GetContainerList
    • PDF

    GetContainerList

    • PDF

    Article Summary

    概要

    コンテナ(バケット)のリストを照会します。

    注意

    Subaccountの場合、Subaccount専用 External API Gatewayを通じて使用できます。
    詳細は、Subaccountをご参照ください。

    構文

    GET v1/AUTH_{project_id}
    

    リクエスト

    リクエストパラメータ

    NameInTypeDescription
    limit (Optional)queryinteger呼び出し結果の最大数制限
    marker (Optional)querystring特定コンテナ以降のリストをインポートする
    end_marker (Optional)querystring特定コンテナ以前のリストをインポートする
    prefix (Optional)querystring該当文字列で始まるコンテナリストを呼び出す
    reverse (Optional)querystringコンテナ名でソートしリストを出力
    default : false (descending)
    X-Auth-Token (Optional)headerstring発行した Token値を入力
    Accept (Optional)headerstring呼び出し結果のフォーマットを指定(application/json、application/xml、text/xml)

    レスポンス

    レスポンスヘッダ

    NameInTypeDescription
    X-Account-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-Timestampheaderinteger該当コンテナ(バケット)が作成された時刻(UNIX Time)
    X-Trans-Idheaderstring該当リクエストのトランザクション ID
    X-Openstack-Request-Idheaderstring該当リクエストのトランザクション ID(X-Trans-Idと同じ)
    Content-Typeheaderstringレスポンス結果のフォーマット
    Dateheaderstring該当リクエストのレスポンス時間(UTC)

    レスポンスボディ

    NameInTypeDescription
    namebodystring該当オブジェクト名
    countbodyinteger該当コンテナ(バケット)のオブジェクト数
    bytesbodyinteger該当コンテナ(バケット)が使用する全体容量のサイズ(Bytes)
    last_modifiedbodystring該当コンテナが最後に変更された時刻(UTC)

    リクエスト例(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: 96
    X-Account-Object-Count: 1
    X-Timestamp: 1389453423.35964
    X-Account-Meta-Subject: Literature
    X-Account-Bytes-Used: 14
    X-Account-Container-Count: 2
    Content-Type: application/json; charset=utf-8
    Accept-Ranges: bytes
    X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
    X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
    Date: Fri, 17 Jan 2014 15:59:33 GMT
    
    [
        {
            "count": 0,
            "bytes": 0,
            "name": "janeausten",
            "last_modified": "2013-11-19T20:08:13.283452"
        },
        {
            "count": 1,
            "bytes": 14,
            "name": "marktwain",
            "last_modified": "2016-04-29T16:23:50.460230"
        }
    ]
    

    リクエスト例(XML)

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

    レスポンス例

    HTTP/1.1 200 OK
    Content-Length: 262
    X-Account-Object-Count: 1
    X-Timestamp: 1389453423.35964
    X-Account-Meta-Subject: Literature
    X-Account-Bytes-Used: 14
    X-Account-Container-Count: 2
    Content-Type: application/xml; charset=utf-8
    Accept-Ranges: bytes
    X-Trans-Id: tx69f60bc9f7634a01988e6-0052d9544b
    X-Openstack-Request-Id: tx69f60bc9f7634a01988e6-0052d9544b
    Date: Fri, 17 Jan 2014 16:03:23 GMT
    
    <?xml version="1.0" encoding="UTF-8"?>
    <account name="my_account">
        <container>
            <name>janeausten</name>
            <count>0</count>
            <bytes>0</bytes>
            <last_modified>2013-11-19T20:08:13.283452</last_modified>
        </container>
        <container>
            <name>marktwain</name>
            <count>1</count>
            <bytes>14</bytes>
            <last_modified>2016-04-29T16:23:50.460230</last_modified>
        </container>
    </account>
    

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

    注意

    SubAccountの場合、 SubAccount専用リスト照会 API を使用する必要があります。


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

    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.