添加私有域解析记录

最近更新时间: 2026-10-11 00:12:40

1. 接口描述

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

添加私有域解析记录

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

接口更新时间：2026-02-05 11:34:25。

接口只验签名不鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：CreatePrivateZoneRecord
Version 是 否 String 公共参数，本接口取值：2019-10-25
Region 是 否 String 公共参数，地域信息本接口不需要传递此参数。
SubDomain 是 是 String 子域名，例如 "www", "m", "@"
示例值： b
RecordValue 是 是 String 记录值，例如 IP：192.168.10.2，CNAME：cname.test.com.，MX：mail.test.com.
示例值： 3.3.3.3
Weight 否 是 Int64 记录权重，值为1-100
示例值： 100
Remark 否 是 String 备注
示例值： 这是备注
ZoneId 是 是 String 私有域ID
示例值： zone-p0152fh2
RecordType 是 是 String 记录类型，可选的记录类型为："A", "AAAA", "CNAME", "MX", "TXT", "PTR"
示例值： A
MX 否 是 Int64 MX优先级：记录类型为MX时必填。取值范围：5,10,15,20,30,40,50
示例值： 15
TTL 否 是 Int64 记录缓存时间，数值越小生效越快，取值1-86400s, 默认 600
示例值： 600
SystemUin 否 是 String 系统帐户uin，需要加白使用
示例值： 100000000328

3. 输出参数

参数名称 类型 描述
RecordId String 记录Id
示例值： 15421
CreatedAt Datetime 请求返回时间
示例值： 2014-08-03 12:00:00
CreatedAtIso Datetime_iso 请求响应时间Iso
示例值： 2024-06-04T15:30:00Z
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码 描述
InvalidParameter
InvalidParameterValue
MissingParameter
UnknownParameter
InternalError
UnauthorizedOperation
UnsupportedOperation
ResourceNotFound
LimitExceeded
ResourceUnavailable
ResourceInsufficient
FailedOperation
ResourceInUse
DryRunOperation
ResourcesSoldOut
AuthFailure
OperationDenied
RequestLimitExceeded
InternalError.UndefiendError 错误未定义
InvalidParameter.IllegalRecord 记录不合法
InvalidParameter.IllegalRecordValue 无效的记录值
InvalidParameter.ZoneNotExists 解析域不存在
InvalidParameter.RecordExist
InvalidParameter.RecordUnsupportWeight
InvalidParameter.IllegalPTRRecord PTR记录非法
FailedOperation.CreateRecordFailed 记录创建失败
InvalidParameter.RecordConflict
InvalidParameter.RecordACountExceed
InvalidParameter.RecordAAAACountExceed
InvalidParameter.RecordMXCountExceed
InvalidParameter.RecordTXTCountExceed
InvalidParameter.RecordCNAMECountExceed
UnauthorizedOperation.UnauthorizedAccount
InvalidParameter.RecordCountExceed
InvalidParameter.InvalidMX
ResourceNotFound.ServiceNotSubscribed
InvalidParameter.VpcBindedMainDomain
LimitExceeded.TldOutOfLimit
ResourceUnavailable.TldPackageExpired
InvalidParameterValue.IllegalTTLValue
FailedOperation.DataError
InvalidParameter.MXNotSupported
InvalidParameter.RecordRollLimitCountExceed

5. 示例

示例1 私有域-添加MX记录

添加MX记录

输入示例

{
    "ZoneId": "zone-p0152fh2",
    "RecordType": "MX",
    "SubDomain": "b",
    "RecordValue": "3.3.3.3",
    "Weight": 100,
    "MX": 5
}

输出示例

{
    "Response": {
        "RequestId": "a98891db-9d73-514a-8751422197b540cd",
        "RecordId": "15421"
    }
}

示例2 私有域-添加PTR记录

添加反解析记录

输入示例

{
    "ZoneId": "zone-p0152fh2",
    "RecordType": "PTR",
    "SubDomain": "1.1.1",
    "RecordValue": "test.com"
}

输出示例

{
    "Response": {
        "RequestId": "a98891db-9d73-514a-8751422197b540cd",
        "RecordId": "15421"
    }
}

示例3 私有域-添加A记录

添加A记录

输入示例

{
    "ZoneId": "zone-p0152fh2",
    "RecordType": "A",
    "SubDomain": "b",
    "RecordValue": "3.3.3.3",
    "Weight": 100,
    "TTL": 600
}

输出示例

{
    "Response": {
        "RequestId": "a98891db-9d73-514a-8751422197b540cd",
        "RecordId": "15421"
    }
}