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> Distributed Cache Service> Referência de API> API V2> Partições e réplicas> Consulta de detalhes de partições

Atualizado em 2022-11-09 GMT+08:00

Ver PDF

Consulta de detalhes de partições

Função

Essa API é usada para consultar fragmentos e réplicas de instâncias de cluster.

URI

GET /v2/{project_id}/instance/{instance_id}/groups

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto.
instance_id	Sim	String	ID da instância.

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de estado: 200

**Tabela 2** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
group_list	Array of InstanceGroupListInfo objects	Lista de partição.
group_count	Integer	Número total de partições na instância.

**Tabela 3** InstanceGroupListInfo
Parâmetro	Tipo	Descrição
group_id	String	ID do partição.
group_name	String	Nome do partição.
replication_list	Array of InstanceReplicationListInfo objects	Lista de réplicas no estilhaço.

**Tabela 4** InstanceReplicationListInfo
Parâmetro	Tipo	Descrição
replication_role	String	O papel da réplica. Opções: master: principal slave: réplica
replication_ip	String	Endereço IP da réplica.
is_replication	Boolean	Se a réplica é um recém-adicionado.
replication_id	String	ID da réplica.
node_id	String	ID do nó.
status	String	Status da réplica. Valores de enumeração: Active Inactive
az_code	String	AZ onde está a réplica.
dimensions	Array of InstanceReplicationDimensionsInfo objects	Dimensão de métrica de monitoramento da réplica usada para chamar a API Cloud Eye para consultar métricas de monitoramento. O monitoramento de réplicas é multidimensional. O array retornado contém informações sobre duas dimensões. Ao consultar dados de monitoramento do Cloud Eye, transfira parâmetros de várias dimensões para obter os dados da métrica. A primeira dimensão é a dimensão primária da réplica. O nome da dimensão é dcs_instance_id e o valor da dimensão corresponde ao ID da instância à qual a réplica pertence. O nome da segunda dimensão é dcs_cluster_redis_node, e o valor da dimensão é o ID do objeto monitorado da réplica, que é diferente do ID da réplica ou do nó.

**Tabela 5** InstanceReplicationDimensionsInfo
Parâmetro	Tipo	Descrição
name	String	Monitorando o nome da dimensão.
value	String	Valor da dimensão.

Código de estado: 500

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 400

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Exemplos de solicitações

GET https://{dcs_endpoint}/v2/{project_id}/instance/{instance_id}/groups

Exemplo de respostas

Código de estado: 200

Detalhes de partições e réplicas consultados com sucesso.

{
  "group_list" : [ {
    "group_id" : "35e1bed6-7de5-4898-9eb2-c362c783df15",
    "group_name" : "group-0",
    "replication_list" : [ {
      "az_code" : "xxxxxx",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cda0002d",
      "replication_id" : "dfbd3f84-08bc-42f0-b538-01d03e6dc178",
      "replication_ip" : "192.168.76.25",
      "replication_role" : "master",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6200"
      } ]
    }, {
      "az_code" : "cn-north-4b",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cdb0002e",
      "replication_id" : "63d4c880-7050-464f-ab19-c8a297474d7d",
      "replication_ip" : "192.168.78.207",
      "replication_role" : "slave",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6201"
      } ]
    } ]
  }, {
    "group_id" : "579a281f-6e63-4822-b0c7-e45c44b7c807",
    "group_name" : "group-1",
    "replication_list" : [ {
      "az_code" : "cn-north-4b",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cdbd002f",
      "replication_id" : "6284c192-48d1-462b-8fd9-45dad067c1a2",
      "replication_ip" : "192.168.73.164",
      "replication_role" : "master",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6202"
      } ]
    }, {
      "az_code" : "xxxxxx",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cdc80030",
      "replication_id" : "b927de3b-42f3-45b5-b0e4-8547f0ef6727",
      "replication_ip" : "192.168.77.172",
      "replication_role" : "slave",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6203"
      } ]
    } ]
  }, {
    "group_id" : "c17305c6-6651-42d9-86bf-5a6087076eb7",
    "group_name" : "group-2",
    "replication_list" : [ {
      "az_code" : "xxxxxx",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cdd90031",
      "replication_id" : "caa6636d-a5c1-43b8-990a-3dc134da4522",
      "replication_ip" : "192.168.76.143",
      "replication_role" : "master",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6204"
      } ]
    }, {
      "az_code" : "xxxxxx",
      "is_replication" : false,
      "node_id" : "8abfa7aa73291f15017329e1cde50032",
      "replication_id" : "4f46790d-a0b0-4a1b-aa02-1c554fccf62d",
      "replication_ip" : "192.168.72.66",
      "replication_role" : "slave",
      "status" : "Active",
      "dimensions" : [ {
        "name" : "dcs_instance_id",
        "value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
      }, {
        "name" : "dcs_cluster_redis_node",
        "value" : "8263dc69629c5b2d840e9816fa9c6205"
      } ]
    } ]
  } ],
  "group_count" : 3
}