文档首页/ 云解析服务 DNS/ API参考 (巴黎区域)/ API/ Record Set多线路管理/ 创建Record Set

更新时间：2024-03-14 GMT+08:00

查看PDF

创建Record Set

功能介绍

创建单个Record Set。

仅公网域名支持创建多线路Record Set，该接口仅适用于公网DNS。

URI

POST /v2.1/zones/{zone_id}/recordsets

参数说明请参见表1。

表1 URI格式的参数说明
名称	是否必选	参数类型	说明
zone_id	是	String	所属zone的ID。仅支持公网zone。可以通过查询公网Zone列表获取。

请求

参数说明

表2 请求样例的参数说明
名称	是否必选	参数类型	说明
name	是	String	域名，后缀需以zone name结束且为FQDN（即以“.”号结束的完整主机名）。域名格式不区分大小写，系统会将输入的大写字母统一转换为小写。
description	否	String	可选配置，对域名的描述。长度不超过255个字符。默认值为空。
type	是	String	Record Set的类型。取值范围：A、AAAA、MX、CNAME、TXT、NS、SRV、CAA。详细信息请参见解析记录类型。
status	否	String	解析记录的状态。取值范围： ENABLE，表示创建启用状态的解析记录。 DISABLE，表示创建暂停状态的解析记录。当参数为空时：若域名状态为“正常”时，默认创建的Record Set状态为“正常”。若域名状态为“暂停”时，默认创建的Record Set状态为“暂停”。
ttl	否	Integer	解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。取值范围：公网解析：1~2147483647。内网解析：300~2147483647。默认值为300s。
records	否	Array of strings	解析记录的值。不同类型解析记录对应的值的规则不同。如Type为AAAA类型，Value是域名对应的IPv6地址列表。别名记录时，该值不用填。
line	否	String	解析线路ID。默认值为默认线路。
tags	否	Array of object	资源标签。详细信息请参见表3。默认值为空。
weight	否	Integer	解析记录的权重。当不填时，取默认值1。当weight=0，表示备用域名解析记录。当weight>0，表示主用域名解析记录。取值范围：0~1000。相同名称、相同记录集类型、相同线路下的域名，权重记录集个数的上限是20。
alias_target	否	Object	别名记录。详细信息请参见表4。默认值为空。

表3 tags对象参数说明
名称	是否必选	参数类型	说明
key	是	String	键。最大长度36个unicode字符。 key不能为空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“\|”和“/”，且首尾字符不能为空格。
value	否	String	值。每个值最大长度43个unicode字符，可以为空字符串。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“\|”和“/”，且首尾字符不能为空格。

表4 alias_target对象参数说明
名称	是否必选	参数类型	说明
resource_type	否	String	资源服务类型，支持别名记录的服务。取值： cloudsite：云速建站 waf：Web应用防火墙
resource_domain_name	否	String	对应服务下的域名，由各服务提供。

请求样例

为Zone ID为“2c9eb155587194ec01587224c9f90149”的域名添加记录集。

POST https://{DNS_Endpoint}/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets

A类型

{
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "A",
    "ttl": 3600,
    "records": [
        "192.168.10.1",
        "192.168.10.2"
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

AAAA类型

{
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "AAAA",
    "ttl": 3600,
    "records": [
        "fe80:0:0:0:202:b3ff:fe1e:8329",
        "ff03:0db8:85a3:0:0:8a2e:0370:7334"
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

MX类型

{
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "MX",
    "ttl": 3600,
    "records": [
        "1 mail.example.com"
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

CNAME类型

{
    "name": "sale.example.com.",
    "description": "This is an example record set.",
    "type": "CNAME",
    "ttl": 3600,
    "records": [
        "server1.example.com"
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

TXT类型

{
    "name": "server1.example.com.",
    "description": "This is an example record set.",
    "type": "TXT",
    "ttl": 300,
    "records": [
        "\"This host is used for sale.\""
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

NS类型

{
    "name": "server1.example.com.",
    "description": "This is an example record set.",
    "type": "NS",
    "ttl": 300,
    "records": [
        "node1.example.com.",
        "node2.example.com."
    ],
    "line":"default_view",
    "weight": 1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

SRV类型

{
    "name": "_sip._tcp.example.com.",
    "description": "This is an example record set.",
    "type": "SRV",
    "ttl": 300,
    "records": [
        "3 60 2176 sipserver.example.com.",
        "10 100 2176 sipserver.example.com."
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

CAA类型

{
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "CAA",
    "ttl": 300,
    "records": [
        "0 issue \"example.com\"",
        "0 issuewild \"www.certinomis.com\"",
        "0 iodef \"mailto:xx@example.org\"",
        "0 iodef \"http://iodef.example.com\""
    ],
    "line":"default_view",
    "weight":1,
    "tags": [
        {
          "key": "key1",
          "value": "value1"
        }
    ]
}

A类型（alias）

{
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "A",
    "ttl": 3600,
    "alias_target": {
                 "resource_type": "cloudsite",
                 "resource_domain_name": "2018122211053616ucavdwdh.cname.ysjianzhan.cn."
            }
}

响应

参数说明

表5 响应样例的参数说明
名称	参数类型	说明
id	String	Record Set的ID。
name	String	Record Set的名称。
description	String	Record Set的描述信息。
zone_id	String	托管该记录的zone_id。
zone_name	String	托管该记录的zone_name。
type	String	记录类型。取值范围：A、AAAA、MX、CNAME、TXT、NS、SRV、CAA。详细信息请参见解析记录类型。
ttl	Integer	解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。
records	Array of strings	域名解析后的值。
created_at	String	创建时间。采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
updated_at	String	更新时间。采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
status	String	资源状态。详细信息请参见资源状态。
default	Boolean	标识是否由系统默认生成，系统默认生成的Record Set不能删除。
project_id	String	该Record Set所属的项目ID。
links	Object	指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。详细信息请参见表6。
line	String	解析线路ID。
weight	Integer	解析记录的权重。
health_check_id	String	健康检查ID。
alias_target	Object	别名记录。详细信息请参见表4。

表6 links参数说明
名称	参数类型	说明
self	String	当前资源的链接。
next	String	下一页资源的链接。

响应样例

{
    "id": "2c9eb155587228570158722b6ac30007",
    "name": "www.example.com.",
    "description": "This is an example record set.",
    "type": "A",
    "ttl": 300,
    "records": [
        "192.168.10.1",
        "192.168.10.2"
    ],
    "status": "PENDING_CREATE",
    "links": {
        "self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
    },
    "zone_id": "2c9eb155587194ec01587224c9f90149",
    "zone_name": "example.com.",
    "created_at": "2016-11-17T12:03:17.827",
    "updated_at": null,
    "default": false,
    "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line": "default_view",
    "weight": 1,
    "health_check_id":null
}

返回值

接口正常的返回值为2xx，例如200、202或者204。

返回值含义以及更多返回值请参考状态码。

父主题： Record Set多线路管理

上一篇：Record Set多线路管理

下一篇：查询Record Set

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消