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

Observações de uso

Os dados de monitoramento incluem o tráfego enviado e recebido pela rede interna, a quantidade de pacotes enviados e recebidos pela ENI secundária e o número de pacotes descartados (enviados e recebidos) por essa interface. Algumas informações podem estar ausentes nos dados retornados caso o sistema não consiga obtê-las. Por exemplo, se a instância vinculada à ENI secundária estiver no estado Stopped, ou se a ENI secundária não estiver vinculada a nenhuma instância e estiver no estado Available, não será possível obter os dados de monitoramento. Observe os seguintes pontos:

O sistema retorna até 400 entradas de dados de monitoramento por vez. Se o resultado da fórmula (EndTime - StartTime)/Period for maior que 400, o sistema retornará um erro.
A consulta abrange apenas os dados de monitoramento dos últimos 30 dias. Caso o valor de StartTime seja anterior a 30 dias contados a partir do momento da chamada desta operação, o sistema retornará um erro.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeEniMonitorData	A operação a ser executada. Defina o valor como DescribeEniMonitorData.
EniId	String	No	eni-bp19da36d6xdwey****	ID da ENI secundária. Por padrão, o sistema consulta todas as ENIs secundárias vinculadas à instância especificada.
RegionId	String	Yes	cn-hangzhou	ID da região da ENI secundária. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
InstanceId	String	Yes	i-bp1a5zr3u7nq9cx****	ID da instância à qual a ENI secundária está vinculada.
StartTime	String	Yes	2018-05-21T12:19: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 sistema arredondará a hora para cima até o próximo minuto.
EndTime	String	Yes	2018-05-21T12:22: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 sistema arredondará a hora para cima até o próximo minuto.
Period	Integer	No	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

Parameter	Type	Example	Description
TotalCount	Integer	4	Número total de entradas retornadas.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
MonitorData	Array of EniMonitorData		Dados de monitoramento da ENI secundária.
EniMonitorData
PacketRx	String	0	Quantidade de pacotes recebidos pela ENI secundária na rede interna.
TimeStamp	String	2018-05-21T03:22:00Z	Carimbo de data/hora dos dados de monitoramento. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibida em UTC.
DropPacketRx	String	0	Quantidade de pacotes descartados recebidos pela ENI secundária na rede interna.
EniId	String	eni-bp19da36d6xdwey****	ID da ENI secundária.
DropPacketTx	String	0	Quantidade de pacotes descartados enviados pela ENI secundária na rede interna.
PacketTx	String	0	Quantidade de pacotes enviados pela ENI secundária na rede interna.
IntranetTx	String	0	Taxa média de envio de dados pela ENI secundária na rede interna. Unidade: KB/s.
IntranetRx	String	0	Taxa média de recebimento de dados pela ENI secundária na rede interna. Unidade: KB/s.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeEniMonitorData
&EndTime=2018-05-21T12:22:00Z
&InstanceId=i-bp1a5zr3u7nq9cx****
&RegionId=cn-hangzhou
&StartTime=2018-05-21T12:19:00Z
&EniId=eni-bp19da36d6xdwey****
&Period=60
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeEniMonitorDataResponse>
    <RequestId>5A03C2BA-3BCE-4A87-8076-7DC1629</RequestId>
    <MonitorData>
        <EniMonitorData>
            <PacketTx>0</PacketTx>
            <TimeStamp>2018-05-21T03:22:00Z</TimeStamp>
            <IntranetOut>0</IntranetOut>
            <DropPacketRx>0</DropPacketRx>
            <IntranetIn>0</IntranetIn>
            <EniId>eni-bp19da36d6xdwey4****</EniId>
            <DropPacketTx>0</DropPacketTx>
            <PacketRx>0</PacketRx>
        </EniMonitorData>
        <EniMonitorData>
            <PacketTx>0</PacketTx>
            <TimeStamp>2018-05-21T03:21:00Z</TimeStamp>
            <IntranetOut>0</IntranetOut>
            <DropPacketRx>0</DropPacketRx>
            <IntranetIn>0</IntranetIn>
            <EniId>eni-bp19da36d6xdwey3****</EniId>
            <DropPacketTx>0</DropPacketTx>
            <PacketRx>0</PacketRx>
        </EniMonitorData>
        <EniMonitorData>
            <PacketTx>52240</PacketTx>
            <TimeStamp>2018-05-21T03:19:00Z</TimeStamp>
            <IntranetOut>73344</IntranetOut>
            <DropPacketRx>0</DropPacketRx>
            <IntranetIn>467</IntranetIn>
            <EniId>eni-bp19da36d6xdwey2****</EniId>
            <DropPacketTx>0</DropPacketTx>
            <PacketRx>6603</PacketRx>
        </EniMonitorData>
        <EniMonitorData>
            <PacketTx>34925</PacketTx>
            <TimeStamp>2018-05-21T03:20:00Z</TimeStamp>
            <IntranetOut>48871</IntranetOut>
            <DropPacketRx>0</DropPacketRx>
            <IntranetIn>350</IntranetIn>
            <EniId>eni-bp19da36d6xdwey1****</EniId>
            <DropPacketTx>0</DropPacketTx>
            <PacketRx>4888</PacketRx>
        </EniMonitorData>
    </MonitorData>
</DescribeEniMonitorDataResponse>

Formato JSON

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

{
  "RequestId" : "5A03C2BA-3BCE-4A87-8076-7DC1629",
  "MonitorData" : {
    "EniMonitorData" : [ {
      "PacketTx" : 0,
      "TimeStamp" : "2018-05-21T03:22:00Z",
      "IntranetOut" : 0,
      "DropPacketRx" : 0,
      "IntranetIn" : 0,
      "EniId" : "eni-bp19da36d6xdwey4****",
      "DropPacketTx" : 0,
      "PacketRx" : 0
    }, {
      "PacketTx" : 0,
      "TimeStamp" : "2018-05-21T03:21:00Z",
      "IntranetOut" : 0,
      "DropPacketRx" : 0,
      "IntranetIn" : 0,
      "EniId" : "eni-bp19da36d6xdwey3****",
      "DropPacketTx" : 0,
      "PacketRx" : 0
    }, {
      "PacketTx" : 52240,
      "TimeStamp" : "2018-05-21T03:19:00Z",
      "IntranetOut" : 73344,
      "DropPacketRx" : 0,
      "IntranetIn" : 467,
      "EniId" : "eni-bp19da36d6xdwey2****",
      "DropPacketTx" : 0,
      "PacketRx" : 6603
    }, {
      "PacketTx" : 34925,
      "TimeStamp" : "2018-05-21T03:20:00Z",
      "IntranetOut" : 48871,
      "DropPacketRx" : 0,
      "IntranetIn" : 350,
      "EniId" : "eni-bp19da36d6xdwey1****",
      "DropPacketTx" : 0,
      "PacketRx" : 4888
    } ]
  }
}

Códigos de erro

HTTP status code	Error code	Error message	Description
403	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	Valor inválido para EndTime.
403	InvalidParameter.TooManyDataQueried	Too many data queried.	O volume máximo de dados de monitoramento consultáveis foi excedido.
403	Throttling	Request was denied due to request throttling.	A solicitação foi negada devido ao limitador de taxa.
403	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.
403	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	A hora final não pode ser anterior à hora inicial.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	O disco especificado não foi encontrado. Verifique se o ID do disco é válido.

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