文档首页/ 媒体处理 MPC/ API参考/ 授权与配置接口/ 查询桶列表
更新时间：2024-09-14 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询桶列表

功能介绍

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

调用方法

请参见如何调用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

查询桶列表失败。

错误码

请参见错误码。

父主题： 授权与配置接口

相关文档