文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 全域弹性公网IP段/ 全域弹性公网IP段绑定后端实例 - AssociateGeipSegmentInstance
更新时间：2025-10-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

全域弹性公网IP段绑定后端实例 - AssociateGeipSegmentInstance

功能介绍

全域弹性公网IP段绑定后端实例

调试

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

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:geipSegments:associateInstance

    Write

    geipSegment *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

URI

POST /v3/{domain_id}/global-eip-segments/{global_eip_segment_id}/associate-instance

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

最小长度：5

最大长度：32

global_eip_segment_id

是

String

全域弹性公网IP段的ID

最小长度：36

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

参数

是否必选

参数类型

描述

global_eip_segment

是

global_eip_segment object

请求对象
表4 global_eip_segment

参数

是否必选

参数类型

描述

region

是

String

region

最小长度：1

最大长度：64

instance_type

是

String

支持绑定的实例类型

最小长度：1

最大长度：64

instance_site

否

String

绑定实例所在的站点

最小长度：0

最大长度：64

instance_id

是

String

实例ID

最小长度：0

最大长度：36

project_id

是

String

最小长度：1

最大长度：32

service_id

否

String

服务id

最小长度：1

最大长度：512

service_type

否

String

服务类型

最小长度：1

最大长度：32

响应参数

状态码：200

表5 响应Header参数

参数

参数类型

描述

X-Request-Id

String

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

参数

参数类型

描述

job_id

String

本次请求的job id

global_eip_segment

ShortGlobalEipSegment object

全域弹性公网IP段信息
表7 ShortGlobalEipSegment

参数

参数类型

描述

id

String

全域弹性公网IP段的ID

name

String

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

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

最小长度：1

最大长度：64

请求示例

全域弹性公网IP段绑定后端实例

POST https://{Endpoint}/v3/{domain_id}/global-eip-segments/cc3da1f6-fa84-4161-98f9-89e2563dff27/associate-instance

{
  "global_eip_segment" : {
    "region" : "cn-southwest-242",
    "project_id" : "cb576f8cf0df40b8bb6cea0a1765c569",
    "instance_type" : "ECS",
    "instance_id" : "d2353d6e-07a4-4429-adfc-0c80d39b4802"
  }
}

响应示例

状态码：200

OK

{
  "global_eip_segment" : {
    "id" : "cc3da1f6-fa84-4161-98f9-89e2563dff27",
    "name" : "geip-48bb"
  },
  "job_id" : "1d198de9-dded-4de1-89a6-db2ee905487e"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 全域弹性公网IP段

相关文档