4.6 PTR Record 管理
4.6.5 修改 PTR Record
响应
无
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。
4.6.5 修改 PTR Record
功能介绍
修改弹性IP的PTR记录。
调试
您可以在API Explorer中调试该接口。
URI
PATCH /v2/reverse/floatingips/{region}:{floatingip_id}
参数说明请参见表4-146。
表4-146 URI 格式的参数说明
名称 是否必选 参数类型 说明
region 是 String 租户的区域信息。
详细内容请参见终端节点
（Endpoint）。
floatingip_id 是 String 弹性IP的ID。
可以通过网络控制台的弹性公网IP页面 获取或者通过查询弹性公网IP列表获 取。
请求
● 参数说明
表4-147 请求样例的参数说明
名称 是否必选 参数类型 说明
ptrdname 是 String PTR记录对应的域名。
域名格式不区分大小写，系统会将输 入的大写字母统一转换为小写。
description 否 String 对PTR记录的描述。
默认值为空。
ttl 否 Integer PTR记录在本地DNS服务器的缓存时 间，缓存时间越长更新生效越慢，以 秒为单位。
如果您的服务地址经常更换，建议 TTL值设置相对小些，反之，建议设 置相对大些。
取值范围：
1～2147483647 默认值为300s。
tags 否 Array of
object 资源标签。详细信息请参见表 4-148。
默认值为空。
表4-148 tags 对象参数说明
名称 是否必选 参数类
型
说明
key 是 String 键。最大长度36个unicode字符。
key不能为空。不能包含“=”、
“*”、“<”、“>”、“\”、
“,”、“|”和“/”，且首尾字符 不能为空格。
value 否 String 值。每个值最大长度43个unicode字 符，可以为空字符串。 不能包含
“=”、“*”、“<”、“>”、
“\”、“,”、“|”和“/”，且首 尾字符不能为空格。
● 请求样例
修改ID为“c5504932-bf23-4171-b655-b87a6bc59334”的弹性IP的PTR。
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
}
响应
● 参数说明
表4-149 响应样例的参数说明
名称 参数类型 说明
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：表示无操作
links Object 指向当前资源或者其他相关资源的链接。
当响应需要分页时，需要包含一个next链接来进 行分页。详细信息请参见表4-150。
表4-150 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。
返回值含义以及更多返回值请参考状态码。