Updated on 2025-11-28 GMT+08:00

Querying the OBS Bucket List

Function

This API is used to obtain the OBS bucket list.

URI

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

Table 1 Path parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.

Response

Table 3 Response parameters

Parameter

Type

Description

name

String

OBS bucket name.

creation_date

String

OBS bucket creation time.

location

String

Region.

Example Request

None

Example Response

[
    {
        "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"
    }
]

Status Code

Status Code

Description

200

OK

400

Bad Request

Error Code

See ServiceStage Error Codes.