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

Consulta os dados de monitoramento de uma instância ECS. As métricas que podem ser consultadas incluem a utilização de vCPU, os créditos de instância burstable, o tráfego de dados de entrada, o tráfego de dados de saída e a largura de banda média da instância ECS.

Descrição da operação

Observe os seguintes itens ao chamar esta operação:

No máximo 400 entradas de dados podem ser retornadas por vez. Certifique-se de que o valor de (EndTime – StartTime)/Period seja menor ou igual a 400. Em outras palavras, 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 dados de monitoramento dos últimos 30 dias. O valor do parâmetro StartTime não pode ser superior a 30 dias antes da data atual.
Se algum conteúdo estiver ausente na resposta, o sistema pode não ter obtido as informações correspondentes. Por exemplo, a instância estava no estado Stopped naquele momento.
Esta operação não pode recuperar os dados básicos de monitoramento de CPU de instâncias ECS Bare Metal. Você pode instalar o agente do CloudMonitor para obter dados de monitoramento de CPU. Para mais informações, consulte Instalar o agente do CloudMonitor.

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:DescribeInstanceMonitorData

get

*Instância.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância a ser consultada.	i-bp1a36962lrhj4ab****
StartTime	string	Sim	O 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`, a hora será automaticamente arredondada para o próximo minuto.	2014-10-29T23:00:00Z
EndTime	string	Sim	O 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`, a hora será automaticamente arredondada para o próximo minuto.	2014-10-30T08:00:00Z
Period	integer	Não	O intervalo no qual recuperar os dados de monitoramento. Unidade: segundos. Valores válidos: Valor padrão: 60. Valores válidos: 60 : 60 segundos. 600 : 600 segundos. 3600 : 3600 segundos.	60

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorData	object
InstanceMonitorData	array<object>	A coleção de dados de monitoramento da instância.
	object
CPUCreditBalance	number	O número total de créditos de instância burstable.	120
BPSRead	integer	A largura de banda de leitura dos discos da instância (incluindo o disco do sistema e os discos de dados). Unidade: bytes/s.	1000
InternetTX	integer	O tráfego de dados de saída público enviado pela instância durante o intervalo especificado (`Period`) no momento da consulta (`TimeStamp`). Unidade: kbits.	343
CPU	integer	A utilização de vCPU da instância. Unidade: porcentagem (%).	2
CPUCreditUsage	number	O número de créditos de instância burstable consumidos.	30
IOPSWrite	integer	As operações de gravação de E/S nos discos da instância (incluindo o disco do sistema e os discos de dados). Unidade: operações/s.	200
IntranetTX	integer	O tráfego de dados de saída interno enviado pela instância durante o intervalo especificado (`Period`) no momento da consulta (`TimeStamp`). Unidade: kbits.	343
InstanceId	string	O ID da instância.	i-bp1a36962lrhj4****
BPSWrite	integer	A largura de banda de gravação dos discos da instância (incluindo o disco do sistema e os discos de dados). Unidade: bytes/s.	13585
CPUNotpaidSurplusCreditUsage	number	Os créditos de CPU excedidos não pagos.	0.5
CPUAdvanceCreditBalance	number	Os créditos de CPU excedidos (a parte dos créditos de instância burstable que excede o limite).	0.4
IOPSRead	integer	As operações de leitura de E/S nos discos da instância (incluindo o disco do sistema e os discos de dados). Unidade: operações/s.	1000
InternetBandwidth	integer	A largura de banda pública da instância, que é o tráfego de rede por unidade de tempo. Unidade: kbits/s.	10
InternetRX	integer	O tráfego de dados de entrada público recebido pela instância durante o intervalo especificado (`Period`) no momento da consulta (`TimeStamp`). Unidade: kbits.	122
TimeStamp	string	O timestamp dos dados de monitoramento.	2014-10-30T05:00:00Z
IntranetRX	integer	O tráfego de dados de entrada interno recebido pela instância durante o intervalo especificado (`Period`) no momento da consulta (`TimeStamp`). Unidade: kbits.	122
IntranetBandwidth	integer	A largura de banda interna da instância, que é o tráfego de rede por unidade de tempo. Unidade: kbits/s.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "MonitorData": {
    "InstanceMonitorData": [
      {
        "CPUCreditBalance": 120,
        "BPSRead": 1000,
        "InternetTX": 343,
        "CPU": 2,
        "CPUCreditUsage": 30,
        "IOPSWrite": 200,
        "IntranetTX": 343,
        "InstanceId": "i-bp1a36962lrhj4****",
        "BPSWrite": 13585,
        "CPUNotpaidSurplusCreditUsage": 0.5,
        "CPUAdvanceCreditBalance": 0.4,
        "IOPSRead": 1000,
        "InternetBandwidth": 10,
        "InternetRX": 122,
        "TimeStamp": "2014-10-30T05:00:00Z",
        "IntranetRX": 122,
        "IntranetBandwidth": 10
      }
    ]
  }
}

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.	O formato da hora de início especificada é inválido.
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	O formato de hora de término especificado é inválido.
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.	O nó de dados de monitoramento está fora do intervalo.
400	Throttling	Request was denied due to request throttling.	A solicitação foi limitada.
400	InvalidStartTime.ValueNotSupported	The specified parameter StartTime is later than EndTime.	A hora de início especificada não está dentro do intervalo permitido.
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.