功能介绍

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

调试

您可以在API Explorer中直接运行调试该接口。

URI

GET /v2/reverse/floatingips?limit={limit}&marker={marker}&offset={offset}&tags={tags}&status={status}

请求

• 请求参数

  无

• 请求样例

  查询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是以*开头时，则按照*后面的值全模糊匹配。 默认值为空。
  enterprise_project_id	String	反向解析关联的企业项目ID，长度不超过36个字符。

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

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