DescribeDBInstancePerformance - PolarDB - Centro de documentación de Alibaba Cloud

Consulta los datos de monitoreo de rendimiento de un nodo de cómputo.

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

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:DescribeDBInstancePerformance

get

*DBCluster

acs:polardb:*:{#accountId}:{#resource-type}/{#resource-id}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBInstanceId	string	Sí	El ID del nodo.	pi-*************
Key	string	No	Las métricas de rendimiento. Separe múltiples métricas con comas (,). Para obtener más información, consulte Parámetros de rendimiento.	PolarDBCPUForPCU,PolarDBPCU,PolarDBMemoryForPCU,PolarDBQPSTPS,PolarDBConnections
StartTime	string	Sí	La hora de inicio de la consulta. La hora está en formato yyyy-MM-ddTHH:mmZ en UTC.	2022-11-15T16:00Z
EndTime	string	Sí	La hora de fin de la consulta. La hora está en formato yyyy-MM-ddTHH:mmZ en UTC.	2020-01-15T17:00Z

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La lista de datos de monitoreo del nodo de cómputo.
PerformanceKeys	object
PerformanceItem	array<object>	La lista de datos de monitoreo del nodo de cómputo.
	array<object>	Los datos de monitoreo del nodo de cómputo.
MetricName	string	El nombre de la métrica de rendimiento.	mean_data_size
Measurement	string	La métrica de rendimiento.	PolarDBDiskUsage
Points	object
PerformanceItemValue	array<object>	La lista de parámetros de rendimiento del nodo de cómputo.
	object
Value	string	El valor del parámetro de rendimiento del nodo de cómputo.	12.33
Timestamp	integer	El momento en que se recopiló la métrica de monitoreo. El valor es una marca de tiempo UNIX. Unidad: milisegundos (ms).	1737424822
DBVersion	string	El número de versión de MySQL. Valores válidos: 5.6 5.7 8.0	5.6
EndTime	string	La hora de fin de la consulta. La hora está en formato `yyyy-MM-ddTHH:mmZ` en UTC.	2020-09-23T01:01Z
RequestId	string	El ID de la solicitud.	F2A9EFA7-915F-4572-8299-85A307******
DBInstanceId	string	El ID del nodo.	pi-*************
StartTime	string	La hora de inicio de la consulta. La hora está en formato `yyyy-MM-ddTHH:mmZ` en UTC.	2020-09-23T01:01Z
DBType	string	El tipo de motor de base de datos. Valores válidos: MySQL PostgreSQL Oracle	MySQL
Engine	string	El tipo de motor de base de datos.	POLARDB

Ejemplos

Respuesta exitosa

JSON Formato

{
  "PerformanceKeys": {
    "PerformanceItem": [
      {
        "MetricName": "mean_data_size",
        "Measurement": "PolarDBDiskUsage",
        "Points": {
          "PerformanceItemValue": [
            {
              "Value": "12.33",
              "Timestamp": 1737424822
            }
          ]
        }
      }
    ]
  },
  "DBVersion": "5.6",
  "EndTime": "2020-09-23T01:01Z",
  "RequestId": "F2A9EFA7-915F-4572-8299-85A307******",
  "DBInstanceId": "pi-*************",
  "StartTime": "2020-09-23T01:01Z",
  "DBType": "MySQL",
  "Engine": "POLARDB"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	InvalidKey.Malformed	The specified parameter Key is not valid.
400	InvalidEndTime.Malformed	The specified parameter EndTime is not valid.
400	InvalidStartTime.Malformed	The specified parameter StartTime is not valid.
400	InvalidParameterCombination	The end time must be greater than the start time.
404	InvalidDBNodeId.NotFound	The DBNodeId provided does not exist in our records.

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.