# 查询OBS对象存储的桶列表
#### 功能介绍
此API用于获取OBS桶列表。
#### URI
GET /v1/{project_id}/ss-service/obs/buckets
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 |
   
#### 请求消息
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 消息体的类型（格式），默认取值为"application/json;charset=utf8"。                                                                                             |
| X-Auth-Token | 是    | String | 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 |
   
#### 响应消息
表3响应参数 
| 参数            | 参数类型   | 描述        |
|:---|:---|:---|
| name          | String | OBS桶名称。   |
| creation_date | String | OBS桶创建时间。 |
| location      | String | 区域。       |
   
#### 请求示例
无
#### 响应示例
```
[
    {
        "name": "apitest",
        "creation_date": "2025-01-07T02:55:05.89Z",
        "location": "test-region"
    },
    {
        "name": "app-env",
        "creation_date": "2025-05-14T10:21:37.673Z",
        "location": "test-region"
    }
]
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 操作成功。  |
| 400 | 错误的请求。 |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。