查询PTR Record

功能介绍

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

URI

GET /v2/reverse/floatingips/{region}:{floatingip_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。

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