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

修改PTR Record

功能介绍

修改弹性IP的PTR记录。

URI

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

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

名称

是否必选

参数类型

说明

region

String

租户的区域信息。

floatingip_id

String

弹性IP的ID。

请求

  • 参数说明
    表2 请求样例的参数说明

    名称

    是否必选

    参数类型

    说明

    ptrdname

    String

    PTR记录对应的域名。

    域名格式不区分大小写,系统会将输入的大写字母统一转换为小写。

    description

    String

    对PTR记录的描述。

    默认值为空。

    ttl

    Integer

    PTR记录在本地DNS服务器的缓存时间,缓存时间越长更新生效越慢,以秒为单位。

    如果您的服务地址经常更换,建议TTL值设置相对小些,反之,建议设置相对大些。

    取值范围:

    1~2147483647

    默认值为300s。

    tags

    Array of object

    资源标签。详细信息请参见表3

    默认值为空。

    表3 tags对象参数说明

    名称

    是否必选

    参数类型

    说明

    key

    String

    键。最大长度36个unicode字符。 key不能为空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

    value

    String

    值。每个值最大长度43个unicode字符,可以为空字符串。 不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

  • 请求样例
    修改ID为“c5504932-bf23-4171-b655-b87a6bc59334”的弹性IP的PTR。
    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
    }

响应

  • 参数说明
    表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:表示无操作

    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。

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