拉取vpcdns记录列表

最近更新时间: 2026-09-17 00:04:36

1. 接口描述

接口请求域名： vpcdns.api3.fincloud.tencent.cn。

拉取vpcdns记录列表

默认接口请求频率限制：20次/秒。

接口更新时间：2025-06-24 04:34:40。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeVpcDnsRecordList
Version	是	否	String	公共参数，本接口取值：2019-10-25
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
Limit	否	否	Uint64	长度示例值： 20
Offset	否	否	Uint64	偏移示例值： 0
Filters	否	否	Array of RecordListFilters	过滤示例值：查看
DomainId	是	否	Uint64	域名ID 示例值： 3

3. 输出参数

参数名称	类型	描述
CreatedAt	Datetime	请求响应时间示例值： 2014-08-03 12:00:00
Info	RecordListCountInfo	记录数量描述示例值：查看
Records	Array of RecordDetail	解析记录信息示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameterValue.DomainNotExist	域名不存在
InternalError.UndefiendError	错误未定义
InvalidParameter.	参数错误

5. 示例

示例1 拉取vpcdns记录列表

输入示例

{
  "DomainId": 39,
  "Filters": [
    {
      "Name": "Value",
      "Values": [
        "1.1.1.221"
      ]
    }
  ],
  "Offset": 0
}

输出示例

{
  "Response": {
    "RequestId": "881fce7f-9323-475a-5538-2c88caaf8ab8",
    "CreatedAt": "2025-07-02 20:32:53",
    "Info": {
      "AllTotal": 1,
      "RecordTotal": 1
    },
    "Records": [
      {
        "RecordId": 4231,
        "DomainId": 39,
        "SubDomain": "www",
        "RecordType": "A",
        "Value": "1.1.1.221",
        "Ttl": 600,
        "Mx": 0,
        "Enabled": 1,
        "Status": "enabled",
        "Extra": "weight:100",
        "CreatedOn": "2025-06-24 20:59:37",
        "UpdatedOn": "2025-07-02 08:11:00",
        "Weight": 100,
        "HealthStatus": 3,
        "AliveList": [
          {
            "VpcId": "vpc-cwmrr7nn",
            "AliveStatus": 0
          }
        ],
        "BackUpRecordList": [
          {
            "RecordType": "A",
            "SubDomain": "www",
            "RecordValue": "1.2.3.1",
            "AliveList": [
              {
                "VpcId": "vpc-cwmrr7nn",
                "AliveStatus": 0
              }
            ]
          }
        ],
        "BackUpCam": true,
        "EnableValue": "1.1.1.221"
      }
    ]
  }
}