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

Querying Recommended AZs for a Flavor

This API is used to query recommended AZs for a flavor.

You can debug this API in API Explorer.

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
If you are using identity policy-based authorization, the permissions listed below are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
ecs:cloudServerFlavors:get	read	-	-	-	-

GET /v1/{project_id}/cloudservers/flavors/{flavor_id}/resources

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Definition Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
flavor_id	Yes	Definition Specifies the flavor ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
region_ids	No	String	Definition Regions where the flavor to be queried is located. Use commas (,) to separate multiple region IDs. Constraints N/A Range N/A Default Value N/A

None

Table 3 describes the response parameter.

**Table 3** Response parameters
Parameter	Type	Description
resources	Array of objects	Definition Recommended AZs for a flavor. For details, see Table 4. Range N/A

**Table 4** **resources** field description
Parameter	Type	Description
region_id	String	Definition Specifies the ID of the region that the flavor belongs to. Range N/A
availability_zone	String	Definition Specifies the AZ that the flavor belongs to. Range N/A
prefer	Boolean	Definition Specifies whether the current AZ is the recommended AZ for a flavor. Range true: The current AZ is a recommended AZ for the flavor. false: The current AZ is not a recommended AZ for the flavor.

Query recommended AZs for a flavor.

GET https://{endpoint}/v1/{project_id}/cloudservers/flavors/{flavor_id}/resources

{
	"resources": [{
		"region_id": "region_01",
		"availability_zone": "az1",
		"prefer": false
	}]
}

Parent topic: Flavor Management