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

Observações de uso

Os dados de monitoramento incluem IOPS de leitura, IOPS de gravação, largura de banda de leitura (byte/s), largura de banda de gravação (byte/s), latência de leitura (μs) e latência de gravação (μs) do disco.

Observe os seguintes pontos:

É possível consultar dados de monitoramento apenas de discos no estado In Use (In_Use). Para mais informações, consulte Estados do disco.

Nota
Algumas informações podem estar ausentes nos dados de monitoramento caso o disco não esteja no estado In Use (

In_Use

), pois o sistema não consegue obter as informações relevantes.
O sistema retorna até 400 entradas de dados de monitoramento por vez. Um erro será retornado se o valor calculado pela fórmula (EndTime - StartTime)/Period for maior que 400.
A consulta abrange os últimos 30 dias. Se o valor de StartTime for anterior a 30 dias do momento atual, o sistema retornará um erro.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDiskMonitorData	A operação a ser executada. Defina o valor como DescribeDiskMonitorData.
DiskId	String	Sim	d-bp1bq5g3dxxo1x4o****	O ID do disco.
StartTime	String	Sim	2014-07-23T12:07:00Z	Início do intervalo de tempo da consulta. 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, o sistema arredondará a hora para o próximo minuto.
EndTime	String	Sim	2014-07-23T12:09:00Z	Fim do intervalo de tempo da consulta. 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, o sistema arredondará a hora para o próximo minuto.
Period	Integer	Não	60	Intervalo de coleta dos dados de monitoramento. Unidade: segundos. Valores válidos: 60 600 3600 Valor padrão: 60.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalCount	Integer	3	Número total de entradas de dados de monitoramento retornadas.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
MonitorData	Array of DiskMonitorData		Dados de monitoramento do disco.
DiskMonitorData
BPSRead	Integer	0	Largura de banda de leitura do disco do sistema. Unidade: byte/s.
IOPSRead	Integer	0	Número de IOPS de leitura no disco do sistema.
LatencyRead	Integer	0	Latência de leitura do disco. Unidade: μs.
BPSTotal	Integer	204	Largura de banda total de leitura e gravação do disco do sistema. Unidade: byte/s.
IOPSTotal	Integer	0	Número total de IOPS de leitura e gravação no disco do sistema.
TimeStamp	String	2014-07-23T12:07:00Z	Carimbo de data/hora dos dados monitorados. A hora segue o padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ, e é exibida em UTC.
LatencyWrite	Integer	0	Latência de gravação do disco. Unidade: μs.
IOPSWrite	Integer	0	Número de IOPS de gravação no disco do sistema.
DiskId	String	d-bp1bq5g3dxxo1x4o****	ID do disco.
BPSWrite	Integer	204	Largura de banda de gravação do disco do sistema. Unidade: byte/s.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-bp1bq5g3dxxo1x4o****
&EndTime=2014-07-23T12:09:00Z
&StartTime=2014-07-23T12:07:00Z
&Period=60
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDiskMonitorDataResponse>
        <MonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>0</BPSTotal>
                        <BPSWrite>0</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:07:00Z</TimeStamp>
                </DiskMonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>204</BPSTotal>
                        <BPSWrite>204</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:08:00Z</TimeStamp>
                </DiskMonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>819</BPSTotal>
                        <BPSWrite>819</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:09:00Z</TimeStamp>
                </DiskMonitorData>
        </MonitorData>
        <RequestId>BF666447-B171-4076-BCBA-48437C18FD76</RequestId>
        <TotalCount>3</TotalCount>
</DescribeDiskMonitorDataResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "MonitorData" : {
    "DiskMonitorData" : [ {
      "BPSRead" : 0,
      "BPSTotal" : 0,
      "BPSWrite" : 0,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:07:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 204,
      "BPSWrite" : 204,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:08:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 819,
      "BPSWrite" : 819,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:09:00Z"
    } ]
  },
  "RequestId" : "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  "TotalCount" : 3
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	Valor de EndTime inválido.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	Limite máximo de dados de monitoramento consultáveis excedido.
400	Throttling	Request was denied due to request throttling.	Solicitação negada devido ao limitador de taxa.
400	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	O tipo de instância não oferece suporte a instâncias com capacidade de burst.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	A hora de término especificada é anterior à hora de início.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	Disco especificado não encontrado. Verifique se o ID do disco é válido.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.