Todos los productos
Search
Centro de documentos

ApsaraDB for OceanBase (Deprecated):DescribeMetricsDataV2

Última actualización: Sep 02, 2026

Puede llamar a esta operación para devolver datos de métricas.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

InstanceId

string

Sí

El ID del clúster de OceanBase.

ob317v4uif****

Metrics

string

Sí

Las métricas. Separe múltiples métricas con comas (,). Ejemplo: "sql_all_count,sql_all_rt...".

sql_all_rt

StartTime

string

Sí

La hora de inicio, en formato YYYY-MM-DDThh:mm:ssZ.

2023-04-12T04:38:38Z

EndTime

string

Sí

La hora de fin, en formato YYYY-MM-DDThh:mm:ssZ.

2023-04-12T05:38:38Z

Labels

string

Sí

Una cadena de pares clave-valor separados por comas (,). Cada clave y su valor se separan con dos puntos (:). Múltiples valores de una clave se separan con punto y coma (;). Ejemplo: "clusterId:ob*****,tenantId:t******;t*******,serverId:*****,zoneId:cn-hangzhou-j". La cadena solo puede contener las siguientes claves fijas:

  • clusterId: el ID del clúster de OceanBase.

  • tenantId: el ID del inquilino de OceanBase Database.

  • zoneId: el ID de la zona.

  • serverId: el ID del nodo OBServer.

clusterId:ob***

GroupByLabels

string

Sí

Una o más claves utilizadas para la agrupación. Separe múltiples claves con comas (,). Ejemplo: "clusterId,tenantId".

clusterId

SortMetricKey

string

No

La columna de ordenamiento.

tps

SortOrder

string

No

La regla de ordenamiento. Valores válidos:

  • ASC: en orden ascendente

  • DESC: en orden descendente

DESC

Limit

string

No

La longitud del arreglo de datos devuelto después del ordenamiento.

20

ReplicaType

string

No

El tipo de réplica. Las condiciones de filtrado de nodos se configuran según el tipo de réplica cuando consulta los datos de monitoreo del clúster de OceanBase.

  • De forma predeterminada, no se especifica el tipo de réplica cuando consulta los datos de monitoreo de clústeres de OceanBase o del proxy de acceso. Si no especifica el tipo de réplica al consultar los datos de monitoreo de un clúster de OceanBase, se consultan los datos de monitoreo de todos los nodos.

  • Si establece el tipo de réplica en FULL al consultar los datos de monitoreo de un clúster de OceanBase, solo se consultan los datos de monitoreo de los nodos de réplica de funciones completas.

  • Si establece el tipo de réplica en READONLY al consultar los datos de monitoreo de un clúster de OceanBase, solo se consultan los datos de monitoreo de los nodos de réplica de solo lectura.

FULL

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El resultado devuelto de la solicitud.

RequestId

string

El ID de la solicitud.

EE205C00-30E4-****-****-87E3A8A2AA0C

Data

array<object>

Los datos devueltos.

array<object>

Los datos devueltos.

Labels

object

La etiqueta de datos.

string

Los detalles de la etiqueta.

clusterId:ob********

Data

array<object>

Los datos devueltos.

array<object>

Los datos devueltos.

MetricValue

object

Los datos de la métrica.

string

Los datos de la métrica.

'load1': 1.29

Timestamp

integer

La marca de tiempo.

1702434300

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": [
    {
      "Labels": {
        "key": "clusterId:ob********"
      },
      "Data": [
        {
          "MetricValue": {
            "key": "'load1': 1.29"
          },
          "Timestamp": 1702434300
        }
      ]
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.