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

Consulta as informações de tráfego de uma ENI secundária dentro de um intervalo de tempo especificado ao chamar DescribeEniMonitorData.

Descrição da operação

Descrição da operação\n\nAs informações de tráfego que você pode consultar sobre uma ENI secundária incluem o número de pacotes enviados e recebidos pela ENI secundária, o tráfego de rede interna de entrada e saída e o número de pacotes descartados pela ENI secundária. Se algumas informações estiverem ausentes na resposta, o sistema pode não ter conseguido obter as informações correspondentes. Por exemplo, se a instância estiver no estado Stopped ou se a ENI secundária não estiver anexada a uma instância e estiver no estado Available, as informações correspondentes não poderão ser obtidas. Ao chamar esta operação, observe os seguintes itens:\n\n- No máximo 400 entradas de dados são 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.\n\n- Você pode consultar informações de monitoramento apenas nos últimos 30 dias. O parâmetro `StartTime` especificado não pode ser anterior a 30 dias antes da hora atual.

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

get

Interface de rede.

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

*Instância.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
EniId	string	Não	O ID da ENI secundária. Por padrão, todas as ENIs secundárias anexadas à instância especificada são consultadas.	eni-bp19da36d6xdwey****
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceId	string	Sim	O ID da instância à qual a ENI secundária está anexada.	i-bp1a5zr3u7nq9cx****
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.	2018-05-21T12:19: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.	2018-05-21T12:22:00Z
Period	integer	Não	O intervalo no qual os dados de monitoramento são recuperados. Unidade: segundos. Valores válidos:\n- 60.\n- 600.\n- 3600.\n\nValor 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
TotalCount	integer	O número total de entradas retornadas.	4
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorData	object
EniMonitorData	array<object>	A coleção de dados de monitoramento do tipo EniMonitorDataType para o tráfego da ENI secundária.
	object
PacketRx	string	O número de pacotes de rede interna recebidos pela ENI secundária. Unidade: pacotes.	0
TimeStamp	string	O carimbo de data e hora dos dados de monitoramento. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ em UTC.	2018-05-21T03:22:00Z
DropPacketRx	string	O número de pacotes de rede interna descartados na recepção pela ENI secundária. Unidade: pacotes.	0
EniId	string	O ID da ENI secundária.	eni-bp19da36d6xdwey****
DropPacketTx	string	O número de pacotes de rede interna descartados na transmissão pela ENI secundária. Unidade: pacotes.	0
PacketTx	string	O número de pacotes de rede interna enviados pela ENI secundária. Unidade: pacotes.	0
IntranetTx	string	A taxa média de dados de rede interna enviados pela ENI secundária. Unidade: kB/s.	0
IntranetRx	string	A taxa média de dados de rede interna recebidos pela ENI secundária. Unidade: kB/s.	0

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 4,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "MonitorData": {
    "EniMonitorData": [
      {
        "PacketRx": "0",
        "TimeStamp": "2018-05-21T03:22:00Z",
        "DropPacketRx": "0",
        "EniId": "eni-bp19da36d6xdwey****",
        "DropPacketTx": "0",
        "PacketTx": "0",
        "IntranetTx": "0",
        "IntranetRx": "0"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidEniId.NotFound	The specified ENI ID does not exist.	A instância é inválida.
403	InvalidStartTime.Malformed	The specified parameter "StartTime" is not valid.
403	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.
403	InvalidPeriod.ValueNotSupported	The specified parameter "Period" is not valid.
403	InvalidStartTime.TooEarly	The specified parameter "StartTime" is too early.
403	InvalidParameter.TooManyDataQueried	Too many data queried.
403	Throttling	Request was denied due to request throttling.
403	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.
403	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.
4003	InvalidParam.Malformed	The specified parameter "EniId" and "InstanceId" are not valid
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	O disco especificado não existe. Verifique se o ID do disco está correto.
404	InvalidEcsId.NotFound	The specified instance ID is invalid.	A instância é inválida.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.