批量将IP地址从ELB实例域名解析中移除 - BatchDisableDomainIPs

功能介绍

批量将IP地址从ELB实例域名解析中移除。

调用方法

请参见如何调用API。

授权信息

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

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

URI

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

表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	参数解释：IPv4或IPv6地址。约束限制：必须是当前负载均衡器绑定的私网地址或者公网地址。取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
ips	Array of DnsIpResponse objects	参数解释：负载均衡器域名解析的IP地址列表。约束限制：如果负载均衡器的公网域名和私网域名域名解析开关都没有打开，则为空列表。取值范围：不涉及默认取值：不涉及
request_id	String	参数解释：请求ID。取值范围：由数字、小写字母和中划线（-）组成的字符串，自动生成。

表6 DnsIpResponse
参数	参数类型	描述
enable	Boolean	参数解释：是否已加入到域名解析。取值范围： true：已加入域名解析。 false：未加入域名解析。
ip_address	String	参数解释：IPv4或IPv6地址。约束限制：必须是当前负载均衡器绑定的私网地址或者公网地址。
type	String	参数解释：IP地址类型。取值范围： vip：私网IP。 eip：公网IP。
domain_name	String	参数解释：当前IP地址关联的负载均衡实例域名。约束限制：如果IP为私网类型，则这里为负载均衡实例的私网域名。如果IP为公网类型，则这里为负载均衡实例的公网域名。
created_at	String	参数解释：创建时间。取值范围：不涉及
updated_at	String	参数解释：更新时间。取值范围：不涉及

请求示例

批量将IP地址从ELB实例域名解析中移除

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

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

响应示例

状态码：200

操作正常返回。

{
  "ips" : [ {
    "enable" : false,
    "type" : "vip",
    "created_at" : "2026-01-29T07:08:09Z",
    "updated_at" : "2026-01-29T07:08:28Z",
    "ip_address" : "192.168.0.166",
    "domain_name" : "737b61b6-ff56-4112-a14a-c7abaa4e58bf-internal.elb.elb-test"
  }, {
    "enable" : false,
    "type" : "eip",
    "created_at" : "2026-01-29T06:57:26Z",
    "updated_at" : "2026-01-29T06:57:26Z",
    "ip_address" : "10.83.50.35",
    "domain_name" : "737b61b6-ff56-4112-a14a-c7abaa4e58bf.elb.example.com"
  } ],
  "request_id" : "e7324226f3df8dedcd1e6a5a8b93b1bf"
}