Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Document Database Service> Referência de API> APIs V3.0 (recomendada)> Gerenciamento de conexões> Consulta do número de conexões com um nó de instância
Atualizado em 2023-05-06 GMT+08:00
Ver PDF

Consulta do número de conexões com um nó de instância

Descrição

Essa API é usada para consultar o número de conexões de cada cliente para instâncias de banco de dados do DDS.

Restrições

Instâncias congeladas não suportam esta operação.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/conn-statistics?node_id={node_id}

  • Exemplo de URI

    https://dds.ap-southeast1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/cc6345c64cec47499182467ea0dd432ain02/conn-statistics?node_id=51a90da2cfc846688abcdd23861077b5no02

Solicitações

Descrição do parâmetro

Tabela 1 Parâmetros de solicitação

Nome

Tipo

IN

Obrigatório

Descrição

x-auth-token

string

header

Sim

Token do usuário

project_id

string

path

Sim

O ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

string

path

Sim

ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

node_id

string

query

Não

O ID do nó.

Se este parâmetro for deixado em branco, o número de conexões de todos os nós que podem ser conectados na instância é consultado por padrão.

Respostas

  • Parâmetros de resposta
    Tabela 2 Parâmetros de corpo da resposta

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    total_connections

    Integer

    Sim

    O número total de conexões, incluindo conexões internas e externas.

    total_inner_connections

    Integer

    Sim

    O número total de conexões internas.

    total_outer_connections

    Integer

    Sim

    O número total de conexões externas.

    inner_connections

    Array of objects

    Sim

    A matriz de estatísticas de conexão interna. Até 200 registros são suportados. Para mais detalhes, consulte Tabela 3.

    outer_connections

    Array of objects

    Sim

    A matriz de estatísticas de conexão externa. Até 200 registros são suportados. Para mais detalhes, consulte Tabela 3.
    Tabela 3 Descrição da estrutura de dados dos campos inner_connections e outer_connections

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    client_ip

    String

    Sim

    O endereço IP do cliente conectado à instância ou nó.

    count

    Integer

    Sim

    O número de conexões correspondentes ao endereço IP.
  • Exemplo de resposta
    {
    "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}
    ]
}

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.

Tópico principal: Gerenciamento de conexões