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

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

创建自定义线路

功能介绍

创建单个自定义线路。

URI

POST /v2.1/customlines

请求

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

    名称

    是否必选

    参数类型

    说明

    name

    String

    解析线路名称。

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

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

    ip_segments

    Array of strings

    IP地址段。

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

    目前只支持IPV4。

    最多支持50个。

    description

    String

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

    默认值为空。

  • 请求样例

    为IP地址段“1.1.1.1-1.1.1.1”和“1.1.1.2-1.1.1.3”创建自定义线路。

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

响应

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

    名称

    参数类型

    说明

    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_CREATE",
        "created_at": "2019-04-10T12:03:17.827",
        "updated_at": null,
        "description":"123"
    }

返回值

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

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

分享:

    相关文档

    相关产品