Consulta de informações sobre uma instância de proxy
Função
Essa API é usada para consultar informações de uma instância de proxy. Antes de chamar essa API:
Esta API estará indisponível em 31 de março de 2025. É aconselhável mudar as cargas de trabalho para a nova API (Consulta de instâncias de proxy) antes disso.
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
- instâncias de proxy não estão disponíveis para instâncias de BD em uma DeC.
URI
GET /v3/{project_id}/instances/{instance_id}/proxy
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| project_id | Sim | String | ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
| instance_id | Sim | String | ID da instância. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Não | String | Token do usuário. |
| X-Language | Não | String | Linguagem. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| proxy | MysqlProxy object | Informações da instância de proxy. |
| master_node | MysqlProxyNode object | Informações do nó primário. |
| readonly_nodes | Array of MysqlProxyNode objects | Informações da réplica de leitura. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| pool_id | String | ID da instância do proxy. |
| status | String | Status operacional da instância de proxy. Valores: closed, open, frozen, opening, closing, enlarging, freezing e unfreezing. |
| address | String | Endereço de divisão de leitura/gravação de proxy. |
| port | Integer | Informações da porta de proxy. |
| pool_status | String | Status da instância de proxy. Valor: ACTIVE, BUILD, FAILED ou DELETED. |
| delay_threshold_in_seconds | Integer | Limite de atraso em segundos. |
| elb_vip | String | Endereço IP virtual em modo de ELB. |
| eip | String | Informações do EIP. |
| vcpus | String | Número de vCPUs da instância de proxy. |
| ram | String | Tamanho da memória da instância do proxy. |
| node_num | Integer | Número de nós de proxy. |
| mode | String | Modo de instância de proxy. O valor é Cluster. |
| nodes | Array of MysqlProxyNodes objects | Informações do nó de proxy. |
| flavor_ref | String | Especificações do proxy. |
| name | String | Nome da instância do proxy. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | String | ID do nó de proxy. |
| status | String | Status do nó de proxy. Valor: normal, abnormal, creating ou deleted. |
| name | String | Nome do nó do proxy. |
| role | String | Função do nó de proxy. Pode ser master ou slave. |
| az_code | String | AZ. |
| frozen_flag | Integer | Se o nó de proxy está congelado. Pode ser 0 (descongelado), 1 (congelado) ou 2 (excluído após ser congelado). |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | String | ID do nó. |
| instance_id | String | ID da instância. |
| status | String | Status do nó. |
| name | String | Nome do nó. |
| weight | Integer | Peso de leitura do nó. |
| available_zones | Array of MysqlProxyAvailable objects | Informações da AZ. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| code | String | Código de AZ. |
| description | String | Descrição da AZ. |
Código de status: 400
| 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ção
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/proxy Exemplo de resposta
Código de status: 200
Bem-sucedido.
{
"proxy" : {
"pool_id" : "2e7cf21d14794bafab623a334efd9ad8po01",
"status" : "open",
"address" : "192.168.125.69",
"port" : 3306,
"pool_status" : "ACTIVE",
"delay_threshold_in_seconds" : 30,
"elb_vip" : "192.168.125.60",
"eip" : "192.168.125.50",
"vcpus" : 4,
"ram" : 8,
"node_num" : 2,
"mode" : "Cluster",
"nodes" : {
"id" : "db53a238a02240c49365e72e284a4890pn01",
"name" : "PROXY-2e7cf21d14794bafab623a334efd9ad8po01_0",
"role" : "master",
"az_code" : "az1xahz",
"status" : "ACTIVE",
"frozen_flag" : 0
},
"name" : "proxy-name"
},
"master_node" : {
"id" : "5ee8010ab992460d8d9cffcc5edabb59no07",
"instance_id" : "7a871d6d494e4327ad2e326afb591108in07",
"status" : "ACTIVE",
"name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node01",
"weight" : 0,
"available_zones" : {
"code" : "az1xahz",
"description": "AZ1"
}
},
"readonly_nodes" : {
"id" : "d23535333138462880bfa1838fdfced2no07",
"instance_id" : "7a871d6d494e4327ad2e326afb591108in07",
"status" : "ACTIVE",
"name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node02",
"weight" : 100,
"available_zones" : {
"code" : "az1xahz",
"description": "AZ1"
}
}
} Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.