human: 如何处理七牛云的云主机弹性公网 IP 详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >弹性公网 IP 详情

#  弹性公网 IP 详情

最近更新时间: 2020-12-29 17:36:47

# 请求路径

> `GET` /v1/vm/eip/:allocation_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 | 弹性公网 IP 的 ID  
region_id | string | query | 是 | 地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | EIPInfo | EIP 列表  
  
### EIPInfo

名称 | 类型 | 描述  
---|---|---  
allocation_id | string |  弹性公网 IP 的 ID  
allocation_name | string |  弹性公网 IP 的名称  
charge_type | string |  弹性公网 IP 的计费模式。

  * PrePaid：包年包月。
  * PostPaid：按量计费。

  
status | string |  EIP 的状态。

  * Associating：绑定中。
  * Unassociating：解绑中。
  * InUse：已分配。
  * Available：可用。

  
instance_id | string |  当前绑定的实例的 ID  
instance_name | string |  当前绑定的实例的名称  
region_id | string |  EIP 所在的地域  
ip_address | string |  弹性公网 IP 的 IP 地址  
isp | string |  服务提供商

  * `BGP_PRO`: BGP（多线）精品线路
  * `BGP`: BGP（多线）线路
  * `5_telcom`: 电信
  * `5_union`: 联通
  * `5_bgp`: 全动态BGP
  * `5_sbgp`: 静态BGP

  
internet_charge_type | string |  EIP 的计量方式，取值：

  * PayByBandwidth（默认值）：按带宽计费。
  * PayByTraffic：按流量计费。
  * 当 InstanceChargeType 取值为 PrePaid 时，InternetChargeType 必须取值 PayByBandwidth。
  * 当 InstanceChargeType 取值为 PostPaid 时，InternetChargeType 可取值 PayByBandwidth 或 PayByTraffic。

  
instance_type | string |  EIP 的实例的类型，取值：

  * `Nat`：NAT 网关。
  * `SlbInstance`：负载均衡 SLB。
  * `EcsInstance`：云服务器 ECS。
  * `NetworkInterface`：辅助弹性网卡。
  * `HaVip`：高可用虚拟 IP。

  
bandwidth | string |  EIP 的带宽峰值，单位为 Mbps 如果加入带宽包，则为被分配的带宽大小  
pricing_cycle | string |  包年包月的计费周期，取值：

  * Month（默认值）：按月付费。
  * Year：按年付费。

  
period | string |  购买时长。

  * 当 PricingCycle 取值 Month 时，Period 取值范围为 1~9。
  * 当 PricingCycle 取值 Year 时，Period 取值范围为 1~3。

  
bandwidth_package_bandwidth | string |  EIP 加入的共享带宽的带宽值  
bandwidth_package_id | string |  加入的共享带宽 ID  
bandwidth_package_type | string |  带宽的类型，仅支持返回 CommonBandwidthPackage（共享带宽）  
eip_bandwidth | string |  EIP 加入共享带宽之前或退出共享带宽之后的带宽  
expired_time | string |  到期时间  
created_at | string |  创建时间  
updated_at | string |  更新时间  
auto_renew_info | AutoRenew |  自动续费信息 注：仅限于已开启自动续费的包年包月 EIP  
customized_expire_time | string |  自定义过期时间  
cost_charge_type | string | 付费方式  
cost_charge_mode | string | 按什么计费  
  
### AutoRenew

名称 | 类型 | 描述  
---|---|---  
region_id | string | EIP 所在的地域  
resource_type | string | 资源类别  
resource_id | string | 资源 ID  
cost_params | object | 计费参数  
updated_at | string | 创建时间  
created_at | string | 更新时间  
  
## 返回值示例

    
    
    {
      "data": {
        "allocation_id": "eip-j6ct5x5x63h6x8",
        "allocation_name": "ssss",
        "charge_type": "PostPaid",
        "status": "InUse",
        "instance_id": "i-j6ci4wx78lgqewyxihx1",
        "instance_name": "ss",
        "region_id": "cn-hongkong",
        "ip_address": "123.123.123.123",
        "isp": "BGP",
        "internet_charge_type": "PayByTraffic",
        "instance_type": "EcsInstance",
        "bandwidth": "10",
        "pricing_cycle": "",
        "period": "",
        "auto_pay": "true",
        "bandwidth_package_bandwidth": "",
        "bandwidth_package_id": "",
        "bandwidth_package_type": "",
        "eip_bandwidth": "",
        "allocation_time": "2020-11-09T19:58:57+08:00",
        "expired_time": "2120-12-25T23:54:00+08:00",
        "updated_at": "2020-12-25T15:54:08.202+08:00",
        "created_at": "2020-11-09T19:58:58.633+08:00",
        "customized_expire_time": null,
        "cost_charge_type": "PostPaid",
        "cost_charge_mode": "PayByTraffic",
      },
      "request_id": "ScKvEURLnxF751MW"
    }
    

以上内容是否对您有帮助？