查询负载均衡器ip的域名配置信息 - ListDomainIPs
功能介绍
查询负载均衡器ip的域名配置信息，即负载均衡器的ip是否加入了域名解析。
注意：当负载均衡器的公网域名和私网域名都没有打开时，该接口返回空列表。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/dns/ips
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：项目ID。获取方式请参见获取项目ID。 约束限制：不涉及 取值范围：长度为32个字符，由小写字母和数字组成。 默认取值：不涉及 |
|
loadbalancer_id |
是 |
String |
负载均衡器ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释：IAM鉴权Token。 约束限制：不涉及 取值范围：不涉及 默认取值：不涉及 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ips |
Array of DnsIpResponse objects |
负载均衡器dns ip信息列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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对应的域名。 约束限制：
|
|
created_at |
String |
创建时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 |
|
updated_at |
String |
更新时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 |
请求示例
查询负载均衡器的DNS ip列表
GET https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/38278031-cfca-44be-81be-a412f618773b/dns/ips
响应示例
状态码：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" : false,
"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 |
操作成功正常返回。 |
错误码
请参见错误码。
