4.6 PTR Record 管理
4.6.1 设置 PTR Record
"status": "DISABLE", "links": {
"self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/
2c9eb155587228570158722b6ac30007"
},
"zone_id": "2c9eb155587194ec01587224c9f90149", "zone_name": "example.com.",
"created_at": "2017-11-09T11:13:17.827", "updated_at": "2017-11-10T12:03:18.827", "default": false,
"project_id": "e55c6f3dc4e34c9f86353b664ae0e70c", "line": "default_view",
"weight": 1,
"health_check_id":null }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。
4.6 PTR Record 管理
4.6.1 设置 PTR Record
功能介绍
设置弹性IP的PTR记录。
调试
您可以在API Explorer中调试该接口。
URI
PATCH /v2/reverse/floatingips/{region}:{floatingip_id}
参数说明请参见表4-130。
表4-130 URI 格式的参数说明
名称 是否必选 参数类型 说明
region 是 String 租户的区域信息。详细内容请参见
终端节点（Endpoint）。
floatingip_id 是 String 弹性IP的ID。
可以通过网络控制台的弹性公网IP 页面获取或者通过查询弹性公网IP 列表获取。
请求
● 参数说明
表4-131 请求样例的参数说明
名称 是否必选 参数类型 说明
ptrdname 是 String PTR记录对应的域名。
域名格式不区分大小写，系统会 将输入的大写字母统一转换为小 写。
description 否 String 对PTR记录的描述。
默认值为空。
ttl 否 Integer PTR记录在本地DNS服务器的缓
存时间，缓存时间越长更新生效 越慢，以秒为单位。
如果您的服务地址经常更换，建 议TTL值设置相对小些，反之，
建议设置相对大些。
取值范围：
1～2147483647 默认值为300s。
enterprise_pro
ject_id 否 String 反向解析关联的企业项目ID，长 度不超过36个字符。
默认值为0。
tags 否 Array of
object 资源标签。详细信息请参见表 4-132。
默认值为空。
表4-132 tags 对象参数说明
名称 是否必选 参数类
型
说明
key 是 String 键。最大长度36个unicode字符。
key不能为空。不能包含“=”、
“*”、“<”、“>”、“\”、
“,”、“|”和“/”，且首尾字符 不能为空格。
value 否 String 值。每个值最大长度43个unicode字 符，可以为空字符串。 不能包含
“=”、“*”、“<”、“>”、
“\”、“,”、“|”和“/”，且首 尾字符不能为空格。
● 请求样例
设置PTR解析记录，对应的弹性IP的ID为“c5504932-bf23-4171-b655-b87a6bc59334”。
PATCH https://{DNS_Endpoint}/v2/reverse/floatingips/region_id :c5504932-bf23-4171-b655-b87a6bc59334
{ "ptrdname": "www.example.com",
"description": "Description for this PTR record", "ttl": 300,
"tags": [ {
"key": "key1", "value": "value1"
} ] }
响应
● 参数说明
表4-133 响应样例的参数说明
名称 参数类型 说明
id String PTR记录的ID，格式形如{region}:
{floatingip_id}。
ptrdname String PTR记录对应的域名。
description String 对PTR记录的描述。
名称 参数类型 说明
ttl Integer PTR记录在本地DNS服务器的缓存时间，缓存时 间越长更新生效越慢，以秒为单位。
如果您的服务地址经常更换，建议TTL值设置相 对小些，反之，建议设置相对大些。
取值范围：
1～2147483647。
默认值为300s。
address String 弹性IP的IP地址。
status String 资源状态。
详细信息请参见资源状态。
action String 对该资源的当前操作。
取值范围：CREATE，UPDATE，DELETE，
NONE
CREATE：表示创建，UPDATE：表示更新，
DELETE：表示删除，NONE：表示无操作 links Object 指向当前资源或者其他相关资源的链接。
当响应需要分页时，需要包含一个next链接来进 行分页。详细信息请参见表4-134。
表4-134 links 参数说明
名称 参数类型 说明
self String 当前资源的链接。
next String 下一页资源的链接。
● 响应样例
{ "id": "region_id:c5504932-bf23-4171-b655-b87a6bc59334", "ptrdname": "www.example.com.",
"description": "Description for this PTR record", "address": "10.154.52.138",
"action": "CREATE", "ttl": 300,
"status": "PENDING_CREATE", "links": {
"self": "https://Endpoint/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334"
} }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。