Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2024-09-04 GMT+08:00

Consulta de todas las AZ

Función

Esta API se utiliza para consultar todas las zonas de disponibilidad.

Método de invocación

Para obtener más información, consulte Invocación a las API.

URI

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

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

El token del usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

availabilityZoneInfo

Array of AzInfo objects

La lista de las AZ devueltas.

Tabla 4 AzInfo

Parámetro

Tipo

Descripción

zoneName

String

El nombre de la AZ.

zoneState

ZoneState object

El estado de la AZ.

Tabla 5 ZoneState

Parámetro

Tipo

Descripción

available

Boolean

Si la AZ está disponible.

Código de estado: 400

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error.

Tabla 7 Error

Parámetro

Tipo

Descripción

code

String

El código de error devuelto si se produce un error.

Para obtener más detalles sobre los códigos de error y sus significados, consulte Códigos de error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

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

Ejemplo de respuestas

Código de estado: 200

La información de AZ devuelta.

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

Código de estado: 400

Error en la solicitud

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

Códigos de estado

Código de estado

Descripción

200

La información de AZ devuelta.

400

Error en la solicitud

Códigos de error

Consulte Códigos de error.