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
