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

Observações de uso

Atente-se aos seguintes pontos:

O sistema retorna no máximo 400 entradas de dados de monitoramento por vez. Ocorrerá um erro se o resultado da fórmula (EndTime − StartTime)/Period for maior que 400.
É possível consultar dados dos últimos 30 dias. Caso o valor do parâmetro StartTime seja anterior a 30 dias da data atual, o sistema retornará um erro.
Em certos cenários, como quando a instância está no estado Stopped, o sistema não consegue obter as informações relevantes. Nesse caso, parte dos dados de monitoramento retornados pode estar ausente.
Não é possível obter o monitoramento básico de CPU de uma instância bare metal do ECS. Para obter essas informações, instale o agente do CloudMonitor. Para mais detalhes, consulte Instalar o CloudMonitor.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeInstanceMonitorData	A operação a ser executada. Defina o valor como DescribeInstanceMonitorData.
InstanceId	String	Sim	i-bp1a36962lrhj4ab****	O ID da instância.
StartTime	String	Sim	2014-10-29T23:00:00Z	Início do intervalo de tempo a ser consultado. 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 horário será arredondado para o próximo minuto.
EndTime	String	Sim	2014-10-30T08:00:00Z	Fim do intervalo de tempo a ser consultado. 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 horário será arredondado para o próximo minuto.
Period	Integer	Não	60	Intervalo para recuperação 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
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
MonitorData	Array of InstanceMonitorData		Dados de monitoramento da instância.
InstanceMonitorData
CPUCreditBalance	Float	120	Total de créditos de CPU da instância burstable.
BPSRead	Integer	1000	Largura de banda de leitura dos discos (disco do sistema e discos de dados). Unidade: Byte/s.
InternetTX	Integer	343	Volume de tráfego de dados enviado pela instância para a Internet durante o período especificado pelo parâmetro Period, a partir do horário definido pelo parâmetro TimeStamp. Unidade: Kbit.
CPU	Integer	2	Utilização de vCPU da instância. Unidade: porcentagem (%).
CPUCreditUsage	Float	30	Quantidade de créditos de CPU consumidos pela instância burstable.
IOPSWrite	Integer	200	Número de operações de E/S de escrita por segundo nos discos (disco do sistema e discos de dados).
IntranetTX	Integer	343	Volume de tráfego de dados enviado pela instância para a rede interna durante o período especificado pelo parâmetro Period, a partir do horário definido pelo parâmetro TimeStamp. Unidade: Kbit.
InstanceId	String	i-bp1a36962lrhj4****	O ID da instância.
BPSWrite	Integer	13585	Largura de banda de escrita dos discos (disco do sistema e discos de dados). Unidade: Byte/s.
CPUNotpaidSurplusCreditUsage	Float	0,5	Créditos de CPU excedentes não pagos.
CPUAdvanceCreditBalance	Float	0,4	Créditos de CPU antecipados (excedentes) da instância burstable.
IOPSRead	Integer	1000	Número de operações de E/S de leitura por segundo nos discos (disco do sistema e discos de dados).
InternetBandwidth	Integer	10	Largura de banda pública da instância. Unidade: Kbit/s.
InternetRX	Integer	122	Volume de tráfego de dados recebido pela instância da Internet durante o período especificado pelo parâmetro Period, a partir do horário definido pelo parâmetro TimeStamp. Unidade: Kbit.
TimeStamp	String	2014-10-30T05:00:00Z	Carimbo de data/hora em que os dados de monitoramento foram consultados.
IntranetRX	Integer	122	Volume de tráfego de dados recebido pela instância da rede interna durante o período especificado pelo parâmetro Period, a partir do horário definido pelo parâmetro TimeStamp. Unidade: Kbit.
IntranetBandwidth	Integer	10	Largura de banda interna da instância. Unidade: Kbit/s.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
&EndTime=2014-10-30T08:00:00Z
&InstanceId=i-bp1a36962lrhj4ab****
&StartTime=2014-10-29T23:00:00Z
&Period=3600
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeInstanceMonitorDataResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <MonitorData>
        <InstanceMonitorData>
            <InstanceId>i-bp1a36962lrhj4ab****</InstanceId>
            <CPU>2</CPU>
            <IntranetRX>122</IntranetRX>
            <IntranetTX>343</IntranetTX>
            <IntranetFlow>675</IntranetFlow>
            <IntranetBandwidth>10</IntranetBandwidth>
            <InternetRX>122</InternetRX>
            <InternetTX>343</InternetTX>
            <InternetFlow>675</InternetFlow>
            <InternetBandwidth>10</InternetBandwidth>
            <IOPSRead>1000</IOPSRead>
            <IOPSWrite>200</IOPSWrite>
            <BPSRead>1000</BPSRead>
            <BPSWrite>13585</BPSWrite>
            <TimeStamp>2014-10-30T05:00:00Z</TimeStamp>
        </InstanceMonitorData>
    </MonitorData>
</DescribeInstanceMonitorDataResponse>

Formato JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "MonitorData" : {
    "InstanceMonitorData" : [ {
      "InstanceId" : "i-bp1a36962lrhj4ab****",
      "CPU" : 0,
      "IntranetRX" : 122,
      "IntranetTX" : 343,
      "IntranetFlow" : 675,
      "IntranetBandwidth" : 10,
      "InternetRX" : 122,
      "InternetTX" : 343,
      "InternetFlow" : 675,
      "InternetBandwidth" : 10,
      "IOPSRead" : 1000,
      "IOPSWrite" : 13585,
      "BPSRead" : 1000,
      "BPSWrite" : 200,
      "TimeStamp" : "2014-10-30T05:00:00Z"
    } ]
  }
}

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 inválido para EndTime.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	O volume máximo de dados de monitoramento consultáveis foi excedido.
400	Throttling	Request was denied due to request throttling.	Solicitação negada devido ao limitador de taxa (throttling).
400	InvalidStartTime.ValueNotSupported	The specified parameter StartTime is later than EndTime.	O horário final não pode ser anterior ao horário inicial.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	O ID da instância não foi encontrado.

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