Query EIP monitoring information

Last Updated: Jul 25, 2017

Description

  • Up to 200 monitoring data entries can be returned at once. If the specified (EndTime - StartTime)/Period > 200, an error is returned.

  • If (EndTime - StartTime) < Period, then only the StartTime point data is returned.

Request parameters

Name Type Required Description
Action String Yes Value: DescribeEipMonitorData.
AllocationId String Yes EIP application Id.
StartTime String Yes The start time of the retrieved data. This is represented according to ISO8601 and UTC is required. Format: YYYY-MM-DDThh:mm:ssZ.
If seconds is not 00, it is automatically set to start from the next minute.
EndTime String Yes The end time of the retrieved data. This is represented according to ISO8601 and UTC is required. Format: YYYY-MM-DDThh:mm:ssZ.
If seconds is not 00, it is automatically set to start from the next minute.
Period Integer No The precision of the retrieved monitoring data:
  • 60 seconds
  • 300 seconds
  • 900 seconds
  • 3600 seconds
The default value is 60 seconds.

Return parameters

Name Type Description
EipMonitorDatas EipMonitorDataSetType A collection of instance monitoring data EipMonitorDataType.

Error code

Error Code Description Http status code Meaning
InvalidAllocationId.NotFound Specified allocation id is not found. 400 EIP not found
InvalidStartTime.Malformed Specified start time is malformed. 400 The StartTime format is invalid.
InvalidEndTime.Malformed Specified end time is malformed. 400 The EndTime format is invalid.
InvalidParameter Specified value of Period is not valid. 400 The Period value is not in the available range.
OperationDenied.TooManyDataQueried Specified operation is denied as too many data to return. 400 There are too many query entries. Please reduce the time interval.

Examples

Request example

https://ecs.aliyuncs.com/?Action= DescribeEipMonitorData
&AllocationId=eip-2578g5v5a
&StartTime=2014-10-29T23:00:00Z
&EndTime=2014-10-30T08:00:00Z
&<Public Request Parameters>

Return example

XML format

<DescribeEipMonitorDataResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<EipMonitorDatas>
    <EipMonitorData>
            <EipRX>122</EipRX>
            <EipTX>343</EipTX>
            <EipFlow>675</EipFlow>
            <EipPackets>3434</EipPackets>
            <EipBandwidth>10</EipBandwidth>
            <TimeStamp>2010-01-21T09:50:23Z</TimeStamp>
       </EipMonitorData>
    </EipMonitorDatas>
</DescribeEipMonitorDataResponse>

JSON format

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "EipMonitorDatas": {
        "EipMonitorData": [{
            "EipRX": "122",
            "EipTX": "343",
            "EipFlow": "675",
            "EipPackets": "3434",
            "EipBandwidth": "10",
            "IntranetFlow": 675,
            "IntranetBandwidth": 10,
            "TimeStamp": "2010-01-21T09:50:23Z",
        }]
    }
}
Thank you! We've received your feedback.