Consulta de regiões
Função
Essa API é usada para consultar as regiões acessíveis a um usuário especificado.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
GET /v3/regions
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Content-Type | Sim | String | Preencha application/json;charset=utf8 nesse campo. |
| X-Auth-Token | Sim | String | Token de usuário do IAM (sem requisitos de permissão especiais). Se o token não contiver informações de região privada, nenhuma região privada será retornada. |
Parâmetros de resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Object | Informações do link do recurso. | |
| Array of objects | Informações da região. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| self | String | Link de recurso. |
| previous | String | Link de recurso anterior. |
| next | String | Próximo link de recurso. |
Exemplo de solicitação
Solicitação para consultar uma lista de regiões
GET https://iam.myhuaweicloud.com/v3/regions
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{
"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 status
| Código de status | Descrição |
|---|---|
| 200 | A solicitação foi bem-sucedida. |
| 400 | Parâmetros inválidos. |
| 401 | Falha na autenticação. |
| 403 | Acesso negado. |
| 404 | O recurso solicitado não pode ser encontrado. |
| 405 | O método especificado na solicitação não é permitido para o recurso solicitado. |
| 413 | A entidade de solicitação é muito grande. |
| 500 | Erro de servidor interno. |
| 503 | Serviço indisponível. |
Códigos de erro
Nenhum
