API 中心
开发与运维产品文档捉虫活动邀您参加！> HOT
文档中心>API 中心>边缘安全加速平台 EO>DNS 记录相关接口>创建 DNS 记录

创建 DNS 记录

最近更新时间：2024-12-30 14:49:06

我的收藏

本页目录：

1. 接口描述

接口请求域名： teo.tencentcloudapi.com 。

在创建完站点后，并且站点为 NS 模式接入时，您可以通过本接口创建 DNS 记录。

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：CreateDnsRecord。
Version 是 String 公共参数，本接口取值：2022-09-01。
Region 否 String 公共参数，此参数为可选参数。
ZoneId 是 String 站点 ID。
Name 是 String DNS 记录名，如果是中文、韩文、日文域名，需要转换为 punycode 后输入。
Type 是 String DNS 记录类型，取值有：
  • A：将域名指向一个外网 IPv4 地址，如 8.8.8.8；
  • AAAA：将域名指向一个外网 IPv6 地址；
  • MX：用于邮箱服务器。存在多条 MX 记录时，优先级越低越优先；
  • CNAME：将域名指向另一个域名，再由该域名解析出最终 IP 地址；
  • TXT：对域名进行标识和说明，常用于域名验证和 SPF 记录（反垃圾邮件）；
  • NS：如果需要将子域名交给其他 DNS 服务商解析，则需要添加 NS 记录。根域名无法添加 NS 记录；
  • CAA：指定可为本站点颁发证书的 CA；
  • SRV：标识某台服务器使用了某个服务，常见于微软系统的目录管理。

    • 不同的记录类型呢例如 SRV、CAA 记录对主机记录名称、记录值格式有不同的要求，各记录类型的详细说明介绍和格式示例请参考：解析记录类型介绍。
    Content 是 String DNS 记录内容，根据 Type 值填入与之相对应的内容，如果是中文、韩文、日文域名，需要转换为 punycode 后输入。
    Location 否 String DNS 记录解析线路，不指定默认为 Default，表示默认解析线路，代表全部地域生效。

    - 解析线路配置仅适用于当 Type（DNS 记录类型）为 A、AAAA、CNAME 时。
    - 解析线路配置仅适用于标准版、企业版套餐使用，取值请参考：解析线路及对应代码枚举。
    TTL 否 Integer 缓存时间，用户可指定值范围 60~86400，数值越小，修改记录各地生效时间越快，默认为 300，单位：秒。
    Weight 否 Integer DNS 记录权重，用户可指定值范围 -1~100，设置为 0 时表示不解析，不指定默认为 -1，表示不设置权重。权重配置仅适用于当 Type（DNS 记录类型）为 A、AAAA、CNAME 时。
    注意：同一个子域名下，相同解析线路的不同 DNS 记录，应保持同时设置权重或者同时都不设置权重。
    Priority 否 Integer MX 记录优先级，该参数仅在当 Type（DNS 记录类型）为 MX 时生效，值越小优先级越高，用户可指定值范围0~50，不指定默认为0。

    3. 输出参数

    参数名称 类型 描述
    RecordId String DNS 记录 ID。
    RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 创建 DNS 记录

    在 ZoneId 为 zone-225qgrnvbi9w 的站点下，创建一个记录名为 www.example.com，记录类型为 A，记录内容为1.2.3.4，缓存时间为60秒的 DNS 记录。

    输入示例

    POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateDnsRecord
<公共请求参数>

{
    "ZoneId": "zone-225qgrnvbi9w",
    "Name": "www.example.com",
    "Type": "A",
    "Content": "1.2.3.4",
    "TTL": 60
}

    输出示例

    {
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707",
        "RecordId": "record-225rcy8bw85g"
    }
}

    示例2 创建分配权重的 DNS 记录

    在 ZoneId 为 zone-225qgrnvbi9w 的站点下，创建一个记录名为 www.example.com，记录类型为 A，记录内容为1.2.3.4，缓存时间为60秒，记录权重为100的 DNS 记录。

    输入示例

    POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateDnsRecord
<公共请求参数>

{
    "ZoneId": "zone-225qgrnvbi9w",
    "Name": "www.example.com",
    "Type": "A",
    "Content": "1.2.3.4",
    "TTL": 60,
    "Weight": 100
}

    输出示例

    {
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707",
        "RecordId": "record-225rcy8bw85g"
    }
}

    示例3 创建分配解析线路的 DNS 记录

    在 ZoneId 为 zone-225qgrnvbi9w 的站点下，创建一个记录名为 www.example.com，记录类型为 A，解析线路为北京（CN.BJ），记录内容为1.2.3.4，缓存时间为60秒的 DNS 记录。

    输入示例

    POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateDnsRecord
<公共请求参数>

{
    "ZoneId": "zone-225qgrnvbi9w",
    "Name": "www.example.com",
    "Type": "A",
    "Location": "CN.BJ",
    "Content": "1.2.3.4",
    "TTL": 60
}

    输出示例

    {
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707",
        "RecordId": "record-225rcy8bw85g"
    }
}

    5. 开发者资源

    腾讯云 API 平台

    腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

    API Inspector

    用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

    SDK

    云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

    命令行工具

    6. 错误码

    该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。

    中国站
    文档活动
    message-icon联系我们
    目录