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

Querying Details About a Flavor

Function

Query node specification details.

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

Value range:

For details, see Obtaining a Project ID and Name.

Default value:

N/A

flavor_id

Yes

String

Definition:

Flavor ID.

Constraints:

N/A

Value range:

ID returned by the node 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:

Flavor ID.

Value 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 condOperationAz parameter is used by default. The value format of this parameter is az(xx). 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.

Value range:

N/A

flavor_detail

Array of ShowFlavorDetailRspFlavorDetail objects

Definition:

Flavor attributes.

Value range:

N/A

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

SDK Sample Code

The SDK sample code is as follows.

Java

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.css.v1.region.CssRegion;
import com.huaweicloud.sdk.css.v1.*;
import com.huaweicloud.sdk.css.v1.model.*;


public class ShowFlavorDetailSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        CssClient client = CssClient.newBuilder()
                .withCredential(auth)
                .withRegion(CssRegion.valueOf("<YOUR REGION>"))
                .build();
        ShowFlavorDetailRequest request = new ShowFlavorDetailRequest();
        request.withFlavorId("{flavor_id}");
        try {
            ShowFlavorDetailResponse response = client.showFlavorDetail(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

Python

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcss.v1.region.css_region import CssRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcss.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = CssClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CssRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ShowFlavorDetailRequest()
        request.flavor_id = "{flavor_id}"
        response = client.show_flavor_detail(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

Go

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    css "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/css/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/css/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/css/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := css.NewCssClient(
        css.CssClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ShowFlavorDetailRequest{}
	request.FlavorId = "{flavor_id}"
	response, err := client.ShowFlavorDetail(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

More

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

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.

Error Codes

See Error Codes.