查询负载均衡器IP地址的域名解析配置 - ListDomainIPs

功能介绍

查询负载均衡器所有IP的域名解析配置信息，即负载均衡器的IP是否加入了域名解析，以及对应的域名。

注意：只返回启用的域名类型对应的配置。若只开启公网域名解析，则只返回该负载均衡器的公网IP的域名解析配置；若负载均衡器的公网域名解析和私网域名解析都没有开启，则该返回空列表。

调用方法

请参见如何调用API。

授权信息

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

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

URI

GET /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/dns/ips

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方式请参见获取项目ID。约束限制：不涉及取值范围：长度为32个字符，由小写字母和数字组成。默认取值：不涉及
loadbalancer_id	是	String	参数解释：负载均衡器ID。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 Query参数
参数	是否必选	参数类型	描述
marker	否	String	参数解释：上一页最后一条记录的ID。约束限制：必须与limit一起使用。不指定时表示查询第一页。该字段不允许为空或无效的ID。取值范围：不涉及默认取值：不涉及
limit	否	Integer	参数解释：每页返回的个数。约束限制：不涉及取值范围：0-2000 默认取值：2000
page_reverse	否	Boolean	参数解释：是否反向查询。约束限制：必须与limit一起使用。当page_reverse=true时，若要查询上一页，marker取值为当前页返回值的previous_marker。取值范围： true：查询上一页。 false：查询下一页。默认取值：false

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：IAM鉴权Token。约束限制：不涉及取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
ips	Array of DnsIpResponse objects	负载均衡器IP地址的域名解析配置列表。
page_info	PageInfo object	参数解释：分页信息。
request_id	String	参数解释：请求ID。取值范围：由数字、小写字母和中划线（-）组成的字符串，自动生成。

表5 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	参数解释：更新时间。取值范围：不涉及

表6 PageInfo
参数	参数类型	描述
previous_marker	String	参数解释：分页查询结果中第一条记录的ID。通常用于配合page_reverse=true查询上一页。取值范围：不涉及
next_marker	String	参数解释：分页查询结果中最后一条记录的ID。通常用于查询下一页。取值范围：不涉及
current_count	Integer	参数解释：当前页返回记录数。取值范围：不涉及

请求示例

查询负载均衡器IP地址的域名解析配置

GET https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/38278031-cfca-44be-81be-a412f618773b/dns/ips

响应示例

状态码：200

操作成功正常返回。

{
  "request_id" : "888189c3-06b0-4e37-bba9-9063e18a420e",
  "ips" : [ {
    "enable" : true,
    "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"
  }, {
    "enable" : true,
    "type" : "vip",
    "created_at" : "2026-01-29T07:01:46Z",
    "updated_at" : "2026-01-29T07:01:46Z",
    "ip_address" : "192.168.0.166",
    "domain_name" : "737b61b6-ff56-4112-a14a-c7abaa4e58bf-internal.elb.elb-test"
  } ],
  "page_info" : {
    "previous_marker" : "7b8eec37-fd21-49ac-83d5-31e54fc052e8",
    "current_count" : 2
  }
}