查询OBS桶列表
功能介绍
查询OBS桶列表。
只有用户创建了委托授权，方可使用此接口。创建委托授权参见本文档：证书吊销处理>创建委托。
URI
GET /v1/private-certificate-authorities/obs/buckets
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | OBS桶总数。 |
| obs_buckets | Array of ObsBuckets objects | OBS桶列表，详情请参见ObsBuckets字段数据结构说明。 数组长度：0 - 256 |
状态码： 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误请求返回的错误码。 最小长度：3 最大长度：36 |
| error_msg | String | 错误请求返回的错误信息。 最小长度：0 最大长度：1024 |
状态码： 401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误请求返回的错误码。 最小长度：3 最大长度：36 |
| error_msg | String | 错误请求返回的错误信息。 最小长度：0 最大长度：1024 |
状态码： 403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误请求返回的错误码。 最小长度：3 最大长度：36 |
| error_msg | String | 错误请求返回的错误信息。 最小长度：0 最大长度：1024 |
状态码： 404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误请求返回的错误码。 最小长度：3 最大长度：36 |
| error_msg | String | 错误请求返回的错误信息。 最小长度：0 最大长度：1024 |
状态码： 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误请求返回的错误码。 最小长度：3 最大长度：36 |
| error_msg | String | 错误请求返回的错误信息。 最小长度：0 最大长度：1024 |
请求示例
查询用户OBS桶列表，请求头中的X-Auth-Token字段需要填写token，且该token需要具有本API的访问权限。
GET https://{Endpoint}/v1/private-certificate-authorities/obs/buckets 响应示例
状态码： 200
请求已成功
{
"total" : 2,
"obs_buckets" : [ {
"create_time" : 1554867690718,
"bucket_name" : "admin1"
}, {
"create_time" : 1554949519646,
"bucket_name" : "admin3"
} ]
} 状态码： 400
请求参数有误。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
} 状态码： 401
被请求的页面需要鉴权。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
} 状态码： 403
认证失败。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
} 状态码： 404
资源不存在或资源未找到。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
} 状态码： 500
服务内部错误。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
| 400 | 请求参数有误。 |
| 401 | 被请求的页面需要鉴权。 |
| 403 | 认证失败。 |
| 404 | 资源不存在或资源未找到。 |
| 500 | 服务内部错误。 |
错误码
请参见错误码。
