DescribeDiskMonitorData - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta as informações de uso de um disco em um período especificado, como IOPS de leitura, IOPS de gravação, largura de banda de leitura (B/s), largura de banda de gravação (B/s), latência de leitura (μs) e latência de gravação (μs).

Descrição da operação

Ao chamar esta operação, observe os seguintes limites:

Você pode consultar apenas as informações de uso de discos que estão no estado Em uso (In_use). Para obter mais informações, consulte Estados do disco.

Nota
Se as informações retornadas tiverem conteúdo ausente, o disco não estava no estado Em uso (In_use) durante esse período e as informações de uso não podem ser obtidas.
Um máximo de 400 entradas de dados pode ser retornado por vez. O valor de (EndTime – StartTime) / Period deve ser menor ou igual a 400. Ou seja, o valor do parâmetro de resposta TotalCount não pode exceder 400. Caso contrário, o erro InvalidParameter.TooManyDataQueried será retornado.
Você pode consultar as informações de monitoramento de até os últimos 30 dias. O parâmetro StartTime especificado não pode ser anterior a 30 dias em relação à hora atual.

Exemplo de solicitação

Suponha que você queira consultar as informações de uso de um disco cujo ID é d-bp14emm68wx98vjk**** na região China (Hangzhou) de 2025-02-17T00:00:00Z a 2025-02-18T10:00:00Z em intervalos de 600 segundos. Configure os parâmetros da solicitação da seguinte forma:

RegionId:"cn-hangzhou", // Define a região China (Hangzhou)
DiskId:"d-bp14emm68wx98vjk****", // Define o ID do disco
StartTime:"2025-02-15T00:00:00Z", // Define a hora de início da consulta
EndTime:"2025-02-17T00:00:00Z", // Define a hora de término da consulta
Period:"600", // Define a granularidade dos dados
```.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeDiskMonitorData

get

*Disk

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DiskId	string	Sim	O ID do disco a ser consultado.	d-bp1bq5g3dxxo1x4o****
StartTime	string	Sim	A hora de início dos dados. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Se o valor dos segundos (ss) não for 00, a hora de início será automaticamente definida para o início do próximo minuto. Nota Você pode consultar as informações de monitoramento de até os últimos 30 dias. O parâmetro `StartTime` não pode ser anterior a 30 dias em relação à hora atual.	2014-07-23T12:07:00Z
EndTime	string	Sim	A hora de término dos dados. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Se o valor dos segundos (ss) não for 00, a hora de término será automaticamente definida para o início do próximo minuto.	2014-07-23T12:09:00Z
Period	integer	Não	A granularidade dos dados. Unidade: segundos. Valores válidos: Valor padrão: 60. Nota O valor de (EndTime – StartTime) / Period deve ser menor ou igual a 400. Um máximo de 400 entradas de dados pode ser retornado por vez.	60

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número de entradas retornadas para as informações de uso do disco, que corresponde ao número de períodos.	3
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorData	object
DiskMonitorData	array<object>	A coleção de dados de monitoramento do disco.
	object	A coleção de dados de monitoramento do disco.
BPSRead	integer	The read bandwidth of the disk. Unit: byte/s.	0
IOPSRead	integer	The number of read I/O operations per second on the disk. Unit: operations/s.	0
LatencyRead	integer	The read latency of the disk. Unit: μs (microseconds).	0
BPSTotal	integer	The total read and write bandwidth of the disk. Unit: byte/s.	204
IOPSTotal	integer	The total number of read and write I/O operations per second on the disk. Unit: operations/s.	0
TimeStamp	string	The timestamp of the monitoring data. The time follows the ISO 8601 standard and is displayed in UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2014-07-23T12:07:00Z
LatencyWrite	integer	The write latency of the disk. Unit: μs (microseconds).	0
IOPSWrite	integer	The number of write I/O operations per second on the disk. Unit: operations/s.	0
DiskId	string	The disk ID.	d-bp1bq5g3dxxo1x4o****
BPSWrite	integer	The write bandwidth of the disk. Unit: byte/s.	204

Exemplos

Resposta de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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.
400	Throttling	Request was denied due to request throttling.
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 some unknown error, exception or failure.	An internal error has occurred. Try again later.
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.