4.6 PTR Record 管理
4.6.3 查询 PTR Record 列表
功能介绍
查询租户弹性IP的PTR记录列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/reverse/floatingips?
limit={limit}&marker={marker}&offset={offset}&tags={tags}&status={status}
参数说明请参见表4-138。
表4-138 URI 格式的参数说明
名称 是否必选 参数类型 说明
marker 否 String 分页查询起始的资源ID，为空时为查询第 一页。
默认值为空。
limit 否 Integer 每页返回的资源个数。
取值范围：0~500
取值一般为10，20，50。默认值为500。
offset 否 Integer 分页查询起始偏移量，表示从偏移量的下 一个资源开始查询。
取值范围：0~2147483647 默认值为0。
当前设置marker不为空时，以marker为 分页起始标识。
enterprise_
project_id 否 String 反向解析关联的企业项目ID，长度不超过 36个字符。
默认值为0。
名称 是否必选 参数类型 说明
tags 否 String 资源标签。
取值格式：key1,value1|key2,value2 多个标签之间用"|"分开，每个标签的键 值用英文逗号","相隔。
多个标签之间为“与”的关系。
关于资源标签，请参见添加资源标签。
搜索模式为精确搜索。如果资源标签值 value是以*开头时，则按照*后面的值全 模糊匹配。
默认值为空。
status 否 String 资源状态。
详细信息请参见资源状态。
请求
● 请求参数 无
● 请求样例 查询PTR列表。
GET https://{DNS_Endpoint}/v2/reverse/floatingips
响应
● 要素说明
表4-139 响应样例的要素说明
名称 参数类型 说明
links Object 指向当前资源或者其他相关资源的链接。
当响应需要分页时，需要包含一个next链接来进 行分页。详细信息请参见表4-142。
metadata Object 返回满足过滤条件的资源总数。详细信息请参见 表4-141。
floatingips Array of
object PTR Record对象列表。详细信息请参见表 4-140。
表4-140 floatingips 字段说明
名称 参数类型 说明
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-142。
tags Array of tag
objects 资源标签。
取值格式：key1,value1|key2,value2
多个标签之间用"|"分开，每个标签的键值用英文 逗号","相隔。
多个标签之间为“与”的关系。
关于资源标签，请参见表4-143。
搜索模式为精确搜索。如果资源标签值value是 以*开头时，则按照*后面的值全模糊匹配。
默认值为空。
enterprise_
project_id String 反向解析关联的企业项目ID，长度不超过36个字 符。
表4-141 metadata 参数说明
名称 参数类型 说明
total_count Integer 满足查询条件的资源总数，不受分页（即limit、
offset参数）影响。
表4-142 links 参数说明
名称 参数类型 说明
self String 当前资源的链接。
next String 下一页资源的链接。
表4-143 tag 对象参数说明
名称 参数类型 说明
key String 键。最大长度36个unicode字符。 key不能为 空。不能包含“=”、“*”、“<”、“>”、
“\”、“,”、“|”和“/”，且首尾字符不能为 空格。
value String 值。每个值最大长度43个unicode字符，可以为 空字符串。 不能包含“=”、“*”、“<”、
“>”、“\”、“,”、“|”和“/”，且首尾字 符不能为空格。
● 响应样例
{ "links": {
"self": "https://Endpoint/v2/reverse/floatingips",
"next": "https://Endpoint/v2/zones?id=&limit=1&marker=region_id:c5504932-bf23-4171-b655-b87a6bc59334"
},
"metadata": { "total_count": 1 },
"floatingips": [ {
"id": "region_id:c5504932-bf23-4171-b655-b87a6bc59334", "ptrdname": "www.example.com.",
"description": "Description for this PTR record", "address": "10.154.52.138",
"action": "NONE", "ttl": 300,
"status": "ACTIVE", "links": {
"self": "https://Endpoint/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334"
} } ] }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。