Querying AZs

Function

This API is used to query AZs.

URI

GET /v2.1/{project_id}/os-availability-zone

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID.

Response

Table 2 describes the response parameters.

**Table 2** Response parameters
Parameter	Type	Description
availabilityZoneInfo	Array of objects	Specifies the AZ information. For details, see Table 3.

**Table 3** AvailabilityZoneInfo parameter information
Parameter	Type	Description
zoneState	Object	Specifies the AZ status. For details, see Table 4.
hosts	List	The parameter is set to null.
zoneName	String	Specifies the AZ name.

**Table 4** zoneState parameter information
Parameter	Type	Description
available	Boolean	Specifies the AZ status.

Example Request

Query a list of AZs.

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/os-availability-zone

Example Response

{
	"availabilityZoneInfo": [{
		"zoneState": {
			"available": true
		},
		"hosts": null,
		"zoneName": "az1"   //Replace the value with the actual AZ name.
	},
	{
		"zoneState": {
			"available": true
		},
		"hosts": null,
		"zoneName": "az2"   //Replace the value with the actual AZ name.
	}]
}