Consulta de información sobre una instancia de proxy
Función
Esta API se utiliza para consultar información de una instancia de proxy. Antes de invocar a esta API:
Esta API dejará de estar disponible el 31 de marzo de 2025. Se recomienda cambiar las cargas de trabajo a la nueva API (Consulta de instancias proxy) antes de eso.
- Aprender cómo autorizar y autenticarla.
- Obtener los región y punto de conexión requeridos.
- Las instancias de proxy no están disponibles para las instancias de BD en un DeC.
URI
GET /v3/{project_id}/instances/{instance_id}/proxy
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | ID de proyecto de un tenant en una región. |
| instance_id | Sí | String | ID de instancia. |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | No | String | Token de usuario. |
| X-Language | No | String | Idioma. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| proxy | MysqlProxy object | Información de instancia de proxy. |
| master_node | MysqlProxyNode object | Información del nodo primario. |
| readonly_nodes | Array of MysqlProxyNode objects | Información de réplica de lectura. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| pool_id | String | ID de instancia de proxy. |
| status | String | Estado operativo de la instancia de proxy. Valores: closed, open, frozen, opening, closing, enlarging, freezing y unfreezing. |
| address | String | Dirección de división de lectura/escritura de proxy. |
| port | Integer | Información de puerto de proxy. |
| pool_status | String | Estado de instancia de proxy. Valor: ACTIVE, BUILD, FAILED o DELETED. |
| delay_threshold_in_seconds | Integer | Umbral de retardo en segundos. |
| elb_vip | String | Dirección IP virtual en modo ELB. |
| eip | String | Información de la EIP. |
| vcpus | String | Número de vCPUs de la instancia de proxy. |
| ram | String | Tamaño de la memoria de la instancia de proxy. |
| node_num | Integer | Número de nodos de proxy. |
| mode | String | Modo de instancia proxy. El valor es de Cluster. |
| nodes | Array of MysqlProxyNodes objects | Información del nodo de proxy. |
| flavor_ref | String | Especificaciones de proxy. |
| name | String | Nombre de instancia de proxy. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | ID de nodo de proxy. |
| status | String | Estado del nodo de proxy. Valor: normal, abnormal, creating o deleted. |
| name | String | Nombre del nodo de proxy. |
| role | String | Rol del nodo de proxy. Puede ser master o slave. |
| az_code | String | Zona de disponibilidad. |
| frozen_flag | Integer | Si el nodo proxy está congelado. Puede ser 0 (sin congelar), 1 (congelado) o 2 (eliminado después de ser congelado). |
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | ID del nodo. |
| instance_id | String | ID de instancia. |
| status | String | Estado del nodo. |
| name | String | Nombre del nodo. |
| weight | Integer | Ponderación de lectura del nodo. |
| available_zones | Array of MysqlProxyAvailable objects | Información de zona de disponibilidad. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Código de zona de disponibilidad. |
| description | String | Descripción de zona de disponibilidad. |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error_code | String | Código de error. |
| error_msg | String | Mensaje de error. |
Código de estado: 500
| Parámetro | Tipo | Descripción |
|---|---|---|
| error_code | String | Código de error. |
| error_msg | String | Mensaje de error. |
Ejemplo de la solicitud
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/proxy Ejemplo de respuesta
Código de estado: 200
Operación exitosa.
{
"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 estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.