本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 媒体处理 MPC/ API参考/ 授权与配置接口/ 查询桶列表

查询桶列表

更新时间：2025-03-25 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	查询桶列表失败。

错误码

请参见错误码。

父主题： 授权与配置接口

上一篇：查询转码服务端所有事件

下一篇：桶授权或取消授权

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询桶列表

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