查询OBS对象存储桶中的对象列表

功能介绍

此API用于获取OBS桶中的软件包列表。

URI

GET /v1/{project_id}/ss-service/obs/objects

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户项目ID。获取方法，请参考获取项目ID。

表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。

响应消息

表4 响应参数
参数	参数类型	描述
name	String	桶名称。
prefix	String	查询的软件包路径。
contents	Array of objects	OBS桶中的对象列表，请参考表 contents。
location	String	区域。
endpoint	String	OBS域名信息。

表5 contents
参数	参数类型	描述
key	String	包含桶中完整路径的软件包名称。
last_modified	String	最后修改时间。
size	Integer	软件包大小。
storage_class	String	软件包存储类型。
owner	Object	拥有者信息，请参考表 owner。

表6 owner
参数	参数类型	描述
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"
}