功能介绍

设置弹性IP的PTR记录。

URI

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

请求

• 参数说明

  表2 请求样例的参数说明

  名称	是否必选	参数类型	说明
  ptrdname	是	String	PTR记录对应的域名。 域名格式不区分大小写，系统会将输入的大写字母统一转换为小写。
  description	否	String	对PTR记录的描述。 默认值为空。
  ttl	否	Integer	PTR记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 取值范围： 1～2147483647 默认值为300s。
  enterprise_project_id	否	String	反向解析关联的企业项目ID，长度不超过36个字符。 默认值为0。
  tags	否	Array of object	资源标签。详细信息请参见表3。 默认值为空。

  表3 tags对象参数说明

  名称	是否必选	参数类型	说明
  key	是	String	键。最大长度36个unicode字符。 key不能为空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”，且首尾字符不能为空格。
  value	否	String	值。每个值最大长度43个unicode字符，可以为空字符串。 不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”，且首尾字符不能为空格。

• 请求样例
  设置PTR解析记录，对应的弹性IP的ID为“c5504932-bf23-4171-b655-b87a6bc59334”。

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

  {
      "ptrdname": "www.example.com",
      "description": "Description for this PTR record",
      "ttl": 300,
      "tags": [ 
          { 
            "key": "key1", 
            "value": "value1" 
          } 
      ] 
  }

响应

• 参数说明

  表4 响应样例的参数说明

  名称	参数类型	说明
  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。

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

返回值

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

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