Querying All AZs

Function

This API is used to query all AZs.

URI

• URI format

  GET /v3/{project_id}/os-availability-zone

• Parameter description

  Parameter	Mandatory	Description
  project_id	Yes	Specifies the project ID.

Request

• Example request

  GET https://{endpoint}/v3/{project_id}/os-availability-zone
  

Response

• Response parameters

  Parameter	Type	Description
  availabilityZoneInfo	list	The list of queried AZs. For details, see Parameters in the availabilityZoneInfo field.
  error	Object	The error message returned if an error occurs. For details, see Parameters in the error field.

• Parameters in the availabilityZoneInfo field

  Parameter	Type	Description
  zoneState	Object	The AZ status. For details, see Parameter in the zoneState field.
  zoneName	String	The AZ name.

• Parameter in the zoneState field

  Parameter	Type	Description
  available	Boolean	Whether the AZ is available. true: available false: unavailable

• Parameters in the error field

  Parameter	Type	Description
  message	String	The error message returned if an error occurs.
  code	String	The error code returned if an error occurs. For details about the error code, see Error Codes.

• Example response

  {
      "availabilityZoneInfo": [
          {
              "zoneState": {
                  "available": true
              },
              "zoneName": "az-dc-1"
          }
      ]
  }
  

  or

  {
      "error": {
          "message": "XXXX",
          "code": "XXX"
      }
  }
  

Status Codes

• Normal

  200

Error Codes

For details, see Error Codes.

last updated: 2024-11-13 14:31 UTC - commit: 8d943812e7d8424718eb8315e2294eccf373143f