You can call this operation to query the Elastic IP addresses (EIPs) created in a specified region.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Name Type Required Example Description
Action String Yes DescribeEipAddresses

The operation that you want to perform. Set the value to DescribeEipAddresses.

RegionId String Yes cn-hangzhou

The region ID of the EIPs. You can call the DescribeRegions operation to obtain the region ID.

IncludeReservationData Boolean No true

Specify whether to return data of orders that have not taken effect. Valid values:

  • false (default): Data of orders that have not taken effect is not returned.
  • true: Data of orders that have not taken effect is returned.
Status String No Available

The status of the EIP. Valid values:

  • Associating: The EIP is being bound to an instance.
  • Unassociating: The EIP is being unbound from an instance.
  • InUse: The EIP is allocated and in use.
  • Available: The EIP is available for use.
EipAddress String No 116.xx.xx.28

The IP address of the EIP to be queried.

You can enter the IP addresses of up to 50 EIPs. Separate multiple IP addresses with commas (,).

Note If both the EipAddress and AllocationId parameters are specified, you can enter the IP addresses of 50 EIPs in EipAddress, and enter the IDs of the 50 EIP instances in AllocationId.
AllocationId String No eip-2zeerraiwb7ujxscd****

The ID of the EIP instance to be queried.

You can enter a maximum of 50 EIP instance IDs. Separate the instance IDs with commas (,).

Note If both the EipAddress and AllocationId parameters are specified, you can enter the IDs of up to 50 EIP instances in AllocationId, and enter the IP addresses of the 50 EIPs in EipAddress.
SegmentInstanceId String No eipsg-t4nr90yik5oy38xdy****

The ID of the instance to which the contiguous EIP is bound.

ResourceGroupId String No rg-acfmxazb4pcdvf****

The ID of the resource group to which the EIP belongs.

PageNumber Integer No 10

The number of the page to return. Default value: 1.

PageSize Integer No 10

The number of entries to return on each page. Maximum value: 100. Default value: 10.

ISP String No BGP

The Internet service provider. Set the value to BGP.

Filter.1.Key String No CreationStartTime

The filter key used to query resources. Set the value to CreationStartTime (the start time when resources are created).

Filter.2.Key String No CreationEndTime

The filter key used to query resources. Set the value to CreationEndTime (the end time when resources are created).

Filter.1.Value String No 2018-01-22T09:12Z

The filter value used to query resources. Specify the time in the YYYY-MM-DDThh:mmZ format. The time must be in UTC.

Filter.2.Value String No 2018-01-22T09:15Z

The filter value used to query resources. Specify the time in the YYYY-MM-DDThh:mmZ format. The time must be in UTC.

LockReason String No financial

The reason why the EIP is locked. Valid values:

  • financial: The EIP is locked due to overdue payments.
  • security: The EIP is locked for security reasons.
AssociatedInstanceType String No EcsInstance

The type of the instance to which you want to bind the EIP. Valid value:

  • EcsInstance (default): an ECS instance in a VPC.
  • SlbInstance: an SLB instance in a VPC.
  • Nat: a NAT gateway.
  • HaVip: a High-Availability Virtual IP Address (HaVip).
  • NetworkInterface: a secondary ENI.

    Only one EIP can be bound to each ECS instance, SLB instance, or HaVip. You can bind multiple EIPs to a NAT gateway. The number of EIPs that you can bind to a secondary ENI depends on the EIP binding mode. For more information, see Elastic IP Address overview.

AssociatedInstanceId String No i-2zebb08phyccdvf****

The ID of the cloud service instance.

ChargeType String No PostPaid

The billing method of the EIP. Valid values:

PostPaid: pay-as-you-go.

Response parameters

Parameter Type Example Description
EipAddresses Array

Details about the queried EIP.

EipAddress
AllocationId String eip-2zeerraiwb7ujcdvf****

The ID of the EIP.

AllocationTime String 2019-04-23T01:37:38Z

The time when the EIP was created.

AvailableRegions List cn-hangzhou

The ID of the region to which the EIP belongs.

Bandwidth String 5

The peak bandwidth of the EIP. Unit: Mbit/s.

BandwidthPackageBandwidth String 50

The bandwidth value of the shared bandwidth to which the EIP is added.

