DescribeEniMonitorData

Description

The traffic data information includes intranet inbound and outbound traffic, the number of packets sent and received by the secondary ENI, and the number of packets discarded by the secondary ENI. If some content in the returned information is missing, it is possible that the system did not obtain the corresponding information. For example, the traffic data information on the secondary ENI cannot be queried if the instance is in the Stopped state. Data also cannot be queried if the secondary ENI is not attached to an instance and in the Available state. When you call this operation, note that:

• Up to 400 monitored data entries can be returned per query. If the value of (EndTime and StartTime)/Period is greater than 400, an error is returned.
• You can only query the monitored data in the last 30 days. If the value of the StartTime parameter is earlier than 30 days, an error is returned.

Debugging

You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Response parameters

Examples

Sample requests

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

Successful response examples

XML format

<DescribeEniMonitorDataResponse>
  <RequestId>5A03C2BA-3BCE-4A87-8076-7DC1629</RequestId>
  <TotalCount>4</TotalCount>
  <MonitorData> 
    <EniMonitorData>
      <PacketTx>0</PacketTx>
      <TimeStamp>2018-05-21T03:22:00Z</TimeStamp>
      <IntranetOut>0</IntranetOut>
      <DropPacketRx>0</DropPacketRx>
      <IntranetIn>0</IntranetIn>
      <EniId>eni-myENI</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-myENI</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-myENI</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-myENI</EniId>
      <DropPacketTx>0</DropPacketTx>
      <PacketRx>4888</PacketRx>
    </EniMonitorData>
  </MonitorData> 
</DescribeEniMonitorDataResponse>

JSON format

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

Error codes

View error codes