产品动态

产品简介

产品介绍

产品优势

使用限制

应用场景

购买指南

计费概述

增值服务优惠包说明

非标 TLD 说明

快速入门

开通 Private DNS

创建私有域

删除私有域

修改关联 VPC

操作指南

解析记录设置

修改解析记录

删除解析记录

导入解析记录

导出解析记录

跨账号关联 VPC

批量操作

反向解析及 PTR 记录说明

子域名递归解析说明

解析量统计说明

负载均衡说明

递归解析说明

访问管理

访问管理概述

可授权资源类型

访问管理策略示例

实践教程

配置 NSCD 服务实现缓存加速，提高 DNS 可用性

API 文档

History

Introduction

API Category

Making API Requests

Private DNS APIs

Data Types

Error Codes

常见问题

Private DNS 相关问题

Private DNS 是否会覆盖公共域名

PDNS 政策

隐私协议

数据处理和安全协议

CreatePrivateDNSAccount

PDF

Mode fokus

Ukuran font

Terakhir diperbarui: 2025-10-30 21:53:17

1. API Description

Domain name for API request: privatedns.intl.tencentcloudapi.com.

This API is used to create a Private DNS account.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer

Try it

API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name	Required	Type	Description
Action	Yes	String	Common Params. The value used for this API: CreatePrivateDNSAccount.
Version	Yes	String	Common Params. The value used for this API: 2020-10-28.
Region	No	String	Common Params. This parameter is not required for this API.
Account	Yes	PrivateDNSAccount	Private DNS account

3. Output Parameters

Parameter Name	Type	Description
RequestId	String	The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Creating Private DNS account

Input Example

POST / HTTP/1.1
Host: privatedns.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreatePrivateDNSAccount
<Common request parameters>

{
    "Account": {
        "Uin": "123456789"
    }
}

Output Example

{
    "Response": {
        "RequestId": "5cd964e2-b5e6-8a35-9ce5a1085860c845"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

Tencent Cloud CLI 3.0

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code	Description
AuthFailure	Error with CAM signature/authentication.
FailedOperation	Operation failed.
InternalError	Internal error.
InternalError.UndefiendError	Undefined error.
InvalidParameter	Incorrect parameter.
InvalidParameter.AccountExist	A bound account already exists.
InvalidParameter.RecordExist	The record already exists.
InvalidParameter.RecordNotExist	The record does not exist.
InvalidParameterValue	Incorrect parameter value.
LimitExceeded	The quota limit is exceeded.
MissingParameter	Missing parameter.
OperationDenied	The operation was denied.
RequestLimitExceeded	The number of requests exceeds the frequency limit.
ResourceInUse	The resource is in use.
ResourceInsufficient	Insufficient resource.
ResourceNotFound	The resource does not exist.
ResourceNotFound.ServiceNotSubscribed	The Private DNS service is not activated.
ResourceUnavailable	The resource is unavailable.
ResourcesSoldOut	The resources have been sold out.
UnauthorizedOperation	Unauthorized operation.
UnauthorizedOperation.UnauthorizedAccount	Unverified user.
UnknownParameter	Unknown parameter.
UnsupportedOperation	Unsupported operation.

Bantuan dan Dukungan

Apakah halaman ini membantu?

Anda juga dapat Menghubungi Penjualan atau Mengirimkan Tiket untuk meminta bantuan.

masukan

tencent cloud

私有域解析 Private DNS