更新时间:2024-03-14 GMT+08:00

查询PTR Record列表

功能介绍

查询租户弹性IP的PTR记录列表。

URI

GET /v2/reverse/floatingips

参数说明请参见表1
表1 URI格式的参数说明

名称

是否必选

参数类型

说明

marker

String

分页查询起始的资源ID,为空时为查询第一页。

默认值为空。

limit

Integer

每页返回的资源个数。

取值范围:0~500

取值一般为10,20,50。默认值为500。

offset

Integer

分页查询起始偏移量,表示从偏移量的下一个资源开始查询。

取值范围:0~2147483647

默认值为0。

当前设置marker不为空时,以marker为分页起始标识。

tags

String

资源标签。

取值格式:key1,value1|key2,value2

多个标签之间用"|"分开,每个标签的键值用英文逗号","相隔。

多个标签之间为“与”的关系。

搜索模式为精确搜索。如果资源标签值value是以*开头时,则按照*后面的值全模糊匹配。

默认值为空。

status

String

资源状态。

详细信息请参见资源状态

请求

  • 请求参数

  • 请求样例

    查询PTR列表。

    GET https://{DNS_Endpoint}/v2/reverse/floatingips

响应

  • 要素说明
    表2 响应样例的要素说明

    名称

    参数类型

    说明

    links

    Object

    指向当前资源或者其他相关资源的链接。

    当响应需要分页时,需要包含一个next链接来进行分页。详细信息请参见表5

    metadata

    Object

    返回满足过滤条件的资源总数。详细信息请参见表4

    floatingips

    Array of object

    PTR Record对象列表。详细信息请参见表3

    表3 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链接来进行分页。详细信息请参见表5

    tags

    Array of tag objects

    资源标签。

    取值格式:key1,value1|key2,value2

    多个标签之间用"|"分开,每个标签的键值用英文逗号","相隔。

    多个标签之间为“与”的关系。

    关于资源标签,请参见表6

    搜索模式为精确搜索。如果资源标签值value是以*开头时,则按照*后面的值全模糊匹配。

    默认值为空。

    表4 metadata参数说明

    名称

    参数类型

    说明

    total_count

    Integer

    满足查询条件的资源总数,不受分页(即limit、offset参数)影响。

    表5 links参数说明

    名称

    参数类型

    说明

    self

    String

    当前资源的链接。

    next

    String

    下一页资源的链接。

    表6 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。

返回值含义以及更多返回值请参考状态码