全部产品
Search
文档中心

云解析 PrivateZone:获取解析记录列表

更新时间:Sep 06, 2023

调用DescribeZoneRecords查询解析记录列表。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeZoneRecords

系统规定参数。取值:DescribeZoneRecords

ZoneId String CAgICA1OA_58

Zone ID。

Lang String en

语言。

Keyword String test

主机记录的关键字,按照”%Keyword%”模式搜索,不区分大小写。

PageNumber Integer 1

当前页数,起始值为1,默认为1

PageSize Integer 100

分页查询时设置的每页行数,最大值100,默认为20

UserClientIp String 1.1.1.1

用户Ip。

Tag String tag

标签。

默认不填写,进行当前zone解析记录查询。

填写“ecs”,进行当前zone关联VPC下的主机名记录列表查询。

SearchMode String LIKE

搜索模式。取值:

  • LIKE:模糊搜索
  • EXACT:精确搜索(默认)

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

当前页码。

PageSize Integer 100

分页大小。

Records Array of Record

解析记录列表。

Record
Priority Integer 60

MX记录的优先级,取值范围:[1,99]

记录类型为MX记录时,此参数必选。

RecordId Long 5809

解析记录ID。

Remark String xxx

备注。

Rr String www

主机记录。

Status String ENABLE

状态。

Ttl Integer 60

生存时间,默认为60

Type String A

解析记录类型。

Value String 1.1.1.1

记录值。

RequestId String 7B07FBC3-3A53-4939-A3C6-2BDFE407BAB2

请求ID。

TotalItems Integer 100

解析记录总数。

TotalPages Integer 100

解析记录总页数。

示例

请求示例

http://pvtz.aliyuncs.com/?Action=DescribeZoneRecords
&ZoneId=CAgICA1OA_58
&<公共请求参数>

正常返回示例

XML 格式

<DescribeZoneRecordsResponse>
    <PageNumber>1</PageNumber>
    <Records>
        <Record>
            <Status>DISABLE</Status>
            <Value>1.1.1.1</Value>
            <Rr>www</Rr>
            <RecordId>5809</RecordId>
            <Ttl>60</Ttl>
            <Type>A</Type>
        </Record>
        <Record>
            <Status>ENABLE</Status>
            <Value>1.1.1.1</Value>
            <Rr>a49880308bb2</Rr>
            <RecordId>5808</RecordId>
            <Ttl>60</Ttl>
            <Type>A</Type>
        </Record>
    </Records>
    <PageSize>20</PageSize>
    <RequestId>7B07FBC3-3A53-4939-A3C6-2BDFE407BAB2</RequestId>
    <TotalItems>2</TotalItems>
    <TotalPages>1</TotalPages>
</DescribeZoneRecordsResponse>

JSON 格式

{
    "PageNumber": 1, 
    "Records": {
        "Record": [
            {
                "Status": "DISABLE", 
                "Value": "1.1.1.1", 
                "Rr": "www", 
                "RecordId": 5809, 
                "Ttl": 60, 
                "Type": "A"
            }, 
            {
                "Status": "ENABLE", 
                "Value": "1.1.1.1", 
                "Rr": "a49880308bb2", 
                "RecordId": 5808, 
                "Ttl": 60, 
                "Type": "A"
            }
        ]
    }, 
    "PageSize": 20, 
    "RequestId": "2748A96A-3D47-4B27-AE8B-75C41B16D652", 
    "TotalItems": 2, 
    "TotalPages": 1
}

错误码

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