Updated on 2026-09-03 GMT+08:00

Querying Details About a Flavor

Function

This API is used to query details about a specification.

Calling Method

For details, see Calling APIs.

URI

GET /v1.0/{project_id}/flavors/{flavor_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name. Constraints N/A Range Project ID of an account. The value contains 32 characters, consisting of lowercase letters and digits. Default Value N/A
flavor_id	Yes	String	Definition Specification ID. Constraints N/A Range ID returned by the instance specifications list API. Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
str_id	String	Definition Specification ID. Range N/A
name	String	Definition: Flavor name. Value range: N/A
condOperationStatus	String	Definition: This parameter takes effect region-wide. If an AZ is not configured in the condOperationAz parameter, the value of this parameter is used by default. Value range: normal: The flavor is in normal commercial use. sellout: The flavor has been sold out.
condOperationAz	String	Definition This parameter takes effect AZ-wide. If an AZ is not configured in this parameter, the value of the condOperationStatus parameter is used by default. The value is in the az(xx) format. The value in parentheses is the flavor status of the AZ. If the parentheses are left blank, the configuration is invalid. The value range for this parameter is the same as that for condOperationStatus. Range N/A
flavor_detail	Array of ShowFlavorDetailRspFlavorDetail objects	Definition Specification attribute information, including the CPU, memory, disk range, and specification category.

**Table 3** ShowFlavorDetailRspFlavorDetail
Parameter	Type	Description
name	String	Definition: Attribute name. Value range: cpu: flavor CPU attribute. mem: flavor memory attribute. diskrange: flavor disk capacity range attribute. flavorTypeCn: flavor classification attribute in Chinese. flavorTypeEn: flavor classification attribute in English.
value	String	Definition: Attribute value. Value range: N/A

Example Requests

Sample request for querying node flavor details.

GET https://{Endpoint}/v1.0/{project_id}/flavors/{flavor_id}

Example Responses

Status code: 200

Request succeeded.

{
  "name" : "ess.spec-2u8g",
  "condOperationStatus" : "normal",
  "condOperationAz" : "cn-north-7a(sellout),cn-north-7b(normal),cn-north-7c(normal)",
  "str_id" : "b58dfcfb-5f73-4f05-8c06-5171b12fd618",
  "flavor_detail" : [ {
    "name" : "cpu",
    "value" : "2"
  }, {
    "name" : "diskrange",
    "value" : "40,800"
  }, {
    "name" : "flavorTypeCn",
    "value" : "General computing"
  }, {
    "name" : "flavorTypeEn",
    "value" : "General computing"
  }, {
    "name" : "mem",
    "value" : "8"
  } ]
}

Status Codes

Status Code	Description
200	Request succeeded.
400	The request is invalid. Modify the request and then try again.
403	The request is rejected. The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.

Status Code

Description

200

Request succeeded.

400

The request is invalid.

Modify the request and then try again.

403

The request is rejected.

The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.

Error Codes

See Error Codes.

Parent topic: Specifications Query