文档首页> 弹性公网IP EIP> API参考> API> 弹性公网IP> 更新弹性公网IP
更新时间：2024-04-17 GMT+08:00
查看PDF

更新弹性公网IP

功能介绍

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

URI

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

参数说明请参见表1。
表1 参数说明

名称

是否必选

说明

project_id

是

项目ID，获取项目ID请参见获取项目ID。

publicip_id

是

弹性公网IP唯一标识

请求消息

  • 请求参数
    表2 请求参数

    名称

    是否必选

    参数类型

    说明

    publicip

    是

    publicip object

    弹性公网IP对象，请参见表3。
    表3 publicip字段说明

    名称

    是否必选

    参数类型

    说明

    port_id

    否

    String
    • 功能说明：端口id。
    • 约束：必须是存在的端口id，如果不带该参数或者值为空时为解除绑定弹性公网IP，如果该端口不存在或端口已绑定弹性公网IP则会提示出错

    ip_version

    否

    Integer
    • 功能说明：IP版本信息。
    • 取值范围：4和6
      • 4：IPv4
      • 6：IPv6
    • 约束：
      • 必须是系统支持的IP版本类型
      • 和port_id互斥：不能同时设置port_id和ip_version字段。

    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：异常失败

    profile

    profile object

    功能说明：额外参数，包括订单id、产品id等信息，详情请参见表6。

    type

    String
    • 功能说明：弹性公网IP的类型
    • 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP）
      • 华南-广州：5_bgp、5_sbgp
      • 华东-上海一：5_bgp、5_sbgp
      • 华东-上海二：5_bgp、5_sbgp
      • 华北-北京一：5_bgp、5_sbgp
      • 中国-香港：5_bgp
      • 亚太-曼谷：5_bgp
      • 亚太-新加坡：5_bgp
      • 非洲-约翰内斯堡：5_bgp
      • 西南-贵阳一：5_sbgp
      • 华北-北京四：5_bgp、5_sbgp
      • 拉美-圣地亚哥：5_bgp
      • 拉美-圣保罗一：5_bgp
      • 拉美-墨西哥城一：5_bgp
      • 拉美-布宜诺斯艾利一：5_bgp
      • 拉美-利马一：5_bgp
      • 拉美-圣地亚哥二：5_bgp
    • 约束：
      • 必须是系统具体支持的类型
      • publicip_id为IPv4端口，所以"publicip_type"字段未给定时，默认为5_bgp。

    public_ip_address

    String

    IPv4时是申请到的弹性公网IP地址。

    public_ipv6_address

    String

    IPv4时无此字段，IPv6时为申请到的弹性公网IP地址

    ip_version

    Integer

    IP版本信息，取值范围是4和6

    • 4：表示IPv4
    • 6：表示IPv6

    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：共享带宽

    bandwidth_name

    String

    带宽名称。

    alias

    String

    弹性公网IP名称

    enterprise_project_id

    String
    • 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。
    • 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。
    • 不指定该参数时，默认值是 0，0表示默认企业项目。
    说明：

    关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》
    表6 profile字段说明

    名称

    参数类型

    说明

    order_id

    String

    订单的id

    product_id

    String

    产品的id

    region_id

    String

    region的id

    user_id

    String

    用户的id
  • 响应样例（EIP绑定一张网卡）
    {
  "publicip": {
    "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
    "status": "ACTIVE",
    "alias": "tom",
    "profile": {}, 
    "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"
  }
}

状态码

请参见状态码。

错误码

请参考错误码。

父主题： 弹性公网IP