Consulta da lista de instâncias de back-end (lista de servidores em nuvem)
Função
Esta API é usada para consultar os servidores em nuvem de um canal da VPC especificado.
URI
A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.
|
Método de solicitação |
URI |
|---|---|
|
GET |
/v1.0/apigw/vpc-channels/{id}/members[?page_size, page_no, name] |
- Uma combinação de diferentes condições de consulta pode ser adicionada no final do URI usando pontos de interrogação (?) e E comercial (&).
- As condições de consulta incluem: name, page_size e page_no.
A tabela a seguir lista os parâmetros no URI.
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
id |
Sim |
String |
ID do canal da VPC |
|
name |
Não |
String |
Nome do servidor em nuvem |
|
page_size |
Não |
Integer |
Número de servidores de nuvem exibidos em cada página. O valor padrão é 20. |
|
page_no |
Não |
Integer |
Número da página. O valor padrão é 1. |
Solicitação
N/D
Resposta
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
total |
Integer |
Número total de servidores em nuvem que correspondem às condições de consulta |
|
size |
Integer |
Comprimento da lista de servidores de nuvem retornada |
|
vpc_instances |
Dicionário |
Lista de servidores de nuvem |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
id |
String |
ID do objeto da instância de back-end |
|
vpc_id |
String |
ID do canal da VPC |
|
status |
Integer |
Status do objeto de instância de back-end |
|
instance_name |
String |
Nome do servidor em nuvem |
|
instance_id |
String |
ID do servidor em nuvem |
|
host |
String |
Endereço IP do servidor de nuvem |
|
weight |
Integer |
Peso do servidor de nuvem Quanto maior o peso, mais solicitações são encaminhadas ao servidor em nuvem. Faixa: 1–100 |
|
create_time |
Timestamp |
Hora em que o servidor em nuvem é adicionado ao canal da VPC |
Exemplo de resposta:
{
"total": 2,
"size": 2,
"vpc_instances": [
{
"instance_id": "instance02",
"instance_name": "instance_name02",
"host": "127.0.0.2",
"weight": 10,
"id": "680e42fab429447ca23b9623107523d9",
"vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
"status": 1,
"create_time": "2018-07-27T12:42:32Z"
},
{
"instance_id": "instance01",
"instance_name": "instance_name01",
"host": "127.0.0.1",
"weight": 10,
"id": "c3bc73605a8b400793363c87574fbad7",
"vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
"status": 1,
"create_time": "2018-07-27T12:30:48Z"
}
]
}
Códigos de status
|
Código de status |
Descrição |
|---|---|
|
200 |
OK |
|
400 |
Solicitação inválida |
|
401 |
Não autorizado |
|
403 |
Proibido |
|
404 |
Não encontrado |
|
500 |
Erro do servidor interno |