拉取vpcdns域名列表

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

1. 接口描述

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

拉取vpcdns域名列表

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

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

接口只验签名不鉴权。

2. 输入参数

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

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

3. 输出参数

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

4. 错误码

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

错误码	描述
InternalError.UndefiendError	错误未定义
InvalidParameter.	参数错误

5. 示例

示例1 拉取vpcdns域名列表

输入示例

{
  "Filters": [
    {
      "Name": "Domain",
      "Values": [
        "com"
      ]
    }
  ],
  "Limit": 20,
  "Offset": 0
}

输出示例

{
  "Response": {
    "RequestId": "a5454280-f798-34dd-1148-233d35ce17ea",
    "CreatedAt": "2025-06-23 12:31:57",
    "Info": {
      "AllTotal": 5,
      "DomainTotal": 5
    },
    "Domains": [
      {
        "DomainId": 29,
        "OwnerUin": 110000000056,
        "Domain": "a.com",
        "CreatedOn": "2025-01-13 09:29:54",
        "UpdatedOn": "2025-02-11 08:51:27",
        "RecordCount": 8,
        "Remark": "",
        "DnsForwardStatus": "DISABLED",
        "ForwardRuleStatus": "1",
        "VpcInfos": []
      },
      {
        "DomainId": 44,
        "OwnerUin": 110000000056,
        "Domain": "a.com",
        "CreatedOn": "2025-01-24 03:47:31",
        "UpdatedOn": "2025-02-11 09:25:55",
        "RecordCount": 1,
        "Remark": "",
        "DnsForwardStatus": "DISABLED",
        "ForwardRuleStatus": "0",
        "VpcInfos": [
          {
            "UnVpcId": "vpc-b9e4y9ep",
            "VpcId": 67369,
            "RegionId": 50000001
          },
          {
            "UnVpcId": "vpc-d4g487mp",
            "VpcId": 65576,
            "RegionId": 50000001
          }
        ]
      },
      {
        "DomainId": 47,
        "OwnerUin": 110000000056,
        "Domain": "test.com",
        "CreatedOn": "2025-01-24 07:38:18",
        "UpdatedOn": "2025-02-11 09:25:55",
        "RecordCount": 1,
        "Remark": "",
        "DnsForwardStatus": "DISABLED",
        "ForwardRuleStatus": "0",
        "VpcInfos": [
          {
            "UnVpcId": "vpc-b9e4y9ep",
            "VpcId": 67369,
            "RegionId": 50000001
          },
          {
            "UnVpcId": "vpc-d4g487mp",
            "VpcId": 65576,
            "RegionId": 50000001
          }
        ]
      },
      {
        "DomainId": 63,
        "OwnerUin": 110000000056,
        "Domain": "saszhang.com",
        "CreatedOn": "2025-02-12 09:31:06",
        "UpdatedOn": "2025-02-13 10:02:31",
        "RecordCount": 4,
        "Remark": "",
        "DnsForwardStatus": "DISABLED",
        "ForwardRuleStatus": "1",
        "VpcInfos": [
          {
            "UnVpcId": "vpc-d4g487mp",
            "VpcId": 65576,
            "RegionId": 50000001
          }
        ]
      },
      {
        "DomainId": 66,
        "OwnerUin": 110000000056,
        "Domain": "saszhang2.com",
        "CreatedOn": "2025-04-24 08:13:50",
        "UpdatedOn": "2025-04-24 09:02:37",
        "RecordCount": 4,
        "Remark": "",
        "DnsForwardStatus": "DISABLED",
        "ForwardRuleStatus": "1",
        "VpcInfos": []
      }
    ]
  }
}