融合 CDN

  • 域名相关

    最近更新时间:2018-12-10 16:31:48

    创建域名

    用户创建普通及泛域名接口 
    
    

    请求包

    POST /domain/<Name> HTTP/1.1
    Content-Type: application/json
    Authorization: QBox <AccessToken>
    
    {
        // 基本配置
        "type": <Type>,
        "platform": <Platform>,
        "geoCover": <GeoCover>,
        "protocol": <Protocol>,
    
        // 回源配置
        "source": <Source>,
    
        // 缓存配置
        "cache": <Cache>,
    
        // referer 防盗链
        "referer": <Referer>,
    
        // ip 黑白名单
        "ipACL": <IPACL>,
    
        // 时间戳防盗链
        "timeACL": <TimeACL>,
    
        // 回源鉴权
        "bsauth": <Bsauth>,
    
         // htttps 配置
        "https": <HTTPS>,
    
        // 其他特殊配置
        "external": <External>
    }
    
    

    参数解释

    基本参数

    参数 类型 必填 含义
    Name string 域名, 如果是泛域名,必须以点号 . 开头
    Type string 域名类型: normal(普通域名)/wildcard(泛域名)
    Platform string 平台类型: web(网页)/download(下载)/vod(点播)
    GeoCover string 地域: china/foreign/global
    Protocol string 协议: http/https
    Source 请参考 回源配置 回源参数
    Cache 请参考 缓存策略 缓存参数
    Referer 请参考 referer防盗链 防盗链参数
    IPACL 请参考 ip黑白名单 ip 黑白名单参数
    TimeACL 请参考 时间戳防盗链 时间戳防盗链参数
    Bsauth 请参考 回源鉴权 回源鉴权参数
    HTTPS 请参考 HTTPS HTTPS参数
    External 请参考 特殊配置 其他特殊配置参数

    返回包

    {}
    
    

    错误码

    错误码 含义
    400001 非法域名
    400005 未知的协议
    400020 域名未备案
    400040 非法的回源域名
    400044 非法的回源host
    400041 未知的回源ip
    400008 无此bucket
    400345 共享bucket不能绑定域名
    400043 未知的高级回源参数
    400022 未知的测试url
    400002 未知的回源类型
    400093 非法的域名类型
    400060 未知的referer防盗链类型
    400061 未知的referer防盗链参数
    400091 缓存参数有误
    400309 缓存规则未设置全局或者为遵循源站
    400204 时间戳防盗链key值数目不够
    400031 非法的url
    400203 已禁用的用户
    400541 获取用户信息失败
    401000 未实名认证的用户
    400801 未知的vendor
    400003 未知的平台类型
    400004 未知覆盖
    404911 非法的路径
    404912 非法的正则表达式
    400520 不能同时设置时间戳防盗链和回源鉴权
    400200 未知的bucket
    400521 非法的回源鉴权地址
    400522 非法的回源鉴权http方法
    400523 非法的回源鉴权http code
    400524 非法的回源鉴权超时时间
    400525 非法的回源鉴权url参数
    400401 无此证书
    400324 https证书解码失败
    400325 https证书解析失败
    400321 https证书还未生效
    400329 https证书过期
    400326 https证书与域名不匹配
    400327 解析https证书密钥失败
    400328 https证书与密钥不匹配
    400323 验证https证书链失败
    400549 只有https域名才能使用强制https跳转
    400621 泛域名及其子域名不能使用私有bucket
    400005 未知的协议
    400332 未知的回源协议
    500219 查询证书内部错误
    500005 数据查询内部出错
    500000 未知内部错误

    请求示例

    POST /domain/testqiniu.qbox.net HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "protocol": "http",
      "platform": "web",
      "geocover": "china",
      "type": "normal",
      "source": {
        "sourceType": "bucket",
        "sourceQiniuBucket": "test",
        "testURLPath": "qiniu_do_not_delete.gif"
      },
      "cache": {
        "cacheControls": [
          {
            "time": 0,
            "timeunit": 0,
            "type": "suffix",
            "rule": ".m3u8;.js"
          },
          {
            "time": 1,
            "timeunit": 5,
            "type": "all",
            "rule": "*"
          }
        ],
        "ignoreParam": true
      },
      "referer": {
        "refererType": "white",
        "refererValues": [
          "*.qiniu.com",
          "qiniu.com"
        ],
        "nullReferer": true
      },
      "timeACL": {
        "enable": true,
        "timeACLKeys": [
          "abcdefghijklmnopqrstuvwxyz",
          "zyxwvutsrqponmlkjihgfedcba"
        ],
        "checkUrl": "http://xxx.yyy.com/DIR1/dir2/vodfile.mp4?v=1.1&sign=19eb212771e87cc3d478b9f32d6c7bf9&t=55bb9b80"
      },
      "ipACL": {
        "ipACLType": "black",
        "ipACLValues": [
          "115.223.202.9"
        ]
      },
      "external": {
        "enableFop": true,
        "imageSlim": {
          "enableImageSlim": true,
          "prefixImageSlims": [
            "/abc",
            "/def"
          ]
        }
      }
    }
    

    创建泛子域名

    用户创建泛子域名接口,泛子域名必须回源七牛云存储的bucket
    
    

    请求包

    POST /pandomain/<Name>
    Content-Type: application/json
    Authorization: QBox <AccessToken>
    
    {
        "bucket": <Bucket>,
        "pareDomain": <PareDomain>,
    }
    
    

    参数解释

    参数 类型 必填 含义
    Name string 域名
    Bucket string 要绑定的bucket名称
    PareDomain string 泛子域名所属的泛域名

    返回包

    {}
    
    

    错误码

    错误码 含义
    400203 已禁用的用户
    400095 未知的父域名
    400008 无此bucket
    500011 pub域名到bucket失败
    500002 新增数据内部出错

    请求示例

    POST /pandomain/testqiniu.qbox.net HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "bucket": "test",
      "pareDomain": ".qbox.net"
    }
    

    修改源站

    用户修改普通域名及泛域名源站接口
    
    

    请求包

    PUT /domain/<Name>/source
    
    {
        Source
    }
    
    

    参数解释

    参数 类型 必填 含义
    Source object Source结构请参考 回源配置

    返回包

    {}
    
    

    错误码

    错误码 含义
    400001 非法域名
    404001 无此域名
    400093 非法的域名类型
    400801 未知的vendor
    400018 非法的cname
    400005 未知的协议
    400046 非法的url重写规则
    400022 非法的测试url
    400024 验证源站访问性失败
    500005 数据查询内部出错
    500019 非标准的回源cname

    请求示例

    PUT /domain/testqiniu.qbox.net/source HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "sourceType": "ip",
      "sourceIPs": [
        "1.1.1.1",
        "1.1.1.2"
      ],
      "testURLPath": "test.gif"
    }
    

    修改缓存规则

    用户修改普通域名及泛域名缓存规则接口
    
    

    请求包

    PUT /domain/<Name>/cache
    Content-Type: application/json
    Authorization: QBox <AccessToken>
    {
        Cache
    }
    
    

    参数解释

    参数 类型 必填 含义
    Cache object Cache结构请参考 缓存策略

    返回包

    {}
    
    

    错误码

    错误码 含义
    400001 未知的域名
    404001 无此域名
    400064 无权处理该域名
    400093 非法的域名类型
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    400091 缓存参数有误
    400309 缓存规则未设置全局或者为遵循源站
    500005 数据查询内部出错
    500923 域名已冻结
    500930 删除中的域名

    请求示例

    PUT /domain/testqiniu.qbox.net/cache HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "cacheControls": [
        {
          "time": 0,
          "timeunit": 0,
          "type": "suffix",
          "rule": ".m3u8;.js"
        },
        {
          "time": 1,
          "timeunit": 5,
          "type": "all",
          "rule": "*"
        }
      ],
      "ignoreParam": true
    }
    

    下线域名

    用户下线普通及泛域名接口
    
    

    请求包

    POST /domain/<Name>/offline
    Authorization: QBox <AccessToken>
    
    

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400093 非法的域名类型
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400018 非法的cname
    400397 cname和其他域名冲突
    500923 域名已冻结
    500005 数据查询内部出错

    上线域名

    用户上线普通及泛域名接口
    
    

    请求包

    POST /domain/<Name>/online
    Authorization: QBox <AccessToken>
    
    

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400093 非法的域名类型
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400018 非法的cname
    400397 cname和其他域名冲突
    500004 更新数据内部出错
    500923 域名已冻结
    500005 数据查询内部出错
    500235 该域名未绑定证书

    删除域名

    用户删除普通及泛域名接口
    
    

    请求包

    DELETE /domain/<Name>
    Authorization: QBox <AccessToken>
    
    

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400013 重复操作
    400030 正在处理中
    400317 非已下线的域名
    400066 域名状态为失败
    400515 该泛域名还含有活跃的子域名
    500005 数据查询内部出错

    获取域名信息

    用户获取域名信息接口,所有域名适用
    
    

    请求包

    GET /domain/<Name>
    Authorization: QBox <AccessToken>
    
    

    返回包

    {
        "name": <Name>,
        "type": <Type>,
        "cname": <CName>,
        "testURLPath": <TestURLPath>,
        "platform": <Platform>,
        "geoCover": <GeoCover>,
        "protocol": <Protocol>,
        "source": <Source>,
        "cache": <Cache>,
        "referer": <Referer>,
        "ipACL": <IPACL>,
        "timeACL": <TimeACL>,
        "bsauth": <Bsauth>,
        "operationType": <OperationType>,
        "operatingState": <OperatingState>,
        "operatingStateDesc": <OperatingStateDesc>,
        "createAt": <CreateAt>,
        "modifyAt": <ModifyAt>,
        "pareDomain": <PareDomain>,
    }
    
    

    参数解释

    基本参数 请参考

    参数 类型 含义
    CName string 创建域名成功后七牛生成的域名,用户需要把 Name cname 到这个域名
    Referer object Referer结构请参考 referer防盗链
    IPACL object IPACL结构请参考 ip黑白名单
    TimeACL object TimeACL结构请参考 时间戳防盗链
    Bsauth object Bsauth结构请参考 回源鉴权
    Source object Source结构请参考 回源配置
    Cache object Cache结构请参考 缓存策略
    OperationType string 域名最近一次操作类型: create_domain/offline_domain/online_domain/ modify_source/modify_referer/modify_cache/ freeze_domain/unfreeze_domain/modify_timeacl(修改时间戳防盗链)/ modify_https_crt/sslize(升级HTTPS)/modify_bsauth(修改回源鉴权) /offline_bsauth(删除回源鉴权)
    OperatingState string 域名最近一次的操作状态: processing/success/failed/frozen/offlined
    OperatingStateDesc string 域名最近一次的操作状态的描述
    CreateAt string 域名创建时间,格式:RFC3339
    ModifyAt string 域名最后一次修改时间,格式:RFC3339
    PareDomain string 父域名,属于泛子域名字段

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400014 无权获取该域名
    500005 数据查询内部出错

    获取域名列表

    用户获取域名列表接口,所有域名适用
    
    

    请求包

    GET /domain?marker=<Marker>&limit=<Limit>
    Authorization: QBox <AccessToken>
    
    

    参数解释

    参数 类型 含义
    Marker string 用于标示从哪个位置开始获取域名列表。不填或空表示从头开始
    Limit int 返回的最大域名个数。1~1000, 不填默认为 10

    返回包

    {
        "marker": <Marker>,
        "domains": [
            {
                "name": <Name>,
                "type": <Type>,
                "cname": <CName>,
                "testURLPath": <TestURLPath>,
                "platform": <Platform>,
                "geoCover": <GeoCover>,
                "protocol": <Protocol>,
                "operatingState": <OperatingState>,
                "operatingStateDesc": <OperatingStateDesc>,
                "createAt": <CreateAt>,
                "modifyAt": <ModifyAt>,
            },
            ...
        ]
    }
    
    

    参数解释

    基本参数 请参考

    参数 类型 含义
    Marker string 用于标示下一次从哪个位置开始获取域名列表
    CName string 创建域名成功后七牛生成的域名,用户需要把 Name cname 到这个域名
    TestURLPath string 域名的测试资源,需要保证这个资源是可访问的
    OperatingState string 域名最近一次的操作状态: processing/success/failed/frozen/offlined
    CreateAt string 域名创建时间,格式:RFC3339
    ModifyAt string 域名最后一次修改时间,格式:RFC3339

    错误码

    错误码 含义
    400021 非法的参数marker
    500005 数据查询内部出错

    HTTP升级为HTTPS

    HTTP升级为HTTPS
    
    

    请求包

    PUT /domain/<Name>/sslize
    Authorization: QBox <AccessToken>
    
    {
        "certid":<CertID>,
        "forceHttps": <ForceHttps>,
    }
    
    

    参数解释

    参数 类型 含义
    CertID string 证书id,从上传或者获取证书列表里拿到证书id
    ForceHttps bool 是否强制https跳转

    返回包

    {}
    
    

    错误码

    错误码 含义
    400331 非法参数
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400008 无此bucket
    400392 非法的域名cname
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400401 无此证书
    400324 https证书解码失败
    400325 https证书解析失败
    400321 https证书还未生效
    400329 https证书过期
    400326 https证书与域名不匹配
    400327 解析https证书密钥失败
    400328 https证书与密钥不匹配
    400323 验证https证书链失败
    400550 非法的证书id
    500219 查询证书内部错误
    500005 数据查询内部出错

    HTTPS降级为HTTP

    HTTPS降级为HTTP
    

    请求包

    PUT /domain/<Name>/unsslize
    Authorization: QBox <AccessToken>
    
    

    返回包

    {}
    

    错误码

    错误码 含义
    400331 非法参数
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400093 非法的域名类型
    400008 无此bucket
    400392 非法的域名cname
    400013 重复操作
    400030 正在处理中
    400923 域名已冻结
    400066 域名状态为失败
    401001 域名不允许操作
    500004 更新数据内部出错
    500005 数据查询内部出错

    修改证书

    修改证书
    
    

    请求包

    PUT /domain/<Name>/httpsconf
    Authorization: QBox <AccessToken>
    
    {
        "certid": <CertID>,
        "forceHttps": <ForceHttps>,
    }
    
    

    参数解释

    参数 类型 含义
    CertID string 证书id,从上传或者获取证书列表里拿到证书id
    ForceHttps bool 是否强制https跳转

    返回包

    {}
    
    

    错误码

    错误码 含义
    400331 非法参数
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400008 无此bucket
    400392 非法的域名cname
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400401 无此证书
    400324 https证书解码失败
    400325 https证书解析失败
    400321 https证书还未生效
    400329 https证书过期
    400326 https证书与域名不匹配
    400327 解析https证书密钥失败
    400328 https证书与密钥不匹配
    400323 验证https证书链失败
    500219 查询证书内部错误
    500005 数据查询内部出错

    修改referer防盗链

    用户修改普通域名及泛域名referer防盗链接口
    
    

    请求包

    PUT /domain/<Name>/referer
    
    {
        Referer
    }
    
    

    参数解释

    参数 类型 必填 含义
    Referer object Referer结构请参考 referer防盗链

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400008 无此bucket
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    500923 域名已冻结
    500930 删除中的域名
    400060 未知的referer防盗链类型
    400061 未知的referer防盗链参数
    500005 数据查询内部出错

    请求示例

    PUT /domain/testqiniu.qbox.net/referer HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "refererType": "white",
      "refererValues": [
        "*.qiniu.com",
        "qiniu.com"
      ],
      "nullReferer": true
    }
    

    修改ip黑白名单

    用户修改普通域名及泛域名ip黑白名单接口
    
    

    请求包

    PUT /domain/<Name>/ipacl
    
    {
        IPACL
    }
    
    

    参数解释

    参数 类型 必填 含义
    IPACL object IPACL结构请参考 ip黑白名单

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400008 无此bucket
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    500923 域名已冻结
    500930 删除中的域名
    400074 非法的ip黑白名单类型
    400075 非法的ip黑白名单参数
    500005 数据查询内部出错

    请求示例

    PUT /domain/testqiniu.qbox.net/ipacl HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "ipACLType": "black",
      "ipACLValues": [
        "115.223.202.9"
      ]
    }
    

    修改时间戳防盗链

    用户修改普通域名及泛域名时间戳防盗链接口
    
    

    请求包

    PUT /domain/<Name>/timacl
    
    {
        TimeACL
    }
    
    

    参数解释

    参数 类型 必填 含义
    TimeACL object TimeACL结构请参考 时间戳防盗链

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400008 无此bucket
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    500923 域名已冻结
    500930 删除中的域名
    400204 开启时间戳防盗链时,必须两组key
    400318 修改时间戳防盗链未带key
    400308 不能同时修改时间戳防盗链上所有的key
    400031 非法的url
    500005 数据查询内部出错

    请求示例

    PUT /domain/testqiniu.qbox.net/timacl HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "enable": true,
      "timeACLKeys": [
        "abcdefghijklmnopqrstuvwxyz",
        "zyxwvutsrqponmlkjihgfedcba"
      ],
      "checkUrl": "http://xxx.yyy.com/DIR1/dir2/vodfile.mp4?v=1.1&sign=19eb212771e87cc3d478b9f32d6c7bf9&t=55bb9b80"
    }
    

    修改回源鉴权

    用户修改普通域名及泛域名回源鉴权接口
    
    

    请求包

    PUT /domain/<Name>/bsauth
    
    {
        Bsauth
    }
    
    

    参数解释

    参数 类型 必填 含义
    Bsauth object 请参考 回源鉴权

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400200 未知的bucket
    400008 无此bucket
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    500923 域名已冻结
    500930 删除中的域名
    400520 不能同时设置时间戳防盗链和回源鉴权
    400521 非法的回源鉴权地址
    400522 非法的回源鉴权http方法
    400523 非法的回源鉴权http code
    400524 非法的回源鉴权超时时间
    400525 非法的回源鉴权url参数
    500005 数据查询内部出错

    请求示例

    PUT /domain/testqiniu.qbox.net/bsauth HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "enable": true,
      "isQiniuPrivate": false,
      "path": [],
      "method": "POST",
      "parameters": [
        "e",
        "token"
      ],
      "timeLimit": 5000,
      "userAuthUrl": "http://auth.testqbox.net",
      "strict": true,
      "successStatusCode": 200,
      "failureStatusCode": 401
    }
    

    修改特殊配置

    用户修改普通域名及泛域名特殊配置接口
    
    

    请求包

    PUT /domain/<Name>/external
    
    {
        External
    }
    
    

    参数解释

    参数 类型 必填 含义
    External object 结构请参考 特殊配置

    返回包

    {}
    
    

    错误码

    错误码 含义
    404001 无此域名
    400001 未知的域名
    400064 无权处理该域名
    400200 未知的bucket
    400008 域名绑定的bucket已删除
    400013 重复操作
    400030 正在处理中
    400066 域名状态为失败
    400998 域名已下线
    500923 域名已冻结
    500930 删除中的域名
    404911 非法的路径
    404912 非法的正则表达式
    500005 数据查询内部出错

    请求示例

    PUT /domain/testqiniu.qbox.net/external HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Content-Type: application/json
    Host: api.qiniu.com
    
    {
      "enableFop": true,
      "imageSlim": {
        "enableImageSlim": true,
        "prefixImageSlims": [
          "/abc",
          "/def"
        ]
      }
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close