Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Proxy de base de datos/ Consulta de instancias de proxy de base de datos
Actualización más reciente 2023-12-14 GMT+08:00
Ver PDF
Compartir

Consulta de instancias de proxy de base de datos

Función

Esta API se utiliza para consultar instancias de proxy de base de datos. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/proxies

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia.
Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

offset

No

Integer

Desplazamiento de índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. El valor es 0 de forma predeterminada, lo que indica que la consulta comienza desde el primer dato. El valor no puede ser un número negativo.

limit

No

Integer

Número de registros a consultar. El valor predeterminado es 10. El valor debe ser un número positivo entero. El valor mínimo es de 1 y el valor máximo de 100.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado 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

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

proxy_list

Array of MysqlShowProxyResponseV3 objects

Instancias de proxy.
Tabla 5 MysqlShowProxyResponseV3

Parámetro

Tipo

Descripción

proxy

MysqlProxyV3 object

Información de instancia de proxy.

master_node

MysqlProxyNodeV3 object

Información del nodo primario.

readonly_nodes

Array of MysqlProxyNodeV3 objects

Información de réplica de lectura.
Tabla 6 MysqlProxyV3

Parámetro

Tipo

Descripción

pool_id

String

ID de instancia de proxy.

status

String

Estado operativo de la instancia de proxy. Puede ser cualquiera de las siguientes:

  • ACTIVE: El proxy de la base de datos es normal.
  • FAILED: No se puede crear el proxy de la base de datos.
  • DELETED: Se elimina el proxy de la base de datos.
  • ABNORMAL: El proxy de la base de datos es anormal.
  • ENABLING PROXY: Se está habilitando el proxy de la base de datos.
  • DISABLING PROXY: Se está deshabilitando el proxy de la base de datos.
  • ADDING PROXY NODE: Se están agregando nodos al proxy de la base de datos.
  • DELETING READ REPLICAS FROM PROXY: Réplicas de lectura se están eliminando del proxy de la base de datos.
  • ADDING READ REPLICAS TO PROXY: Se están agregando réplicas de lectura al proxy de la base de datos.
  • CHANGING WEIGHTS: se están cambiando las ponderaciones de las réplicas de lectura para el proxy de base de datos.

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, ABNORMAL, 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

Proxy primario/en espera. El valor es 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.

transaction_split

String

Si la división de transacciones de proxy está habilitada. Valor: ON y OFF.
Tabla 7 MysqlProxyNodes

Parámetro

Tipo

Descripción

id

String

ID de nodo de proxy.

status

String

Estado del nodo de proxy. Valor: ACTIVE, ABNORMAL, BUILD o FAILED.

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).
Tabla 8 MysqlProxyNodeV3

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.

availability_zone

Array of MysqlProxyAvailable objects

Información de zona de disponibilidad.
Tabla 9 MysqlProxyAvailable

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

Tabla 10 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 11 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Solicitud de ejemplo

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/proxies?offset=0&limit=10

Ejemplo de respuesta

Código de estado: 200

Success.

{
  "proxy_list" : [ {
    "proxy" : {
      "pool_id" : "2e7cf21d14794bafab623a334efd9ad8po01",
      "status" : "ACTIVE",
      "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" : "c01a5645eb2c4fb6a9373542f5366e50no07",
      "instance_id" : "7a871d6d494e4327ad2e326afb591108in07",
      "status" : "ACTIVE",
      "name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node01",
      "weight" : 0,
      "availability_zone" : [{
        "code" : "az1",
        "description": "AZ1"
      }]
    },
    "readonly_nodes" : {
      "id" : "d23535333138462880bfa1838fdfced2no07",
      "instance_id" : "7a871d6d494e4327ad2e326afb591108in07",
      "status" : "ACTIVE",
      "name" : "taurus_mysql80_x86-ondemand-2-1U4G_1_202103070251274842281_node02",
      "weight" : 100,
      "availability_zone" : [{
        "code" : "az1",
        "description": "AZ1"
      }]
    }
  } ]
}

Código de estado

Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.

Tema principal: Proxy de base de datos