修改单个Record Set
功能介绍
修改单个Record Set
调用方法
请参见如何调用API。
URI
PUT /v2/zones/{zone_id}/recordsets/{recordset_id}
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
zone_id |
是 |
String |
所属zone的ID。 |
recordset_id |
是 |
String |
待修改的recordset的ID信息。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
是 |
String |
域名，后缀需以zone name结束且为FQDN（即以“.”号结束的完整主机名）。 |
description |
否 |
String |
可选配置，对域名的描述。 |
type |
是 |
String |
Record Set的类型。 |
ttl |
否 |
Integer |
解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 |
records |
否 |
Array of strings |
解析记录的值。不同类型解析记录对应的值的规则不同。 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
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。 内网支持修改类型：A、AAAA、MX、CNAME、TXT、SRV。 |
ttl |
Integer |
解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 |
records |
Array of strings |
域名解析后的值。 |
create_at |
String |
创建时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS |
update_at |
String |
更新时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS |
status |
String |
资源状态。 |
default |
Boolean |
标识是否由系统默认生成，系统默认生成的Record Set不能删除。 |
project_id |
String |
该Record Set所属的项目ID。 |
links |
pageLink object |
指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 |
请求示例
修改单个解析记录，设置类型为A，TTL为3600秒，解析记录值为 "192.168.10.1"、"192.168.10.2"。
PUT https://{endpoint}/v2/zones/{zone_id}/recordsets/{recordset_id}
{
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 3600,
"records" : [ "192.168.10.1", "192.168.10.2" ]
}
响应示例
状态码： 202
修改单个Record Set响应。
{
"id" : "2c9eb155587228570158722b6ac30007",
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 3600,
"records" : [ "192.168.10.1", "192.168.10.2" ],
"status" : "PENDING_UPDATE",
"links" : {
"self" : "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
},
"zone_id" : "2c9eb155587194ec01587224c9f90149",
"zone_name" : "example.com.",
"create_at" : "2016-11-17T12:03:17.827",
"update_at" : "2016-11-17T12:56:03.827",
"default" : false,
"project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c"
}
状态码
状态码 |
描述 |
|---|---|
202 |
修改单个Record Set响应。 |
错误码
请参见错误码。
