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

Returned Values

See Returned Values for General Requests.