文档首页/ 弹性负载均衡 ELB/ API参考/ API(V3)/ 负载均衡器/ 批量将IP地址加入LB实例域名解析中 - BatchEnableDomainIPs
更新时间:2026-01-09 GMT+08:00
分享

批量将IP地址加入LB实例域名解析中 - BatchEnableDomainIPs

功能介绍

批量将IP地址加入LB实例域名解析中。

调用方法

请参见如何调用API

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/dns/ips/batch-enable

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:项目ID。获取方式请参见获取项目ID

约束限制:不涉及

取值范围:长度为32个字符,由小写字母和数字组成。

默认取值:不涉及

loadbalancer_id

String

负载均衡器ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:IAM鉴权Token。

约束限制:不涉及

取值范围:不涉及

默认取值:不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

ips

Array of DnsIp objects

参数解释:需要加入到负载均衡器域名解析中的IP列表。

约束限制:不涉及

取值范围:不涉及

默认取值:不涉及

表4 DnsIp

参数

是否必选

参数类型

描述

ip_address

String

参数解释:ip地址。可以是ipv4地址也可以是ipv6地址。

约束限制:必须是负载均衡器的私网地址或者公网地址。

取值范围:不涉及

默认取值:不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

ips

Array of ListDnsIpResponseBody objects

参数解释:返回的负载均衡器的dns ip信息。

约束限制:如果负载均衡器的公网域名和私网域名开关都没有打开,则列表为空。

取值范围:不涉及

默认取值:不涉及

表6 ListDnsIpResponseBody

参数

参数类型

描述

ips

Array of DnsIpResponse objects

负载均衡器dns ip信息列表。

表7 DnsIpResponse

参数

参数类型

描述

id

String

dns ip信息的ID。

enable

Boolean

参数解释:ip是否加入了域名解析。

取值范围

true:已加入域名解析。

false:未加入域名解析。

ip_address

String

参数解释:ip地址。可以是ipv4地址也可以是ipv6地址。

约束限制:必须是负载均衡器的私网地址或者公网地址。

type

String

参数解释:地址类型。

取值范围

vip:私网ip。

eip:公网ip。

domain_name

String

参数解释:ip对应的域名。

约束限制

  • 如果ip为私网类型,则这里为负载均衡实例的私网域名

  • 如果ip为公网类型,则这里为负载均衡实例的公网域名

created_at

String

创建时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。

updated_at

String

更新时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。

请求示例

批量将IP地址加入LB实例域名解析中

POST https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/dns/ips/batch-enable

{
  "ips" : [ {
    "ip_address" : "192.168.20.87"
  }, {
    "ip_address" : "2001:db8:a583:682::10"
  } ]
}

响应示例

状态码:200

操作正常返回。

{
  "ips" : [ {
    "enable" : true,
    "type" : "vip",
    "ip_address" : "192.168.20.87",
    "domain_name" : "10000000-0000-0000-0000-000000000001-internal.elb.zunei.test.private.com",
    "id" : "10000000-0000-0000-0000-000000000001"
  }, {
    "enable" : true,
    "type" : "eip",
    "ip_address" : "2001:db8:a583:682::10",
    "domain_name" : "10000000-0000-0000-0000-000000000001.elb.zunei.test.public.com",
    "id" : "10000000-0000-0000-0000-000000000002"
  } ]
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码

相关文档