云解析服务 DNS云解析服务 DNS

更新时间:2021/06/16 GMT+08:00
分享

更新自定义线路

功能介绍

更新单个自定义线路。

URI

PUT /v2.1/customlines/{line_id}

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

名称

是否必选

参数类型

说明

line_id

String

解析线路ID。

可以通过查询自定义线路获取。

请求

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

    名称

    是否必选

    参数类型

    说明

    name

    String

    解析线路名称。

    长度限制为1-80个字符,只允许包含中文、字母、数字、'-'、'_'、'.'字符。

    租户内,解析线路名称是唯一的。

    如果为空,表示维持原值。

    默认值为空。

    ip_segments

    Array of strings

    IP地址段。

    以“-”分隔,小IP地址在前,大IP地址在后。IP段之间不能有交叉。当只有一个IP时,填写IP1-IP1。

    目前只支持IPV4。

    最多支持50个。

    如果为空,表示维持原值。

    默认值为空。

    description

    String

    自定义线路的描述信息。长度不超过255个字符。

    如果为空,表示维持原值。

    默认值为空。

  • 请求样例

    更新解析线路ID为“custom_2ce45ef669fc87870169fcbada7a0007”的自定义线路。

    PUT https://{DNS_Endpoint}/v2.1/customlines/custom_2ce45ef669fc87870169fcbada7a0007
    {
        "name": "customline",
        "ip_segments": [
            "1.1.1.1-1.1.1.1",
            "1.1.1.2-1.1.1.3"
        ],
       "description": "1234"
    }

响应

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

    名称

    参数类型

    说明

    line_id

    String

    解析线路ID。

    name

    String

    解析线路名称。

    ip_segments

    Array of strings

    IP地址段。

    created_at

    String

    创建时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    updated_at

    String

    更新时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    status

    String

    资源状态。

    详细内容请参见枚举类型

    description

    String

    自定义线路的描述信息。

  • 响应样例
    {
        "line_id": "custom_2ce45ef669fc87870169fcbada7a0007",
        "name": "customline",
        "ip_segments": [
            "1.1.1.1-1.1.1.1",
            "1.1.1.2-1.1.1.3"
        ],
        "status": "PENDING_UPDATE",
        "created_at": "2019-04-10T12:03:17.827",
        "updated_at": "2019-04-10T12:03:17.827",
        "description": "1234"
    }

返回值

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

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

分享:

    相关文档

    相关产品