Consulta de AZs
Função
Esta API é usada para consultar AZs onde você pode comprar gateways.
URI
GET /v2/{project_id}/apigw/available-zones
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| project_id | Sim | String | ID do projeto. Para obter detalhes sobre como obter um ID de projeto, consulte "Apêndice" > "Obtenção de um ID de projeto" neste documento. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Sim | String | Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| available_zones | Array of AvailableZone objects | Lista de AZ. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| name | String | Nome AZ. |
| id | String | Mensagem de erro. |
| code | String | Código de AZ. |
| port | String | Porta de AZ. |
| local_name | LocalName object | Nomes de AZ. |
| specs | Map<String,Boolean> | Edições de gateway disponíveis na AZ. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| en_us | String | Nome AZ. |
| zh_cn | String | Nome de AZ em chinês. |
Código de status: 401
| Parâmetro | Tipo | Descrição |
|---|---|---|
| error_code | String | Código de erro. |
| error_msg | String | Mensagem de erro. |
Código de status: 403
| Parâmetro | Tipo | Descrição |
|---|---|---|
| error_code | String | Código de erro. |
| error_msg | String | Mensagem de erro. |
Código de status: 500
| Parâmetro | Tipo | Descrição |
|---|---|---|
| error_code | String | Código de erro. |
| error_msg | String | Mensagem de erro. |
Exemplo de solicitações
Nenhum
Exemplo de respostas
Código de status: 200
OK
{
"available_zones" : [ {
"code" : "xx-xxx-4a",
"id" : "effdcbc7d4d64a02aa1fa26b42f56533",
"local_name" : {
"en_us" : "AZ1",
"zh_cn" : "<Name_of_AZ1>"
},
"name" : "<Name_of_AZ1>",
"port" : "8403",
"specs" : {
"BASIC" : true,
"BASIC_IPV6" : false,
"ENTERPRISE" : true,
"ENTERPRISE_IPV6" : false,
"PLATINUM" : true,
"PLATINUM_IPV6" : false,
"PROFESSIONAL" : true,
"PROFESSIONAL_IPV6" : false,
"TRIAL" : true
}
}, {
"code" : "xx-xxx-4b",
"id" : "a0865121f83b41cbafce65930a22a6e8",
"local_name" : {
"en_us" : "AZ2",
"zh_cn" : "<Name_of_AZ2>"
},
"name" : "<Name_of_AZ2>",
"port" : "8404",
"specs" : {
"BASIC" : true,
"BASIC_IPV6" : true,
"ENTERPRISE" : true,
"ENTERPRISE_IPV6" : true,
"PLATINUM" : true,
"PLATINUM_IPV6" : false,
"PROFESSIONAL" : true,
"PROFESSIONAL_IPV6" : true,
"TRIAL" : true
}
} ]
} Código de status: 401
Não autorizado
{
"error_code" : "APIC.7102",
"error_msg" : "Incorrect token or token resolution failed"
} Código de status: 403
Proibido
{
"error_code" : "APIC.7106",
"error_msg" : "No permissions to request for the method"
} Código de status: 500
Erro do servidor interno
{
"error_code" : "APIC.9000",
"error_msg" : "Failed to request internal service"
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | OK |
| 401 | Não autorizado |
| 403 | Proibido |
| 500 | Erro do servidor interno |
Códigos de erro
Consulte Códigos de erro.