DescribeDiskMonitorData - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta la información de uso de un disco durante un período especificado, como IOPS de lectura, IOPS de escritura, ancho de banda de lectura (B/s), ancho de banda de escritura (B/s), latencia de lectura (μs) y latencia de escritura (μs).

Descripción de la operación

Al llamar a esta operación, tenga en cuenta los siguientes límites:

Solo puede consultar la información de uso de discos que se encuentran en estado En uso (In_use). Para obtener más información, consulte Estados del disco.

Nota
Si la información devuelta tiene contenido faltante, el disco no estaba en estado En uso (In_use) durante ese período y no es posible obtener la información de uso.
Se pueden devolver hasta 400 entradas de datos a la vez. El valor de (EndTime – StartTime) / Period debe ser menor o igual a 400. Es decir, el valor del parámetro de respuesta TotalCount no puede exceder 400. De lo contrario, se devuelve el error InvalidParameter.TooManyDataQueried.
Puede consultar la información de monitoreo de hasta los últimos 30 días. El parámetro StartTime especificado no puede ser anterior a 30 días respecto a la hora actual.

Ejemplo de solicitud

Suponga que desea consultar la información de uso de un disco cuyo ID es d-bp14emm68wx98vjk**** en la región China (Hangzhou) desde 2025-02-17T00:00:00Z hasta 2025-02-18T10:00:00Z con intervalos de 600 segundos. Configure los parámetros de la solicitud de la siguiente manera:

RegionId:"cn-hangzhou", // Establecer la región China (Hangzhou)
DiskId:"d-bp14emm68wx98vjk****", // Establecer el ID del disco
StartTime:"2025-02-15T00:00:00Z", // Establecer la hora de inicio de la consulta
EndTime:"2025-02-17T00:00:00Z", // Establecer la hora de fin de la consulta
Period:"600", // Establecer la granularidad de los datos

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

ecs:DescribeDiskMonitorData

get

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DiskId	string	Sí	El ID del disco que se va a consultar.	d-bp1bq5g3dxxo1x4o****
StartTime	string	Sí	La hora de inicio de los datos. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Si el valor de los segundos (ss) no es 00, la hora de inicio se ajusta automáticamente al inicio del siguiente minuto. Nota Puede consultar la información de monitoreo de hasta los últimos 30 días. El parámetro `StartTime` no puede ser anterior a 30 días respecto a la hora actual.	2014-07-23T12:07:00Z
EndTime	string	Sí	La hora de fin de los datos. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Si el valor de los segundos (ss) no es 00, la hora de fin se ajusta automáticamente al inicio del siguiente minuto.	2014-07-23T12:09:00Z
Period	integer	No	La granularidad de los datos. Unidad: segundos. Valores válidos: Valor predeterminado: 60. Nota El valor de (EndTime – StartTime) / Period debe ser menor o igual a 400. Se pueden devolver hasta 400 entradas de datos a la vez.	60

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
TotalCount	integer	El número de entradas devueltas para la información de uso del disco, que corresponde al número de períodos.	3
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorData	object
DiskMonitorData	array<object>	La colección de datos de monitoreo del disco.
	object	La colección de datos de monitoreo del disco.
BPSRead	integer	El ancho de banda de lectura del disco. Unidad: byte/s.	0
IOPSRead	integer	El número de operaciones de E/S de lectura por segundo en el disco. Unidad: operaciones/s.	0
LatencyRead	integer	La latencia de lectura del disco. Unidad: μs (microsegundos).	0
BPSTotal	integer	El ancho de banda total de lectura y escritura del disco. Unidad: byte/s.	204
IOPSTotal	integer	El número total de operaciones de E/S de lectura y escritura por segundo en el disco. Unidad: operaciones/s.	0
TimeStamp	string	La marca de tiempo de los datos de monitoreo. La hora sigue el estándar ISO 8601 y se muestra en UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.	2014-07-23T12:07:00Z
LatencyWrite	integer	La latencia de escritura del disco. Unidad: μs (microsegundos).	0
IOPSWrite	integer	El número de operaciones de E/S de escritura por segundo en el disco. Unidad: operaciones/s.	0
DiskId	string	El ID del disco.	d-bp1bq5g3dxxo1x4o****
BPSWrite	integer	El ancho de banda de escritura del disco. Unidad: byte/s.	204

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalCount": 3,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "MonitorData": {
    "DiskMonitorData": [
      {
        "BPSRead": 0,
        "IOPSRead": 0,
        "LatencyRead": 0,
        "BPSTotal": 204,
        "IOPSTotal": 0,
        "TimeStamp": "2014-07-23T12:07:00Z",
        "LatencyWrite": 0,
        "IOPSWrite": 0,
        "DiskId": "d-bp1bq5g3dxxo1x4o****",
        "BPSWrite": 204
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidStartTime.Malformed	The specified parameter "StartTime" is not valid.	The specified StartTime parameter does not conform to the specification.
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	The specified EndTime parameter is invalid.
400	InvalidPeriod.ValueNotSupported	The specified parameter "Period" is not valid.
400	InvalidStartTime.TooEarly	The specified parameter "StartTime" is too early.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	The monitoring data node is out of range.
400	Throttling	Request was denied due to request throttling.	The request is throttled. Use the NextToken-based pagination method instead of the PageNumber-based pagination method.
400	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	The instance type does not support burstable instances.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	The end time cannot be earlier than the start time.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	The specified disk does not exist. Check whether the disk ID is correct.

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.