内容分发网络CDN

    创建加速域名接口

    接口

    本接口用于创建指定的域名。

    Method Path 说明
    PUT /v2/domain/{domain} 创建一个加速域名

    domain:表示需要创建CDN的加速域名。

    请求体(Request Body)

    参数 可选 类型 说明
    origin 必选 list类型,表示OriginPeer。 源站配置
    defaultHost 可选 String 默认回源host,当源站级别host不存在时,使用域名级别的默认host
    form 可选 指定域名业务类型 默认为"default",其他可选value:"image"表示图片小文件,"download"表示大文件下载,"media"表示流媒体点播,"dynamic"表示动静态加速

    OriginPeer类型如下:

    参数 可选 类型 说明
    peer 必选 String 格式为{protocol://}{address}{:port},其中protocol可选,目前只支持https;port可选,分http回源端口以及https回源端口,当protocol为https时设置的是https回源端口,反之则设置的是http回源端口,默认设置的是http回源端口;address必须为ip或者域名,目前address已经支持ipv6地址,ipv6地址必须为'[ipv6]'的格式
    host 可选 String 回源时使用的host值,该host为源站级别的host,每个源站可以配置一个host
    backup 可选 Bool 备份源站
    follow302 可选 Bool 开启回源follow 302
    weight 可选 int 源站权重,值为0-100之间的整数,表该源站的回源权重,默认等权重回源。注意:所有源站的权重和不能大于100,在没有默认值的情况下所有源站权重和必须等于100,DOMAIN类型的源站只能有一主一备,设置该参数不具有实际意义。举例:按照权重分配回源的流量。比如1G回源,2个ip,一个ip权重是80%,一个是20%,那一个ip就大约会有800M的回源,另一个大约会有200M的回源

    响应码 (Http Status Code)

    HTTP Status Code 说明
    201 创建成功
    400 域名已经存在、域名检查失败、缺乏必要参数、参数值错误、域名被封禁

    响应体 (Response Body)

    参数 类型 说明
    insId String 域名对应的实例ID
    status String 刚创建成功返回的status是OPERATING
    cname String 生成的CNAME域名,用户通过将加速域名CNAME至该域名实现加速

    请求示例——指定http回源端口

    PUT /v2/domain/1.test.com HTTP/1.1
    Host: cdn.baidubce.com
    Accept: */*
    Content-Length: 77
    Content-Type: application/x-www-form-urlencoded
    {
        "origin":[
            {
                "peer":"http://129.226.184.12:8001",
                "host":"myhost.com"
            }
        ]
    }

    请求示例——使用ipv4源站

    PUT /v2/domain/1.test.com HTTP/1.1
    Host: cdn.baidubce.com
    Accept: */*
    Content-Length: 77
    Content-Type: application/x-www-form-urlencoded
    {
      "origin":
      [
        {"peer": "http://origin.server.com", "host": "myhost.com"}
      ],
      "form":"image"
    }

    请求示例——使用ipv6源站

    PUT /v2/domain/1.test.com HTTP/1.1
    Host: cdn.baidubce.com
    Accept: */*
    Content-Length: 77
    Content-Type: application/x-www-form-urlencoded
    {
        "origin": [
            {
                "peer": "http://[2001:da8:20d:22::2]:80",
                "host": "aonetest"
            }
        ]
    }

    请求示例——同时配置ipv4和ipv6源站

    PUT /v2/domain/1.test.com HTTP/1.1
    Host: cdn.baidubce.com
    Accept: */*
    Content-Length: 77
    Content-Type: application/x-www-form-urlencoded
    {
        "origin": [
            {
                "peer": "http://[2001:250:3003:13::94]",
                "host": "ipv6.stu.edu.cn"
            },
            {
                "peer": "http://129.226.184.12",
                "host": "aonetest"
            }
        ]
    }

    响应示例

    HTTP/1.1 201 Created
    Server: nginx
    Date: Thu, 20 Jun 2019 09:34:05 GMT
    Content-Type: application/json; charset=utf-8
    Transfer-Encoding: chunked
    Connection: keep-alive
    X-Powered-By: PHP/7.1.5
    x-bce-request-id: e50749de-3e03-e9a8-6ed5-8d29b26730e9
    
    {"insId":"xxx-xxx","status":"OPERATING","cname":"domain.a.bdydns.com"}
    上一篇
    查询域名是否可添加
    下一篇
    启用加速域名接口