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 de las API.
Información de autorización
Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener asignados los permisos requeridos.
- Si está utilizando la autorización basada en roles/políticas, consulte Políticas de permisos y acciones admitidas para obtener más información sobre los permisos requeridos.
- Si está utilizando la autorización basada en políticas de identidad, no se requiere ningún permiso basado en políticas de identidad para invocar esta API.
URI
GET /v2/{project_id}/os-availability-zone
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | Definición El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto. Restricciones N/D Rango N/D Valor predeterminado N/D |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Definición El token de usuario. Puede obtenerlo invocando la API de IAM para obtener un token de usuario. El token es el valor de X-Subject-Token en el encabezado de respuesta. Restricciones N/D Rango N/D Valor predeterminado N/D |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| availabilityZoneInfo | Array of AzInfo objects | Definición La lista de las AZ devueltas. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| zoneName | String | Definición El nombre de la AZ. Rango N/D |
| zoneState | ZoneState object | Definición El estado de la AZ. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| available | Boolean | Definición Si la AZ está disponible. Rango N/D |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición La información de error devuelta si se produce un error. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error. |
| message | String | Definición El mensaje de error devuelto si se produce un error. Rango N/D |
Ejemplos de solicitudes
GET https://{endpoint}/v2/{project_id}/os-availability-zone Ejemplos de respuestas
Código de estado: 200
OK
{
"availabilityZoneInfo" : [ {
"zoneState" : {
"available" : true
},
"zoneName" : "az-dc-1"
} ]
} Código de estado: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "EVS.XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
