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

Querying Instance Resource Specifications

Function

This API is used to obtain instance resource specifications. Pagination query is supported. You can specify project_id and instance_type to obtain resource specifications of a certain type of instances in a specific project. You can use this API during instance creation or configuration modification.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/instances/specifications

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which is used to specify the project scope to be queried.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

instance_type

Yes

String

Instance type. Currently, only the ADG type is supported.

limit

No

Integer

Number of records returned on each page. The default value is 10.

offset

No

Integer

Offset of the returned records. The default value is 0.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

count

Long

Total number of resource specifications.

items

Array of ResourceSpecification objects

List of resource specifications.

Table 4 ResourceSpecification

Parameter

Type

Description

asset

Integer

Asset value of the resource.

cpu

Integer

Number of CPUs.

disk

Integer

Disk size.

ram

Integer

Memory size.

resource_spec_code

String

Resource specification code.

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

OK

401

Unauthorized. The request requires identity authentication.

403

Access denied. Unauthorized user.

404

The requested resource does not exist.

Error Codes

See Error Codes.