GetContainerList
    • PDF

    GetContainerList

    • PDF

    Article Summary

    概要

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

    構文

    GET https://{endpoint}/swift/v1
    

    リクエスト

    リクエストヘッダ

    ヘッダ名説明
    x-ncp-apigw-timestamp- 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの
    - APIGWサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    x-ncp-iam-access-keyNAVERクラウドプラットフォームで発行された API Keyまたは Sub Accountで発行された AccessKey
    x-ncp-apigw-signature-v2- 上記例の Bodyを AccessKeyとマッピングする SecretKeyで暗号化した署名
    - HMAC暗号化アルゴリズムは HmacSHA256を使用
    x-ncp-region_code他のクラウドから NAVERクラウドに移行させるデータのバケットが存在する region code

    リクエストパラメータ

    パラメータ名要否タイプ制約事項説明
    limit (Optional)-integer-呼び出し結果の最大数制限
    marker (Optional)-string-特定コンテナ以降のリストをインポートする
    end_marker (Optional)-string-特定コンテナ以前のリストをインポートする
    prefix (Optional)-string-該当文字列で始まるコンテナリストを呼び出す
    reverse (Optional)-string-コンテナ名でソートしリストを出力
    default : false (descending)

    レスポンス

    レスポンスヘッダ

    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)headerinteger該当コンテナ(バケット)の storage policy値
    X-Container-Read (Optional)headerinteger該当コンテナ(バケット)の READ ACL
    X-Container-Write (Optional)headerinteger該当コンテナ(バケット)の WRITE ACL
    X-Timestampheaderinteger該当コンテナ(バケット)が作成された時刻(UNIX Time)
    X-Trans-Idheaderstring該当リクエストのトランザクション ID
    X-Openstack-Request-Idheaderstring該当リクエストのトランザクション ID(X-Trans-Idと同じ)
    Content-Typeheaderstringレスポンス結果のフォーマット
    Dateheaderstring該当リクエストのレスポンス時間(UTC)
    hashheaderstring該当オブジェクトの MD5チェックサム値
    content_typeheaderstring該当オブジェクトタイプ

    レスポンスボディ

    NameInTypeDescription
    namebodystring該当オブジェクト名
    countbodyinteger該当オブジェクト数
    bytesbodyinteger該当オブジェクトのサイズ(bytes)
    last_modifiedbodystring該当オブジェクトが最後に変更された時刻(UTC)

    リクエスト例(JSON)

    curl -X GET "https://archivestorage.apigw.ntruss.com/swift/v1/?limit=1&marker=test" -H "accept: application/json" -H "x-ncp-region-code: {regionCode}"
    -H "x-ncp-iam-access-key: {AccessKey} " 
    -H "x-ncp-apigw-timestamp: {current timestamp}" 
    -H "x-ncp-apigw-signature-v2: {generated signature}"
    

    レスポンス例

    HTTP/1.1 200 OK
    Accept: application/json
    connection: keep-alive
    Content-Length: 2577
    Keep-alive: timeout=60
    X-Account-Bytes-Used: 786133
    X-Account-Container-Count: 6
    X-Account-Object-Count: 1
    X-Timestamp: 1634538594.09393
    Content-Type: application/json; charset=utf-8
    X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
    X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
    Date: Mon, 18 Apr 2022 11:07:18 GMT
    
    [
        {
    	"name": "test",
    	"count": 0,
    	"bytes": 0,
    	"last_modified": "2022-04-20T01:10:10.123456"
    	}
    ]
    

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

    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.