7.3. バケット情報の取得

GET /1/(tenantId)/buckets/(bucketType)/(bucketName)

バケットの情報を取得する。

Request Headers:  

• X-Application-Id -- アプリケーションID(必須)
• X-Application-Key -- アプリケーションキー(必須)
• X-Session-Token -- セッショントークン(オプション)

Parameters:

• bucketType (string) -- バケット種別。オブジェクトストレージの場合は "object"、ファイルストレージの場合は "file"。
• bucketName (string) -- バケット名

Status Codes:

• 200 OK -- 正常取得した
• 400 Bad Request -- パラメータ不正
• 401 Unauthorized -- 認証エラー
• 403 Forbidden -- 権限エラー
• 404 Not Found -- 指定したバケットが存在しない

Response JSON Object:  

• name (string) -- バケット名
• description (string) -- バケットの説明
• ACL (object) -- バケットACL
• contentACL (object) -- コンテンツACL
• noAcl (boolean) -- ACLレス指定

レスポンスボディの例

{
    "name": "bucketName",
    "description": "説明文",
    "ACL": {
        /*...*/
    },
    "contentACL": {
        /*...*/
    },
    "noAcl": false
}

注意事項

• 対象バケットに対する read 権限が必要である。