DescribePrivateDnsEndpointList - 查询私网DNS终端节点列表_云防火墙(Cloud Firewall)-阿里云帮助中心

查询私网DNS终端节点列表

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cloudfirewall:DescribePrivateDnsEndpointList

get

*PrivateDNS

acs:cloudfirewall::{#accountId}:privatedns/{#AccessInstanceId}

无

请求参数

名称	类型	必填	描述	示例值
AccessInstanceId	string	否	实例 ID	pd-12345
RegionNo	string	否	地域 ID。	cn-hangzhou
VpcId	string	否	VPC 实例 ID。	vpc-8vbwbo90rq0anm6t****
AccessInstanceName	string	否	私有实例名称。	测试
FirewallType	string	否	云防火墙类型。取值： internet vpc nat	vpc
Status	string	否	实例状态。取值： creating：创建中。 deleting：删除中。 normal：正常。 updating：更新中。	normal
MemberUid	integer	否	成员账号 UID。	135809047715****
PageNo	integer	否	当前页面的页码。	1
PageSize	integer	否	当前页面的页数。	10

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	返回结果的请求 ID。	850A84D6-0DE4-4797-A1E8-00090****
TotalCount	integer	返回结果的总条数。	3
PageNo	integer	当前页面的页码。	1
PageSize	integer	当前页面的页数。	10
AccessInstanceList	array<object>	私有实例列表。
	object	私有实例列表。
AliUid	integer	云防火墙账号的 AliUid。	1379490574415****
MemberUid	integer	云防火墙成员账号的 UID。	1844802493****
RegionNo	string	实例所在的地域 ID。	cn-hangzhou
FirewallType	array	云防火墙类型。取值： internet vpc nat
	string	云防火墙类型。取值： internet vpc nat	[ "internet", "vpc", "nat" ]
AccessInstanceId	string	实例 ID	123
AccessInstanceName	string	私有实例名称。	test
PrivateDnsType	string	私有 DNS 类型。取值： PrivateZone Custom（默认）	Custom
VpcId	string	VPC 实例 ID。	vpc-2zelphbaourpun****
PrimaryDns	string	主 DNS。	1.1.1.1
StandbyDns	string	备 DNS。	1.1.1.2
Port	integer	端口号。	443
IpProtocol	integer	IP 协议。取值： TCP UDP	tcp
Status	integer	实例状态。取值： creating：创建中。 deleting：删除中。 normal：正常。 updating：更新中。	normal
DomainNameCount	integer	域名数。	3
TaskId	string	任务 Id，任务的唯一标识。	123
GmtCreate	integer	创建时间（秒，时间戳格式）。	1715075765

示例

正常返回示例

JSON格式

{
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090****",
  "TotalCount": 3,
  "PageNo": 1,
  "PageSize": 10,
  "AccessInstanceList": [
    {
      "AliUid": 0,
      "MemberUid": 0,
      "RegionNo": "cn-hangzhou",
      "FirewallType": [
        "[\n  \"internet\",\n  \"vpc\",\n  \"nat\"\n]"
      ],
      "AccessInstanceId": "123",
      "AccessInstanceName": "test",
      "PrivateDnsType": "Custom",
      "VpcId": "vpc-2zelphbaourpun****",
      "PrimaryDns": "1.1.1.1",
      "StandbyDns": "1.1.1.2",
      "Port": 443,
      "IpProtocol": 0,
      "Status": 0,
      "DomainNameCount": 3,
      "TaskId": "123",
      "GmtCreate": 1715075765
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。