创建域名
用户创建普通及泛域名接口
请求包
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>
// 备案号
"registerNo": <RegisterNo>
}
参数解释
基本参数
参数 |
类型 |
必填 |
含义 |
Name |
string |
是 |
域名, 如果是泛域名,必须以点号 . 开头 |
Type |
string |
是 |
域名类型: normal (普通域名)/wildcard (泛域名) |
Platform |
string |
是 |
平台类型: web (网页)/download (下载)/vod (点播)/ dynamic (动态加速) |
GeoCover |
string |
是 |
地域: china /foreign /global |
Protocol |
string |
是 |
协议: http /https |
Source |
请参考 回源配置 |
是 |
回源参数 |
Cache |
请参考 缓存策略 |
备注:平台是动态加速是“否”,其他平台为“是” |
缓存参数 |
Referer |
请参考 referer防盗链 |
否 |
防盗链参数 |
IPACL |
请参考 ip黑白名单 |
否 |
ip 黑白名单参数 |
TimeACL |
请参考 时间戳防盗链 |
否 |
时间戳防盗链参数 (备注:平台是动态加速不支持时间戳防盗链) |
Bsauth |
请参考 回源鉴权 |
否 |
回源鉴权参数(备注:平台是动态加速不支持回源鉴权) |
HTTPS |
请参考 HTTPS |
否 |
HTTPS参数 |
External |
请参考 特殊配置 |
否 |
其他特殊配置参数 |
RegisterNo |
string |
否 |
当创建域名返回code: 500230 或者返回的内容提示为备案查询服务已关闭 ,需要API调用者在本参数输入域名的备案号 |
返回包
{}
错误码
错误码 |
含义 |
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 |
数据查询内部出错 |
500230 |
备案查询服务已关闭 |
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。每个泛域名只能创建一级泛子域名,例如:.a.com 的泛域名只能创建 123.a.com的泛子域名。
请求包
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 |
400412 |
无效的泛子域名 |
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 |
数据查询内部出错 |
400923 |
域名已冻结 |
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和其他域名冲突 |
400923 |
域名已冻结 |
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>,
"https": <Https>,
}
参数解释
基本参数 请参考
参数 |
类型 |
含义 |
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 |
父域名,属于泛子域名字段 |
Https |
Object |
Https结构请参考 HTTPS |
错误码
错误码 |
含义 |
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>,
"http2Enable": <Http2Enable>
}
参数解释
参数 |
类型 |
含义 |
CertID |
string |
证书id,从上传或者获取证书列表里拿到证书id |
ForceHttps |
bool |
是否强制https跳转 |
Http2Enable |
bool |
http2功能是否启用,false为关闭,true为开启 |
返回包
{}
错误码
错误码 |
含义 |
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>,
"http2Enable": <Http2Enable>
}
参数解释
参数 |
类型 |
含义 |
CertID |
string |
证书id,从上传或者获取证书列表里拿到证书id |
ForceHttps |
bool |
是否强制https跳转 |
Http2Enable |
bool |
http2功能是否启用,false为关闭,true为开启 |
返回包
{}
错误码
错误码 |
含义 |
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 |
域名已下线 |
400923 |
域名已冻结 |
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 |
域名已下线 |
400923 |
域名已冻结 |
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>/timeacl
{
TimeACL
}
参数解释
参数 |
类型 |
必填 |
含义 |
TimeACL |
object |
是 |
TimeACL结构请参考 时间戳防盗链 |
返回包
{}
错误码
错误码 |
含义 |
404001 |
无此域名 |
400001 |
未知的域名 |
400064 |
无权处理该域名 |
400008 |
无此bucket |
400013 |
重复操作 |
400030 |
正在处理中 |
400066 |
域名状态为失败 |
400998 |
域名已下线 |
400923 |
域名已冻结 |
500930 |
删除中的域名 |
400204 |
开启时间戳防盗链时,必须两组key |
400318 |
修改时间戳防盗链未带key |
400308 |
不能同时修改时间戳防盗链上所有的key |
400031 |
非法的url |
500005 |
数据查询内部出错 |
请求示例
PUT /domain/testqiniu.qbox.net/timeacl 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 |
域名已下线 |
400923 |
域名已冻结 |
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 |
域名已下线 |
400923 |
域名已冻结 |
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"
]
}
}
修改响应头
修改CDN返回给用户的响应头
请求包
PUT /domain/<Name>/respheader
Content-Type: application/json
Authorization: QBox <QBoxToken>
{
responseHeaderControls: [
{
op: <op>
key: <key>
value: <value>
}...
]
}
参数解释
参数 |
类型 |
必填 |
含义 |
Name |
string |
是 |
域名 |
op |
string |
是 |
对响应头的进行操作的类型,可选"set"、"del",目前不支持"add" |
key |
string |
是 |
匹配响应头的key,可选值:Content-Type,Cache-Control,Content-Disposition,Content-Language,Expires,Access-Control-Allow-Origin,Access-Control-Allow-Methods,Access-Control-Allow-Headers,Access-Control-Max-Age,Access-Control-Expose-Headers,Access-Control-Allow-Credentials。 |
value |
string |
是 |
响应头的value,在op为"set"时有效 |
返回包
{ }
错误码
错误码 |
含义 |
404001 |
无此域名 |
400001 |
未知的域名 |
400064 |
无权处理该域名 |
400008 |
无此bucket |
400013 |
重复操作 |
400030 |
正在处理中 |
400066 |
域名状态为失败 |
400998 |
域名已下线 |
400923 |
域名已冻结 |
400084 |
无效的响应头key |
400085 |
无效的响应头操作请求 |
400086 |
重复的响应头key |
500930 |
删除中的域名 |
500005 |
数据查询内部出错 |