获取一个或多个公网IP

可根据公网IP的ID，状态，名称，分配的云服务器ID作过滤条件，来获取公网IP列表。 如果不指定任何过滤条件，默认返回你所拥有的所有公网IP。 如果指定不存在的公网IP，或非法状态值，则会返回错误信息。

Request Parameters

Parameter name	Type	Description	Required
eips.n	String	公网IP的ID	No
instance_id	String	云服务器ID，可得到已分配给此云服务器的公网IP	No
status.n	String	公网IP状态，有效值为 pending, available, associated, suspended，released, ceased	No
search_word	String	搜索关键词，支持公网IP的ID，名称	No
tags.n	String	按照标签ID过滤, 只返回已绑定某标签的资源	No
verbose	Integer	是否返回冗长的信息，若为1，则返回公网IP相关其他资源的详细数据。	No
offset	Integer	数据偏移量，默认为0	No
limit	Integer	返回数据长度，默认为20，最大100	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
eip_set	Array	JSON 格式的公网IP数据列表，每项参数可见下面 Response Item
total_count	Integer	根据过滤条件得到的公网IP总数
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Response Item

Name	Type	Description
eip_id	String	公网IP唯一标识ID
eip_name	String	公网IP名称
description	String	公网IP描述
associate_mode	Integer	绑定模式，0为外部绑定，1为内部绑定
bandwidth	Integer	带宽，以 Mbps 为单位
billing_mode	String	公网IP计费模式：bandwidth 按带宽计费，traffic 按流量计费
status	String	公网IP状态，有效值为 pending, available, associated, suspended，released, ceased。 pending： 等待被创建 available： 可用状态，此时可以被绑定到资源上。 associated： 绑定状态 suspended： 由于欠费，已被暂停使用 released： 已被释放会资源池，此时公网IP不可被恢复。 ceased： 已被彻底释放
transition_status	String	公网IP过渡状态，有效值为 associating, dissociating, suspending, resuming, releasing。 associating： 绑定到资源中，由 available 状态变成 associated 状态 dissociating： 启动中，由 associated 状态变成 available 状态 suspending： 欠费暂停中，由 available/associated 状态变成 suspended 状态 resuming： 恢复中，由 suspended 状态变成 available 状态 releasing： 删除中，由 available/associated/suspended 状态变成 released 状态
icp_codes	String	备案号
create_time	TimeStamp	公网IP创建时间，为UTC时间，格式可参见 ISO8601.
status_time	TimeStamp	公网IP最近一次状态变更时间，为UTC时间，格式可参见 ISO8601.
resource	Dict	若已分配到云服务器/路由器，则表示所分配的云服务器/路由器信息，数据格式为: { “resource_name”:“website”, “resource_type”:“instance”, “resource_id”:“i-j32t3llb” }
eip_group	Dict	公网IP的分组信息，数据格式为: { “eip_group_id”:“eipg-1nv8hobz”, “eip_group_name”:“192.168.93.*" }
eip_addr	String	公网IP地址

Example

Example Request:

https://api.shanhe.com/iaas/?action=DescribeEips
&COMMON_PARAMS

Example Response:

{
  "action":"DescribeEipsResponse",
  "total_count":1,
  "eip_set":[
    {
      "status":"associated",
      "eip_id":"eip-amorzjgv",
      "description":null,
      "associate_mode":0,
      "need_icp":0,
      "sub_code":0,
      "transition_status":"",
      "icp_codes":"",
      "eip_group":{
        "eip_group_id":"eipg-00000000",
        "eip_group_name":"BGP multi-line"
      },
      "bandwidth":4,
      "billing_mode":"traffic",
      "create_time":"2013-08-30T10:15:47Z",
      "status_time":"2013-08-30T10:15:56Z",
      "eip_name":"demo",
      "resource":{
        "resource_name":"demo",
        "resource_type":"router",
        "resource_id":"rtr-b0u6sdj6"
      },
      "eip_addr":"192.168.7.69"
    }
  ],
  "ret_code":0
}