Updated on 2026-01-13 GMT+08:00

Obtaining OBS Storage Information

Function

This API is used to obtain OBS storage information, including the storage capacity and usage.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/sdg/asset/obs/storage

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which is used to identify a specific project.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

bucket_name

Yes

String

OBS bucket name.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

object_num

Long

Number of objects in an OBS bucket.

size

Long

Total size of an OBS bucket (unit: byte).

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

OBS storage information is obtained.

401

Unauthorized access. The request is rejected.

403

Unauthorized operation. The request is rejected.

404

The project does not exist. Retrieval failed.

Error Codes

See Error Codes.