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> Document Database Service> Referencia de la API> APIs V3.0 (recomendado)> Gestión de conexiones> Consulta del número de conexiones a un nodo de instancia

Actualización más reciente 2022-11-07 GMT+08:00

Consulta del número de conexiones a un nodo de instancia

Función

Esta API se utiliza para consultar el número de conexiones de cada cliente a instancias de base de datos DDS.

Restricciones

Las instancias congeladas no admiten esta operación.

Depuración

Puede depurar esta API en el Explorador de API.

URI

Formato URI
GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/conn-statistics?node_id={node_id}
Ejemplo
https://dds.ap-southeast1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/cc6345c64cec47499182467ea0dd432ain02/conn-statistics?node_id=51a90da2cfc846688abcdd23861077b5no02

Descripción del parámetro

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID de proyecto de un inquilino en una región.
instance_id	Sí	String	Especifica el ID de instancia de base de datos.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
node_id	No	String	Especifica el ID de nodo. Si este parámetro se deja en blanco, se consulta el número de conexiones de todos los nodos que se pueden conectar en la instancia.

Solicitudes

Ninguno

Respuestas

Parámetros de respuesta

**Tabla 3** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
total_connections	Integer	Indica el número total de conexiones, incluidas las conexiones internas y externas.
total_inner_connections	Integer	Indica el número total de conexiones internas.
total_outer_connections	Integer	Indica el número total de conexiones externas.
inner_connections	Array of objects	Indica la matriz de estadísticas de conexión interna. Se admiten hasta 200 registros. Para más detalles, consulte Tabla 4.
outer_connections	Array of objects	Indica la matriz de estadísticas de conexión externa. Se admiten hasta 200 registros. Para más detalles, consulte Tabla 4.

**Tabla 4** QueryConnectionsResponse
Parámetro	Tipo	Descripción
client_ip	String	Indica la dirección IP del cliente conectado a la instancia o nodo.
count	Integer	Indica el número de conexiones correspondientes a la dirección IP.

Ejemplo de respuesta

{
    "total_connections": 75,
    "total_inner_connections": 50,
    "total_outer_connections": 25,
    "inner_connections": [
        {"client_ip": "10.10.10.24", "count": 19},
        {"client_ip": "9.3.185.42", "count": 6},
        {"client_ip": "10.10.4.156", "count": 3}
    ],
    "outer_connections": [
        {"client_ip": "10.10.10.25", "count": 11},
        {"client_ip": "9.3.185.46", "count": 8},
        {"client_ip": "10.10.4.157", "count": 4}
    ]
}