# Tencent Cloud Private DNS API

> Tencent Cloud Private DNS API on Apizie: 40 endpoints (Add Specify Private Zone Vpc, Create Extend Endpoint, Create Forward Rule, Create Inbound Endpoint, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:tencent-privatedns/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-privatedns`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-privatedns
- OpenAPI: https://apizie.tech/api/cloud/tencent-privatedns/openapi.json

Tencent Cloud API 3.0 for Private DNS (privatedns). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Add Specify Private Zone Vpc
`POST https://apizie.tech/v1/cloud:tencent-privatedns/add-specify-private-zone-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| VpcSet | array | no |  |
| AccountVpcSet | array | no |  |
| Sync | boolean | no |  |

### Create Extend Endpoint
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-extend-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Create Forward Rule
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-forward-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleName | string | yes |  |
| RuleType | string | yes |  |
| ZoneId | string | yes |  |
| EndPointId | string | yes |  |

### Create Inbound Endpoint
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-inbound-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EndpointName | string | yes |  |
| EndpointRegion | string | yes |  |
| EndpointVpc | string | yes |  |
| SubnetIp | array | yes |  |

### Create Private DNSAccount
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-private-dnsaccount` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Account | object | yes |  |

### Create Private Zone
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-private-zone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Domain | string | yes |  |
| TagSet | array | no |  |
| VpcSet | array | no |  |
| Remark | string | no |  |
| DnsForwardStatus | string | no |  |
| AccountVpcSet | array | no |  |
| CnameSpeedupStatus | string | no |  |

### Create Private Zone List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-private-zone-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Domains | array | yes |  |

### Create Private Zone Record
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-private-zone-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| RecordType | string | yes |  |
| SubDomain | string | yes |  |
| RecordValue | string | yes |  |
| Weight | integer | no |  |
| MX | integer | no |  |
| TTL | integer | no |  |
| Remark | string | no |  |

### Create Private Zone Record List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/create-private-zone-record-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneIds | array | yes |  |
| RecordsInfo | array | yes |  |

### Delete End Point
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-end-point` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EndPointId | string | no |  |

### Delete Forward Rule
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-forward-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleIdSet | array | no |  |

### Delete Inbound Endpoint
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-inbound-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EndpointId | string | yes |  |

### Delete Private DNSAccount
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-private-dnsaccount` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Account | object | yes |  |

### Delete Private Zone
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-private-zone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | no |  |
| ZoneIdSet | array | no |  |

### Delete Private Zone Record
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-private-zone-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | no |  |
| RecordId | string | no |  |
| RecordIdSet | array | no |  |

### Delete Specify Private Zone Vpc
`POST https://apizie.tech/v1/cloud:tencent-privatedns/delete-specify-private-zone-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| VpcSet | array | no |  |
| AccountVpcSet | array | no |  |
| Sync | boolean | no |  |

### Describe Account Vpc List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-account-vpc-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AccountUin | string | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Audit Log
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-audit-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TimeRangeBegin | string | yes |  |
| Filters | array | no |  |
| TimeRangeEnd | string | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Describe Create Record List Result
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-create-record-list-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneIds | array | yes |  |
| RecordsInfo | array | yes |  |

### Describe Create Zone List Result
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-create-zone-list-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Domains | array | yes |  |

### Describe Dashboard
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-dashboard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Describe Extend Endpoint List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-extend-endpoint-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Forward Rule List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-forward-rule-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Inbound Endpoint List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-inbound-endpoint-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Private DNSAccount List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-private-dnsaccount-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Private Zone
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-private-zone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |

### Describe Private Zone List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-private-zone-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Describe Private Zone Record List
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-private-zone-record-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| Filters | array | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Describe Private Zone Service
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-private-zone-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Describe Quota Usage
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-quota-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Describe Record
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| RecordId | string | yes |  |

### Describe Request Data
`POST https://apizie.tech/v1/cloud:tencent-privatedns/describe-request-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TimeRangeBegin | string | yes |  |
| Filters | array | no |  |
| TimeRangeEnd | string | no |  |
| Export | boolean | no |  |

### Modify Forward Rule
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-forward-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| RuleName | string | no |  |
| EndPointId | string | no |  |

### Modify Inbound Endpoint
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-inbound-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EndpointId | string | yes |  |
| EndpointName | string | yes |  |

### Modify Private Zone
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-private-zone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| Remark | string | no |  |
| DnsForwardStatus | string | no |  |
| CnameSpeedupStatus | string | no |  |

### Modify Private Zone Record
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-private-zone-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| RecordId | string | yes |  |
| RecordType | string | yes |  |
| SubDomain | string | yes |  |
| RecordValue | string | yes |  |
| Weight | integer | no |  |
| MX | integer | no |  |
| TTL | integer | no |  |
| Remark | string | no |  |

### Modify Private Zone Vpc
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-private-zone-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| VpcSet | array | no |  |
| AccountVpcSet | array | no |  |

### Modify Records Status
`POST https://apizie.tech/v1/cloud:tencent-privatedns/modify-records-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ZoneId | string | yes |  |
| RecordIds | array | yes |  |
| Status | string | yes |  |

### Query Async Bind Vpc Status
`POST https://apizie.tech/v1/cloud:tencent-privatedns/query-async-bind-vpc-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| UniqId | string | yes |  |

### Subscribe Private Zone Service
`POST https://apizie.tech/v1/cloud:tencent-privatedns/subscribe-private-zone-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-privatedns/add-specify-private-zone-vpc" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Private DNS API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-privatedns/add-specify-private-zone-vpc with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Private DNS API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Private DNS itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Private DNS API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-privatedns.

### What is the status of the Tencent Cloud Private DNS API?
Needs your own provider key (bring your own key)