Consulta de regiones
Función
Esta API se utiliza para consultar las regiones accesibles para un usuario especificado.
Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.
URI
GET /v3/regions
Parámetros de solicitud
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
Content-Type | Sí | String | Rellene application/json;charset=utf8 en este campo. |
X-Auth-Token | Sí | String | Token de usuario de IAM (sin requisitos de permiso especiales). Si el token no contiene información de región privada, no se devolverá ninguna región privada. |
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
Object | Información de enlace de recurso. | |
Array of objects | Información de la región. |
Parámetro | Tipo | Descripción |
|---|---|---|
self | String | Enlace de recurso. |
previous | String | Enlace de recurso anterior. |
next | String | Siguiente enlace de recurso. |
Solicitud de ejemplo
Solicitud de consulta de una lista de regiones
GET https://iam.myhuaweicloud.com/v3/regions Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{
"regions": [
{
"parent_region_id": null,
"description": "",
"links": {
"self": "https://iam.myhuaweicloud.com/v3/regions/ap-southeast-1"
},
"type": "public",
"id": "ap-southeast-1",
"locales": {
"zh-cn": "CN-Hong Kong",
"en-us": "ap-southeast-1"
}
},
{
"parent_region_id": null,
"description": "",
"links": {
"self": "https://iam.myhuaweicloud.com/v3/regions/la-south-2"
},
"type": "public",
"id": "la-south-2",
"locales": {
"pt-br": "AL-Santiago",
"zh-cn": "Region name in Chinese",
"en-us": "LA-Santiago",
"es-us": "AL-Santiago de Chile1",
"es-es": "LA-Santiago"
}
}
],
"links": {
"self": "https://iam.myhuaweicloud.com/v3/regions",
"previous": null,
"next": null
}
} Códigos de estado
Código de estado | Descripción |
|---|---|
200 | La solicitud se ha realizado correctamente. |
400 | Parámetros no válidos. |
401 | Error de autenticación. |
403 | Acceso denegado. |
404 | No se puede encontrar el recurso solicitado. |
405 | El método especificado en la solicitud no está permitido para el recurso solicitado. |
413 | La entidad solicitada es demasiado grande. |
500 | Error de servidor interno. |
503 | Servicio no disponible. |
Códigos de error
Ninguno
