History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
Records to be bulk added
Used by actions: CreateRecordBatch.
| Name | Type | Required | Description |
|---|---|---|---|
| RecordType | String | Yes | Record type. For more information, see the DescribeRecordType API. |
| Value | String | Yes | Record value. |
| SubDomain | String | No | Subdomain (host record), which is @ by default. |
| RecordLine | String | No | Split zone of the DNS record. For more information, see the DescribeRecordLineList API. If neither RecordLine nor RecordLineId is specified, the default split zone will be used. |
| RecordLineId | String | No | Split zone ID of the DNS record. If both RecordLine and RecordLineId are specified, RecordLineId will be used. |
| Weight | Integer | No | The record weight (not supported). |
| MX | Integer | No | MX record value. It is 0 by default for non-MX records and required for MX records. |
| TTL | Integer | No | TTL value of the record, which is 600 by default. |
| Enabled | Integer | No | Record status (not supported). Valid values: 0 (disabled); 1 (enabled). Default value: 1. |
| Remark | String | No | Record remarks (not supported). |
Record information in the bulk task
Used by actions: ModifyRecordBatch.
| Name | Type | Description |
|---|---|---|
| RecordId | Integer | Record ID Note: This field may return null, indicating that no valid values can be obtained. |
| SubDomain | String | Subdomain (host record). Note: This field may return null, indicating that no valid values can be obtained. |
| RecordType | String | Record type. For more information, see the DescribeRecordType API.Note: This field may return null, indicating that no valid values can be obtained. |
| RecordLine | String | Split zone of the DNS record. For more information, see the DescribeRecordLineList API.Note: This field may return null, indicating that no valid values can be obtained. |
| Value | String | Record value Note: This field may return null, indicating that no valid values can be obtained. |
| TTL | Integer | TTL value of the record Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Record adding status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | ID of the record in the list |
| Enabled | Integer | Record status Note: This field may return null, indicating that no valid values can be obtained. |
| MX | Integer | MX weight of the record Note: This field may return null, indicating that no valid values can be obtained. |
| Weight | Integer | The record weight. Note: This field may return null, indicating that no valid values can be obtained. |
Response structure for bulk adding domains
Used by actions: CreateDomainBatch.
| Name | Type | Description |
|---|---|---|
| RecordList | Array of CreateDomainBatchRecord | See RecordInfoBatch.Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | Task ID |
| Domain | String | Domain Note: This field may return null, indicating that no valid values can be obtained. |
| DomainGrade | String | Domain level Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Task running status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
Record information in the task of bulk adding domains
Used by actions: CreateDomainBatch.
| Name | Type | Description |
|---|---|---|
| SubDomain | String | Subdomain (host record). Note: This field may return null, indicating that no valid values can be obtained. |
| RecordType | String | Record type. For more information, see the DescribeRecordType API.Note: This field may return null, indicating that no valid values can be obtained. |
| RecordLine | String | Split zone of the DNS record. For more information, see the DescribeRecordLineList API.Note: This field may return null, indicating that no valid values can be obtained. |
| Value | String | Record value Note: This field may return null, indicating that no valid values can be obtained. |
| TTL | Integer | TTL value of the record Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Record adding status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | ID of the record in the list |
Response structure for bulk adding records
Used by actions: CreateRecordBatch.
| Name | Type | Description |
|---|---|---|
| RecordList | Array of CreateRecordBatchRecord | See RecordInfoBatch.Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | Task ID |
| Domain | String | Domain Note: This field may return null, indicating that no valid values can be obtained. |
| DomainGrade | String | Domain level Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Task running status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
| DomainId | Integer | Domain ID Note: This field may return null, indicating that no valid values can be obtained. |
Record information in the task of bulk adding records
Used by actions: CreateRecordBatch.
| Name | Type | Description |
|---|---|---|
| SubDomain | String | Subdomain (host record). Note: This field may return null, indicating that no valid values can be obtained. |
| RecordType | String | Record type. For more information, see the DescribeRecordType API.Note: This field may return null, indicating that no valid values can be obtained. |
| RecordLine | String | Split zone of the DNS record. For more information, see the DescribeRecordLineList API.Note: This field may return null, indicating that no valid values can be obtained. |
| Value | String | Record value Note: This field may return null, indicating that no valid values can be obtained. |
| TTL | Integer | TTL value of the record Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Record adding status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | ID of the record in the list |
| MX | Integer | MX weight of the record Note: This field may return null, indicating that no valid values can be obtained. |
| Weight | Integer | The record weight. Note: This field may return null, indicating that no valid values can be obtained. |
Details of batch deleting domains
Used by actions: DeleteDomainBatch.
| Name | Type | Description |
|---|---|---|
| DomainId | Integer | The domain ID. |
| Domain | String | The domain name. |
| Error | String | The error message. Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | The domain deletion status. |
| Operation | String | The operation. |
Information of a domain alias
Used by actions: DescribeDomainAliasList.
| Name | Type | Description |
|---|---|---|
| Id | Integer | Domain alias ID |
| DomainAlias | String | Domain alias |
DNS query volume in the current statistical dimension
Used by actions: DescribeSubdomainAnalytics.
| Name | Type | Description |
|---|---|---|
| Num | Integer | DNS query volume in the current statistical dimension |
| DateKey | String | Collection date for daily collection |
| HourKey | Integer | The last hour (0–23) for hourly collection. For example, if HourKey is 23, the DNS query volume in the statistical period of 22:00–23:00 will be collected.Note: This field may return null, indicating that no valid values can be obtained. |
List statistics by page
Used by actions: DescribeDomainList.
| Name | Type | Description |
|---|---|---|
| DomainTotal | Integer | Number of eligible domains |
| AllTotal | Integer | Number of all domains that can be viewed by the user |
| MineTotal | Integer | Number of domains added under the user account |
| ShareTotal | Integer | Number of domains shared with the user |
| VipTotal | Integer | Number of paid domains |
| PauseTotal | Integer | Number of suspended domains |
| ErrorTotal | Integer | Number of domains with a DNS configuration error |
| LockTotal | Integer | Number of locked domains |
| SpamTotal | Integer | Number of blocked domains |
| VipExpire | Integer | Number of domains that will expire within 30 days |
| ShareOutTotal | Integer | Number of domains shared with others |
| GroupTotal | Integer | Number of domains in the specified group |
Domain information returned during domain creation
Used by actions: CreateDomain.
| Name | Type | Description |
|---|---|---|
| Id | Integer | Domain ID |
| Domain | String | Domain |
| Punycode | String | Domain Punycode |
| GradeNsList | Array of String | NS list of the domain |
Domain details
Used by actions: DescribeDomain.
| Name | Type | Description |
|---|---|---|
| DomainId | Integer | Domain ID |
| Status | String | Domain status |
| Grade | String | DNS plan level |
| GroupId | Integer | Domain group ID |
| IsMark | String | Whether the domain is starred |
| TTL | Integer | TTL (DNS record cache time) |
| CnameSpeedup | String | Whether CNAME flattening is enabled |
| Remark | String | Domain remarks Note: This field may return null, indicating that no valid values can be obtained. |
| Punycode | String | Domain Punycode |
| DnsStatus | String | DNS status of the domain |
| DnspodNsList | Array of String | NS list of the domain |
| Domain | String | Domain |
| GradeLevel | Integer | Domain level ID |
| UserId | Integer | Domain user ID |
| IsVip | String | Whether the domain is a VIP domain |
| Owner | String | Domain owner account |
| GradeTitle | String | Domain level description |
| CreatedOn | Timestamp | Domain creation time |
| UpdatedOn | Timestamp | Last update time |
| Uin | String | Tencent Cloud account Uin |
| ActualNsList | Array of String | NS list actually used by the domain Note: This field may return null, indicating that no valid values can be obtained. |
| RecordCount | Integer | Number of domain records |
| OwnerNick | String | Alias of the domain account owner Note: This field may return null, indicating that no valid values can be obtained. |
Element in the domain list
Used by actions: DescribeDomainList.
| Name | Type | Description |
|---|---|---|
| DomainId | Integer | Unique ID assigned to the domain by the system |
| Name | String | Original format of the domain |
| Status | String | Domain status. Valid values: ENABLE (normal), PAUSE (suspended), SPAM (blocked). |
| TTL | Integer | Default TTL of the default DNS record of the domain |
| CNAMESpeedup | String | Whether CNAME flattening is enabled. Valid values: ENABLE (enabled); DISABLE (disabled). |
| DNSStatus | String | DNS configuration status. Valid values: DNSERROR (error), an empty string (normal). |
| Grade | String | Plan level code of the domain |
| GroupId | Integer | Group ID of the domain |
| SearchEnginePush | String | Whether search engine push optimization is enabled. Valid values: YES (yes), NO (no). |
| Remark | String | Domain remarks |
| Punycode | String | Punycode-encoded domain format |
| EffectiveDNS | Array of String | Effective DNS assigned to the domain by the system |
| GradeLevel | Integer | Number corresponding to the plan level of the domain |
| GradeTitle | String | Plan name |
| IsVip | String | Whether it is a paid plan |
| VipStartAt | Timestamp | Activation time of the paid plan |
| VipEndAt | Timestamp | Expiry time of the paid plan |
| VipAutoRenew | String | Whether VIP automatic renewal is enabled for the domain. Valid values: YES (yes); NO (no). Default value: DEFAULT. |
| RecordCount | Integer | Number of records under the domain |
| CreatedOn | Timestamp | Domain adding time |
| UpdatedOn | Timestamp | Domain update time |
| Owner | String | Account of the domain |
Domain sharing information
Used by actions: DescribeDomainShareInfo.
| Name | Type | Description |
|---|---|---|
| ShareTo | String | Account with which the domain is shared |
| Mode | String | Sharing mode. Valid values: rw (read/write), r (read-only). |
| Status | String | Sharing status. Valid values: enabled (shared successfully); pending (the account shared to does not exist and is pending registration). |
List of domain groups
Used by actions: DescribeDomainGroupList.
| Name | Type | Description |
|---|---|---|
| GroupId | Integer | Group ID |
| GroupName | String | Group name |
| GroupType | String | Group type |
| Size | Integer | Number of domains in the group |
Information of a split zone group
Used by actions: DescribeRecordLineList.
| Name | Type | Description |
|---|---|---|
| LineId | String | Split zone group ID |
| Name | String | Split zone group name |
| Type | String | Group type |
| LineList | Array of String | List of split zones in the split zone group |
Information of a split zone
Used by actions: DescribeRecordLineList.
| Name | Type | Description |
|---|---|---|
| Name | String | Split zone name |
| LineId | String | Split zone ID |
Describes the line information of dns records.
Used by actions: DescribeRecordLineCategoryList.
| Name | Type | Description |
|---|---|---|
| LineName | String | Parses the line name. |
| LineId | String | Resolution route ID. Note: This field may return null, indicating that no valid values can be obtained. |
| Useful | Boolean | Indicates whether the current line is available under the current domain. |
| Grade | String | Current line min plan level requirement. Note: This field may return null, indicating that no valid values can be obtained. |
| SubGroup | Array of LineItem | Describes the sub-line list under the current line category. Note: This field may return null, indicating that no valid values can be obtained. |
| Lines | Array of String | Specifies the lines included in the custom line grouping. Note: This field may return null, indicating that no valid values can be obtained. |
Domain lock information
Used by actions: ModifyDomainLock.
| Name | Type | Description |
|---|---|---|
| DomainId | Integer | Domain ID |
| LockCode | String | Domain unlock code |
| LockEnd | Date | Automatic unlock date of the domain |
Response structure for bulk adding records
Used by actions: ModifyRecordBatch.
| Name | Type | Description |
|---|---|---|
| RecordList | Array of BatchRecordInfo | See RecordInfoBatchModify.Note: This field may return null, indicating that no valid values can be obtained. |
| Id | Integer | Task ID |
| Domain | String | Domain Note: This field may return null, indicating that no valid values can be obtained. |
| DomainGrade | String | Domain level Note: This field may return null, indicating that no valid values can be obtained. |
| ErrMsg | String | Error message Note: This field may return null, indicating that no valid values can be obtained. |
| Status | String | Task running status Note: This field may return null, indicating that no valid values can be obtained. |
| Operation | String | Operation type Note: This field may return null, indicating that no valid values can be obtained. |
| DomainId | Integer | Domain ID Note: This field may return null, indicating that no valid values can be obtained. |
Domain permission
Used by actions: DescribeDomainPurview.
| Name | Type | Description |
|---|---|---|
| Name | String | Permission name |
| Value | String | Permission value |
Count info of the queried record list
Used by actions: DescribeRecordList.
| Name | Type | Description |
|---|---|---|
| SubdomainCount | Integer | The subdomain count. |
| ListCount | Integer | The count of records returned in the list. |
| TotalCount | Integer | The total record count. |
Information of a DNS record group
Used by actions: DescribeRecordGroupList.
| Name | Type | Description |
|---|---|---|
| GroupId | Integer | Group ID |
| GroupName | String | Group name |
| GroupType | String | Group type. Valid values: system, user. |
Record information
Used by actions: DescribeRecord.
| Name | Type | Description |
|---|---|---|
| Id | Integer | Record ID. |
| SubDomain | String | Subdomain (host record). |
| RecordType | String | Record type. For more information, see the DescribeRecordType API. |
| RecordLine | String | Split zone of the DNS record. For more information, see the DescribeRecordLineList API. |
| RecordLineId | String | Split zone ID of the DNS record. For more information, see the DescribeRecordLineList API. |
| Value | String | Record value. |
| Weight | Integer | Record weight. Note: This field may return null, indicating that no valid values can be obtained. |
| MX | Integer | MX record value. It is 0 by default for non-MX records. |
| TTL | Integer | TTL value of the record. |
| Enabled | Integer | Record status. Valid values: 0 (disabled); 1 (enabled). |
| MonitorStatus | String | D-Monitor status of the record. "Ok" : The server is normal. "Warn" : There is an alarm on this record, and the server returns 4XX. "Down" : The server is down. "" : D-Monitor is disabled for this record. |
| Remark | String | Record remarks. Note: This field may return null, indicating that no valid values can be obtained. |
| UpdatedOn | Timestamp | Last update time of the record. |
| DomainId | Integer | Domain ID. |
Record list elements
Used by actions: DescribeRecordList.
| Name | Type | Description |
|---|---|---|
| RecordId | Integer | The record ID. |
| Value | String | The record value. |
| Status | String | The record status. Valid values: ENABLE (enabled), DISABLE (disabled). |
| UpdatedOn | Timestamp | The update time. |
| Name | String | The host name. |
| Line | String | The record split zone. |
| LineId | String | The split zone ID. |
| Type | String | The record type. |
| Weight | Integer | The record weight, which is required for round-robin DNS records. Note: This field may return null, indicating that no valid values can be obtained. |
| MonitorStatus | String | The monitoring status of the record. Valid values: OK (normal), WARN (warning), and DOWN (downtime). It is empty if no monitoring is set or the monitoring is suspended. |
| Remark | String | The record remarks. |
| TTL | Integer | The record cache time. |
| MX | Integer | The MX value, applicable to the MX record only. Note: This field may return null, indicating that no valid values can be obtained. |
| DefaultNS | Boolean | Whether it is a default NS record. |
DNS query volume of the subdomain alias
Used by actions: DescribeSubdomainAnalytics.
| Name | Type | Description |
|---|---|---|
| Info | SubdomainAnalyticsInfo | Statistics on the DNS query volume of a subdomain |
| Data | Array of DomainAnalyticsDetail | DNS query volume in the current statistical dimension |
Statistics on the DNS query volume of a subdomain
Used by actions: DescribeSubdomainAnalytics.
| Name | Type | Description |
|---|---|---|
| DnsFormat | String | DATE: Daily; HOUR: Hourly |
| DnsTotal | Integer | Total DNS query volume for the current statistical period |
| Domain | String | The queried domain |
| StartDate | String | Start date of the current statistical period |
| EndDate | String | End date of the current statistical period |
| Subdomain | String | Subdomain |
피드백