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/Distributed Cache Service/Referencia de la API/API V2/Shards y réplicas/Consulta de detalles de Shards
Actualización más reciente 2022-11-09 GMT+08:00
Ver PDF
Compartir

Consulta de detalles de Shards

Función

Esta API se utiliza para consultar fragmentos y réplicas de instancias de clúster.

URI

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

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto.

instance_id

Sí

String

ID de instancia.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

Tabla 2 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

group_list

Array of InstanceGroupListInfo objects

Lista de Shard

group_count

Integer

Número total de shards en la instancia.

Tabla 3 InstanceGroupListInfo

Parámetro

Tipo

Descripción

group_id

String

ID de shard.

group_name

String

Nombre del shard.

replication_list

Array of InstanceReplicationListInfo objects

Lista de réplicas en el shard.

Tabla 4 InstanceReplicationListInfo

Parámetro

Tipo

Descripción

replication_role

String

Rol de la réplica. Opciones:

  • master: principal
  • slave: réplica

replication_ip

String

Dirección IP de réplica.

is_replication

Boolean

Si la réplica es una recién agregada

replication_id

String

ID de la réplica.

node_id

String

ID del nodo.

status

String

Estado de la réplica.

Valores de enumeración:

  • Active
  • Inactive

az_code

String

zona de disponibilidad donde está la réplica.

dimensions

Array of InstanceReplicationDimensionsInfo objects

Dimensión de la métrica de monitoreo de la réplica utilizada para llamar a la API de Cloud Eye para consultar métricas de monitoreo.

  • El monitoreo de réplicas es multidimensional. La matriz devuelta contiene información acerca de dos dimensiones. Al consultar datos de monitorización desde Cloud Eye, transfiera parámetros de varias dimensiones para obtener los datos métricos.
  • La primera dimensión es la dimensión principal de la réplica. El nombre de la dimensión es dcs_instance_id y el valor de la dimensión corresponde al ID de la instancia a la que pertenece la réplica.
  • El nombre de la segunda dimensión es dcs_cluster_redis_node, y el valor de dimensión es el ID de objeto monitoreado de la réplica, que es diferente del ID de réplica o del ID de nodo.
Tabla 5 InstanceReplicationDimensionsInfo

Parámetro

Tipo

Descripción

name

String

Monitoreo de nombre de dimensión

value

String

Valor de la dimensión.

Código de estado: 500

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_msg

String

Mensaje de error.

Máximo: 1024

error_code

String

Código de error.

Máximo: 9

error_ext_msg

String

Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null.

Máximo: 1024

Código de estado: 400

Tabla 7 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_msg

String

Mensaje de error.

Máximo: 1024

error_code

String

Código de error.

Máximo: 9

error_ext_msg

String

Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null.

Máximo: 1024

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

Detalles de shards y réplicas consultadas con éxito.

{
  "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 estado

Código de estado

Descripción

200

Detalles de shards y réplicas consultadas con éxito.

500

Error interno del servicio.

400

Solicitud no válida.

Códigos de error

Consulte Códigos de error.

Tema principal:Shards y réplicas