更新时间:2024-09-14 GMT+08:00

查询桶列表

功能介绍

请求查询自己创建的指定的桶区域位置的桶列表。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/buckets

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Project_Id

String

使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

buckets

Array of ObsBucket objects

桶列表

表4 ObsBucket

参数

参数类型

描述

bucket

String

桶名称

creation_date

String

桶的创建时间

is_authorized

Integer

授权结果

取值范围为[0,1]

  • 0:表示未授权给转码服务

  • 1:表示已授权转码服务

状态码: 403

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET https://{endpoint}/v1/{project_id}/buckets

响应示例

状态码: 200

查询桶列表成功。

{
  "buckets" : [ {
    "bucket" : "example-bucket",
    "creation_date" : 20221026152511,
    "is_authorized" : 1
  }, {
    "bucket" : "example-bucket",
    "creation_date" : 20221026104736,
    "is_authorized" : 0
  } ]
}

状态码: 403

查询桶列表失败。

{
  "error_code" : "MPC.10208",
  "error_msg" : "Failed to verify the tenant ID."
}

状态码

状态码

描述

200

查询桶列表成功。

403

查询桶列表失败。

错误码

请参见错误码