全部文档
云解析服务 DNS云解析服务 DNS
链接复制成功！
设置PTR Record
功能介绍
设置弹性IP的PTR记录。
调试
您可以在API Explorer中调试该接口。
URI
PATCH /v2/reverse/floatingips/{region}:{floatingip_id}
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
region |
是 |
String |
租户的区域信息。详细内容请参见终端节点（Endpoint）。 |
floatingip_id |
是 |
String |
弹性IP的ID。 可以通过网络控制台的弹性公网IP页面获取或者通过查询弹性公网IP列表获取。 |
请求
- 参数说明
表2 请求样例的参数说明 名称
是否必选
参数类型
说明
ptrdname
是
String
PTR记录对应的域名。
域名格式不区分大小写，系统会将输入的大写字母统一转换为小写。
description
否
String
对PTR记录的描述。
默认值为空。
ttl
否
Integer
PTR记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。
如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。
取值范围：
1～2147483647
默认值为300s。
enterprise_project_id
否
String
反向解析关联的企业项目ID，长度不超过36个字符。
默认值为0。
tags
否
Array of object
资源标签。详细信息请参见表3。
默认值为空。
- 请求样例设置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 响应样例的参数说明 名称
参数类型
说明
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链接来进行分页。详细信息请参见表5。
- 响应样例
{ "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" } }
