# 查询OBS对象存储桶中的对象列表
#### 功能介绍
此API用于获取OBS桶中的软件包列表。
#### URI
GET /v1/{project_id}/ss-service/obs/objects
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 |
   
表2查询参数 
| 参数          | 是否必选 | 参数类型   | 描述        |
|:---|:---|:---|:---|
| bucket_name | 是    | String | 查询的桶名称。   |
| prefix      | 是    | String | 查询的软件包路径。 |
   
#### 请求消息
表3请求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)。 |
   
#### 响应消息
表4响应参数 
| 参数       | 参数类型             | 描述                                                                   |
|:---|:---|:---|
| name     | String           | 桶名称。                                                                 |
| prefix   | String           | 查询的软件包路径。                                                            |
| contents | Array of objects | OBS桶中的对象列表，请参考[表 contents]。 |
| location | String           | 区域。                                                                  |
| endpoint | String           | OBS域名信息。                                                             |
   
 表5contents 
| 参数            | 参数类型    | 描述                                                              |
|:---|:---|:---|
| key           | String  | 包含桶中完整路径的软件包名称。                                                 |
| last_modified | String  | 最后修改时间。                                                         |
| size          | Integer | 软件包大小。                                                          |
| storage_class | String  | 软件包存储类型。                                                        |
| owner         | Object  | 拥有者信息，请参考[表 owner]。 |
   
 表6owner 
| 参数           | 参数类型   | 描述    |
|:---|:---|:---|
| id           | String | 租户ID。 |
| display_name | String | 租户名称。 |
   
#### 请求示例
无
#### 响应示例
```
{
    "name": "ss-test",
    "prefix": "appuser-zip/",
    "contents": [
        {
            "key": "appuser-zip/",
            "last_modified": "2025-10-16T08:39:11.579Z",
            "size": 0,
            "storage_class": "STANDARD",
            "owner": {
                "id": "6dfd8c167c5945d9baca04685ac628fa",
                "display_name": "servicestage-user"
            }
        },
        {
            "key": "appuser-zip/demoJavaExample.tar.gz",
            "last_modified": "2025-10-16T08:40:38.56Z",
            "size": 53003227,
            "storage_class": "STANDARD",
            "owner": {
                "id": "6dfd8c167c5945d9baca04685ac628fa",
                "display_name": "servicestage-user"
            }
        }
    ],
    "location": "test-region",
    "endpoint": "https://example.test-region.com:443"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 操作成功。  |
| 400 | 错误的请求。 |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。