更新时间：2026-10-20 GMT+08:00
获取OBS存储信息 - ListAssetCenterObsStorages
功能介绍
功能介绍：获取OBS存储信息
查询参数：bucket_name（可选参数不传时使用默认值）。
响应：请求成功返回HTTP 200及响应体。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/sdg/asset/obs/storage
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释： 项目ID，标识当前请求所属的华为云项目，可参考获取项目ID相关文档获取 约束限制： 满足正则匹配"^[a-z0-9]{32}$"，32位小写字母和数字 取值范围： 长度为32个字符，只能由小写英文字母和数字组成 默认取值： 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| bucket_name | 是 | String | 参数解释： 桶名称 约束限制： 满足正则匹配"^[\u4E00-\u9FA5\uF900-\uFA2D（）()-_\w-]{1,255}$"，1到255位中文字符、英文字母、数字及下划线、连字符 取值范围： 不涉及 默认取值： 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释： 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| object_num | Long | 参数解释： 对象数量 取值范围： 不涉及 |
| size | Long | 参数解释： 大小，单位为字节 取值范围： 不涉及 |
请求示例
获取OBS存储信息
/v1/2b31ed5200000ebedb6e570000000000/sdg/asset/obs/storage?bucket_name=my-resource-name
响应示例
状态码：200
{
"object_num" : 2,
"size" : 2
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
错误码
请参见错误码。
父主题： OBS桶管理
