文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 全域弹性公网IP/ 更新全域弹性公网IP信息 - UpdateGlobalEip
更新时间：2025-10-24 GMT+08:00
查看PDF
分享

更新全域弹性公网IP信息 - UpdateGlobalEip

功能介绍

更新全域弹性公网IP信息

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:globalEips:updateGeip

    Write

    globalEip *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>
    • eip:globalEips:update

    -

URI

PUT /v3/{domain_id}/global-eips/{global_eip_id}

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

最小长度：5

最大长度：32

global_eip_id

是

String

global_eip_id

最小长度：36

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户的Token，如何获取用户Token请参见获取用户Token
表3 请求Body参数

参数

是否必选

参数类型

描述

global_eip

是

global_eip object

更新全域弹性公网IP请求体
表4 global_eip

参数

是否必选

参数类型

描述

name

否

String

  • 功能说明：全域弹性公网IP名称

  • 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：1

最大长度：64

description

否

String

  • 功能说明：用户自定义的资源描述

  • 约束：

    • 值的长度最大512字符，由数字、字母、中文、_(下划线)、-（中划线）、.（点）组成。

最小长度：0

最大长度：512

响应参数

状态码：200

表5 响应Header参数

参数

参数类型

描述

X-Request-Id

String

本次请求编号
表6 响应Body参数

参数

参数类型

描述

global_eip

UpdateGlobalEip object

全域弹性公网IP信息

job_id

String

本次请求的job id
表7 UpdateGlobalEip

参数

参数类型

描述

id

String

全域弹性公网IP的ID

name

String

  • 功能说明：全域弹性公网IP名称

  • 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：1

最大长度：64

请求示例

更新全域弹性公网IP信息

PUT https://{Endpoint}/v3/{domain_id}/global-eips/dad6a045-c939-456c-92f2-3c41b0750260

{
  "global_eip" : {
    "name" : "geip-981ff"
  }
}

响应示例

状态码：200

OK

{
  "global_eip" : {
    "id" : "dad6a045-c939-456c-92f2-3c41b0750260",
    "name" : "geip-981ff"
  },
  "job_id" : "a5746ca9-9a3f-4c43-9d83-2f8534422e0b"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 全域弹性公网IP

相关文档