文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ 历史API/ 服务透传/ 查询OBS对象存储桶中的对象列表
更新时间：2025-11-20 GMT+08:00
查看PDF
分享

查询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 object

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"
}

状态码

状态码

描述

200

操作成功。

400

错误的请求。

错误码

请参考ServiceStage错误码。

父主题： 服务透传

相关文档