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 |