BandwidthPackageId String cbwp-bp1ego3i4j07ccdvf****

The ID of the shared bandwidth.

BandwidthPackageType String CommonBandwidthPackage

The type of the bandwidth. Only CommonBandwidthPackage (shared bandwidth) is returned.

ChargeType String PostPaid

The billing method of the EIP.

  • PrePaid: subscription.
  • PostPaid: pay-as-you-go.
DeletionProtection Boolean True

Indicates whether deletion protection is enabled.

  • true: enabled.
  • false: disabled.
Descritpion String abc

The description of the EIP.

EipBandwidth String 101

The bandwidth of the EIP before it is added to or after it is removed from the shared bandwidth.

ExpiredTime String 2019-04-29T02:00Z

The expiration date. Specify the time in the ISO 8601 standard. The time must be in UTC. Format: YYYY-MM-DDThh:mmZ.

HDMonitorStatus String false

Indicates whether per-second monitoring is enabled for the EIP.

  • false: disabled.
  • true: enabled.
HasReservationData String false

Indicates whether renewal data is involved.

This parameter returns true only when the input parameter IncludeReservationData is true, and there is data of orders that have not taken effect.

ISP String BGP

The Internet service provider.

InstanceId String i-bp15zckdt37cdvf****

The ID of the instance to which the EIP is bound.

InstanceRegionId String cn-hangzhou

The region ID of the bound resource.

InstanceType String EcsInstance

The type of the instance to which the EIP is bound.

  • EcsInstance: an ECS instance in a VPC.
  • SlbInstance: an SLB instance in a VPC.
  • Nat: a NAT gateway.
  • HaVip: a High-Availability Virtual IP Address (HaVip).
  • NetworkInterface: a secondary ENI.
InternetChargeType String PayByBandwidth

The billing method of the EIP.

  • PayByBandwidth: pay by bandwidth.
  • PayByTraffic: pay by traffic.
IpAddress String 101.xx.xx.36

The IP address of the EIP.

Name String test

The name of the EIP.

OperationLocks Array

The details about lock.

LockReason
LockReason String financial

The reason why the instance was locked.

  • financial: The EIP is locked due to overdue payments.
  • security: The EIP is locked for security reasons.
RegionId String cn-hangzhou

The region ID of the EIP.

ReservationActiveTime String 2019-03-11T16:00:00Z

The time when the renewal takes effect.

ReservationBandwidth String 12

The bandwidth after the EIP is renewed.

ReservationInternetChargeType String PayByBandwidth

The billing method that you choose when you renew the EIP.

  • PayByBandwidth: pay by bandwidth.
  • PayByTraffic: pay by traffic.
ReservationOrderType String RENEWCHANGE

The type of the renewal order.

  • RENEWCHANGE: upgrade or downgrade.
  • TEMP_UPGRADE: temporary upgrade.
  • UPGRADE : upgrade.
ResourceGroupId String rg-acfmxazcdxs****

The ID of the resource group.

SecondLimited Boolean  false

Indicates whether level-2 traffic throttling is configured.

  • true: Level-2 speed limit is configured.
  • false: Level-2 speed limit is not configured.
SegmentInstanceId String eipsg-t4nr90yik5oy38xdyjth8

The ID of the instance to which the contiguous EIP is bound.

This parameter value is returned only when the EIP is contiguous.

Status String Associating

The status of the EIP.

  • Associating: The EIP is being bound to an instance.
  • Unassociating: The EIP is being unbound from an instance.
  • InUse: The EIP is allocated and in use.
  • Available: The EIP is available for use.
TotalCount Integer 10

The total number of entries returned.

PageNumber Integer 10

The current page number.

PageSize Integer 10

The number of entries returned per page.

RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

The ID of the request.

Examples

Sample requests

https://vpc.aliyuncs.com/?Action=DescribeEipAddresses
&RegionId=cn-hangzhou
&Common request parameters

Sample success responses

XML format

