DescribeEniMonitorData

Description

The monitoring data includes intranet inbound and outbound traffic, the number of packets sent and received by the secondary ENI, and the number of dropped packets sent and received 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 monitoring data of the secondary ENI cannot be queried if the instance is in the Stopped state. The monitoring data also cannot be queried if the secondary ENI is not attached to an instance and is in the Available state. When you call this operation, take note of the following points:

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

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>

Sample success responses

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":[
         {
             "PacketTx":0,
             "TimeStamp":"2018-05-21T03:22:00Z",
             "IntranetOut":0,
             "DropPacketRx":0,
             "IntranetIn":0,
             "EniId":"eni-myENI",
             "DropPacketTx":0,
             "PacketRx":0
         },
         {
             "PacketTx":0,
             "TimeStamp":"2018-05-21T03:21:00Z",
             "IntranetOut":0,
             "DropPacketRx":0,
             "IntranetIn":0,
             "EniId":"eni-myENI",
             "DropPacketTx":0,
             "PacketRx":0
         },
         {
             "PacketTx":52240,
             "TimeStamp":"2018-05-21T03:19:00Z",
             "IntranetOut":73344,
             "DropPacketRx":0,
             "IntranetIn":467,
             "EniId":"eni-myENI",
             "DropPacketTx":0,
             "PacketRx":6603
         },
         {
             "PacketTx":34925,
             "TimeStamp":"2018-05-21T03:20:00Z",
             "IntranetOut":48871,
             "DropPacketRx":0,
             "IntranetIn":350,
             "EniId":"eni-myENI",
             "DropPacketTx":0,
             "PacketRx":4888
         }
     ]
 }
}

Error codes

For a list of error codes, visit the API Error Center.