更新弹性IP

功能介绍

更新弹性IP，将弹性IP跟一个网卡绑定或者解绑定，转换IP地址版本类型。

URI

PUT /v1/{project_id}/publicips/{publicip_id}

请求消息

• 请求参数

  表2 请求参数

  名称	是否必选	参数类型	说明
  publicip	是	publicip object	弹性IP对象，请参见表3。

  表3 publicip字段说明

  名称	是否必选	参数类型	说明
  port_id	否	String	功能说明：端口id。 约束：必须是存在的端口id，如果不带该参数或者值为空时为解除绑定弹性IP，如果该端口不存在或端口已绑定弹性IP则会提示出错
  alias	否	String	功能说明：弹性公网IP名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

• 请求样例1（EIP绑定一张网卡）

  PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
  
  {
      "publicip": {
          "port_id": "f588ccfa-8750-4d7c-bf5d-2ede24414706"
      }
  }

响应消息

• 响应参数

  表4 响应参数

  名称	参数类型	说明
  publicip	publicip object	弹性IP对象，请参见表5。

  表5 publicip字段说明

  名称	参数类型	说明
  id	String	弹性IP唯一标识
  status	String	功能说明：弹性IP的状态 取值范围： FREEZED：冻结 BIND_ERROR：绑定失败 BINDING：绑定中 PENDING_DELETE：释放中 PENDING_CREATE：创建中 PENDING_UPDATE：更新中 NOTIFYING：创建中 NOTIFY_DELETE：释放中 DOWN：未绑定 ACTIVE：绑定 ELB：绑定ELB VPN：绑定VPN ERROR：异常失败
  type	String	功能说明：弹性IP的类型 约束： 必须是系统具体支持的类型 publicip_id为IPv4端口，所以"publicip_type"字段未给定时，默认为5_bgp。
  public_ip_address	String	IPv4时是申请到的弹性IP地址。
  private_ip_address	String	功能说明：绑定弹性IP的私有IP地址 约束：只有绑定了的弹性IP查询才会返回该参数
  port_id	String	功能说明：端口id。 约束：只有绑定了的弹性IP查询才会返回该参数
  tenant_id	String	项目ID
  create_time	String	弹性IP申请时间（UTC） 格式：yyyy-MM-dd HH:mm:ss
  bandwidth_id	String	弹性IP对应带宽ID
  bandwidth_size	Integer	带宽大小，单位为Mbit/s。
  bandwidth_share_type	String	功能说明：弹性IP的带宽类型 取值范围：PER，WHOLE。 PER：独享带宽 WHOLE：共享带宽
  alias	String	弹性公网IP名称

• 响应样例（EIP绑定一张网卡）

  {
    "publicip": {
      "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
      "status": "ACTIVE",
      "alias": "tom",
      "type": "5_bgp",
      "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe",
      "public_ip_address": "10.xx.xx.162",
      "private_ip_address": "192.168.1.131",
      "tenant_id": "26ae5181a416420998eb2093aaed84d9",
      "create_time": "2019-03-27 01:33:18",
      "bandwidth_size": 7,
      "ip_version": 4,
      "bandwidth_name": "bandwidth-2aef",
      "enterprise_project_id": "0",
      "bandwidth_share_type": "PER",
      "bandwidth_id": "7a258fff-10d8-44b8-8124-c59079eb8f4c"
    }
  }

状态码

请参见状态码。

错误码

请参考错误码。