<DescribeEipAddressesResponse>
  <PageNumber>1</PageNumber>
  <EipAddresses>
        <EipAddress>
              <HDMonitorStatus>OFF</HDMonitorStatus>
              <BandwidthPackageBandwidth>5</BandwidthPackageBandwidth>
              <HasReservationData>false</HasReservationData>
              <InstanceId>ngw-bp1kpih7t3izsxezx****</InstanceId>
              <ISP>BGP</ISP>
              <InternetChargeType>PayByBandwidth</InternetChargeType>
              <EipBandwidth>199</EipBandwidth>
              <BandwidthPackageType>CommonBandwidthPackage</BandwidthPackageType>
              <PrivateIpAddress></PrivateIpAddress>
              <SecondLimited>false</SecondLimited>
              <Bandwidth>5</Bandwidth>
              <ChargeType>PostPaid</ChargeType>
              <AllocationTime>2019-12-26T05:06:56Z</AllocationTime>
              <ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
              <Descritpion>abc</Descritpion>
              <IpAddress>47.xx.xx.184</IpAddress>
              <AllocationId>eip-bp1utfpg4zlhyodba****</AllocationId>
              <Mode>NAT</Mode>
              <InstanceType>Nat</InstanceType>
              <Name>vmeixme</Name>
              <SegmentInstanceId></SegmentInstanceId>
              <Status>InUse</Status>
              <InstanceRegionId>cn-hangzhou</InstanceRegionId>
              <BandwidthPackageId>cbwp-bp1k042riiv5aqkkq****</BandwidthPackageId>
              <RegionId>cn-hangzhou</RegionId>
              <DeletionProtection>false</DeletionProtection>
              <OperationLocks>
        </OperationLocks>
              <ExpiredTime></ExpiredTime>
              <AvailableRegions>
                    <AvailableRegion>cn-hangzhou</AvailableRegion>
              </AvailableRegions>
        </EipAddress>
  </EipAddresses>
  <TotalCount>1</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>27CEB319-8242-46A8-B96B-998BCDF87D97</RequestId>
</DescribeEipAddressesResponse>

JSON format

{
	"PageNumber": 1,
	"EipAddresses": {
		"EipAddress": [
			{
				"HDMonitorStatus": "OFF",
				"BandwidthPackageBandwidth": "5",
				"HasReservationData": false,
				"InstanceId": "ngw-bp1kpih7t3izsxezx****",
				"ISP": "BGP",
				"InternetChargeType": "PayByBandwidth",
				"EipBandwidth": "199",
				"BandwidthPackageType": "CommonBandwidthPackage",
				"PrivateIpAddress": "",
				"SecondLimited": false,
				"Bandwidth": "5",
				"ChargeType": "PostPaid",
				"AllocationTime": "2019-12-26T05:06:56Z",
				"ResourceGroupId": "rg-acfmxazb4ph****",
				"Descritpion": "abc",
				"IpAddress": "47.xx.xx.184",
				"AllocationId": "eip-bp1utfpg4zlhyodba****",
				"Mode": "NAT",
				"InstanceType": "Nat",
				"Name": "vmeixme",
				"SegmentInstanceId": "",
				"Status": "InUse",
				"InstanceRegionId": "cn-hangzhou",
				"BandwidthPackageId": "cbwp-bp1k042riiv5aqkkq****",
				"RegionId": "cn-hangzhou",
				"DeletionProtection": false,
				"OperationLocks": {
					"LockReason": []
				},
				"ExpiredTime": "",
				"AvailableRegions": {
					"AvailableRegion": [
						"cn-hangzhou"
					]
				}
			}
		]
	},
	"TotalCount": 1,
	"PageSize": 10,
	"RequestId": "27CEB319-8242-46A8-B96B-998BCDF87D97"
}

Error codes

Http status code Error code Error message Description
404 Forbidden.RegionNotFound Specified region is not found during access authentication. The error message returned because the specified region does not exist. Check whether the region is correct.
404 InvalidFilterKey.NotFound The error message returned because the specified filter key is invalid.
404 InvalidFilterValue The error message returned because the specified filter value is invalid.
404 InvalidLockReason.NotFound The specified LockReason is not found The error message returned because the EIP is locked for an unknown reason.
400 InvalidIAssociatedInstanceType.ValueNotSupported The specified value of AssociatedInstanceType is not supported. The error message returned because the AssociatedInstanceType value is invalid. Check whether the value is correct.
400 InvalidChargeType.ValueNotSupported The specified ChargeType is not supported. The error message returned because the specified billing method is not supported. Select another billing method.

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