文档首页/ 智能边缘云 IEC/ API参考/ API/ 弹性公网IP/ 更新弹性公网IP - UpdatePublicIp
更新时间：2025-10-29 GMT+08:00
查看PDF
分享

更新弹性公网IP - UpdatePublicIp

功能介绍

更新弹性公网IP的信息，主要用于解绑和绑定EIP和VIP之间的关系。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v1/publicips/{publicip_id}

表1 路径参数

参数

是否必选

参数类型

描述

publicip_id

是

String

弹性公网IP ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

publicip

是

UpdatePublicIpOption object

更新弹性公网IP请求参数
表4 UpdatePublicIpOption

参数

是否必选

参数类型

描述

port_id

是

String

vip对应的port的ID可为空。当为空的时候，代表解绑原有eip的关系。不为空时，代表绑定eip和vip。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

publicip

PublicIp object

弹性公网ip数据。
表6 PublicIp

参数

参数类型

描述

id

String

弹性公网IP唯一标识。

status

String

弹性公网IP的状态。

port_id

String

端口的ID。

public_ip_address

String

弹性公网IP的地址。

private_ip_address

String

绑定弹性公网IP的私有IP地址。

create_time

String

创建时间。

bandwidth_id

String

带宽的ID。

bandwidth_name

String

带宽的名称。

bandwidth_share_type

String

带宽的类型。

bandwidth_size

Integer

带宽的大小。

ip_version

Integer

IP版本的信息。

site_id

String

子网所属的站点ID。

site_info

String

子网所属的站点信息。

operator

Operator object

运营商信息。

type

String

弹性公网IP的类型。
表7 Operator

参数

参数类型

描述

id

String

运营商ID。

name

String

运营商名称。

取值范围：

  • chinamobile：中国移动；

  • chinaunicom：中国联通；

  • chinatelecom：中国电信。

i18n_name

String

运营商国际化名称。

sa

String

运营商的简写。

请求示例

PUT https://{endpoint}/v1/publicips/2291e404-021e-4af0-a8a0-e1a8c1ae6f3e

{
  "publicip" : {
    "port_id" : "bd2bc212-7369-4a7f-9c14-4dcccbf0f523"
  }
}

响应示例

状态码：200

OK

{
  "publicip" : {
    "id" : "2291e404-021e-4af0-a8a0-e1a8c1ae6f3e",
    "status" : "ACTIVE",
    "site_id" : "6813be76-7322-11ea-9ce0-286ed488d287",
    "site_info" : "中国/华南地区/广东/中山市",
    "port_id" : "bd2bc212-7369-4a7f-9c14-4dcccbf0f523",
    "public_ip_address" : "188.181.56.232",
    "private_ip_address" : "172.16.0.117",
    "create_time" : "2021-02-25 12:31:18",
    "bandwidth_id" : "6ef08c84-9260-4834-b5aa-c355b6cc2901",
    "bandwidth_name" : "bandwidth-测试-勿操作",
    "bandwidth_share_type" : "WHOLE",
    "bandwidth_size" : 500,
    "ip_version" : 4,
    "operator" : {
      "id" : "2",
      "i18n_name" : "中国联通",
      "sa" : "CUCC"
    }
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 弹性公网IP

相关文档