查询弹性IP

DescribeAddresses（描述EIP）

Request Parameters（请求参数）

AllocationId.N

• 一个或多个弹性IP的ID
• 默认: 查询region下所有的弹性IP的ID
• 类型: String
• 是否可缺省: 是

ProjectId.N

• EIP所属项目的ID
• 类型: String
• 是否可缺省: 是
• 缺省值：默认项目

IpVersion

• 弹性 IP 的版本
• 类型: String
• 有效值: ipv4 | ipv6 | all
• 是否可缺省: 是
• 缺省值: ipv4

State

• 弹性IP的状态：已绑定，未绑定
• 类型: String
• 有效值: associate | disassociate
• 是否可缺省: 是

Filter.N

• network-interface-id，主机的网卡信息
• instance-type，弹性IP绑定的实例类型，slb | ipfwd(云主机、裸金属均为ipfwd)
• internet-gateway-id，互联网网关的ID
• band-width-share-id，共享带宽ID
• line-id，线路的ID
• public-ip，弹性IP的IP
• project-id，项目的ID
• 类型: Filter list
• 是否可缺省: 是

MaxResults

• 单次调用可返回的最大条目数量. 传入返回的 NextToken 值可以获取剩余的其它条目. 这个值可以允许的范围是 5 - 1000
• 类型: Integer
• 是否可缺省：是

NextToken

• 获取另一页返回结果的 token.
• 类型: String
• 是否可缺省：是

Response Elements（返回值）

RequestId

• 请求ID
• 类型: String

AddressesSet

• 弹性IP的信息
• 类型: Address List

NextToken

• 获取另一页返回结果的 token.
• 类型: String

Examples（例子）

Sample Request(请求)

http://eip.region.api.ksyun.com/?Action=DescribeAddresses
&Version=2016-03-04
&Filter.1.Name=instance-type
&Filter.1.Value.1=Slb
&NextToken=1
&MaxResults=5

Sample Response（返回）

<DescribeAddressesResponse xmlns="http://eip.api.ksyun.com/doc/2016-03-04/">
    <AddressesSet>
        <item>
            <PublicIp>10.144.0.39</PublicIp>
            <CreateTime>2016-05-06 13:41:58</CreateTime>
            <BandWidth>1</BandWidth>
            <InstanceId>4f279335-e40d-495e-ad7d-4d885c2e4e19</InstanceId>
            <LineId>26578b9a-9995-4925-ae0c-17a1c8abbeb7</LineId>
            <State>associate</State>
            <InstanceType>Slb</InstanceType>
            <AllocationId>15e1b902-0594-40c4-9878-01a7fe43c63a</AllocationId>
        </item>
        <item>
            <PublicIp>120.92.128.211</PublicIp>
            <CreateTime>2016-04-15 18:18:14</CreateTime>
            <BandWidth>1</BandWidth>
            <InstanceId>6e86cddf-d7d9-43a6-9a71-b9f01d76a3e6</InstanceId>
            <LineId>8bb4238b-209e-4d62-9af3-36fb1fb8e9ca</LineId>
            <State>associate</State>
            <InstanceType>Slb</InstanceType>
            <AllocationId>2b05cd99-0139-43c0-8144-b046780dd659</AllocationId>
        </item>
    </AddressesSet>
    <RequestId>1d671a66-85be-4905-b2fe-b9879c2d7a5a</RequestId>
</DescribeAddressesResponse>