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
| 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
| 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. |
| 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. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| replication_role | String | O papel da réplica. Opções:
|
| 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:
|
| 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.
|
| Parâmetro | Tipo | Descrição |
|---|---|---|
| name | String | Monitorando o nome da dimensão. |
| value | String | Valor da dimensão. |
Código de estado: 500
| 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
| 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
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | Detalhes de partições e réplicas consultados com sucesso. |
| 500 | Erro de serviço interno. |
| 400 | Pedido inválido. |
Códigos de erro
Consulte Códigos de erro.