更新时间:2022-01-25 GMT+08:00

查询PTR Record

功能介绍

查询单个弹性IP的PTR记录。

URI

GET /v2/reverse/floatingips/{region}:{floatingip_id}

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

名称

是否必选

参数类型

说明

region

String

租户的区域信息。

floatingip_id

String

弹性IP的ID。

请求

  • 请求参数

  • 请求样例

    查询ID为“c5504932-bf23-4171-b655-b87a6bc59334”的弹性IP的PTR。

    GET https://{DNS_Endpoint}/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334

响应

  • 参数说明
    表2 响应样例的参数说明

    名称

    参数类型

    说明

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

    表3 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": "ACTIVE",
        "links": {
            "self": "https://Endpoint/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334"
        }
    }

返回值

接口正常的返回值为2xx,例如200、202或者204。

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