修改加速区域

用户修改全站加速普通域名及泛域名区域覆盖接口

请求包

PUT /domain/<Name>/geocover
Content-Type: application/json
Authorization: QBox <AccessToken>
{
    "geoCover": <GeoCover>
}

参数解释

错误码

修改源站

结构

PUT /domain/<Name>/source
Content-Type: application/json
Authorization: QBox <AccessToken>
	{
	    sourceType: <SourceType>,
		  sourceHost: <SourceHost>,
	    sourceIPs: [<SourceIP>, ...],
	    sourceDomain: <SourceDomain>,
	    sourceQiniuBucket: <SourceQiniuBucket>,
	    sourceURLScheme: <SourceURLScheme>,
	    advancedSources: [
	        {
	            addr: <ASAddr>,
	            weight: <ASWeight>,
	            backup: <ASBackup>
	        }
	    ],
	    testURLPath: <TestURLPath>
	}

注意

• 高级回源模式中如配置了主备回源域名时，只有所有的主源都访问不了，才会访问备源
• 高级回源模式中如设置了源站权重，请求概率=权重/权重总和，eg：有两个主线路A和B，A权重1 和 B权重3，那么四次请求，1次是A，3次是B

修改Range回源

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

请求包

PUT /domain/<Name>/range
Content-Type: application/json
Authorization: QBox <AccessToken>
{
	"enable": <Enable>
}

参数解释

错误码

请求示例

PUT /domain/testqiniu.qbox.net/range HTTP/1.1
Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
Content-Type: application/json
Host: api.qiniu.com
{
  "enable": "on"
}

修改回源超时

调整 CDN 回源节点到源站的超时时间

请求包

PUT /domain/<Name>/sourcetimeout
Content-Type: application/json
Authorization: QBox <AccessToken>
{
    "sourceConnTimeout": <SourceConnTimeout>,
    "sourceReadTimeout": <SourceReadTimeout>
}

参数解释

请求示例

PUT /domain/testqiniu.qbox.net/range HTTP/1.1
Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
Content-Type: application/json
Host: api.qiniu.com
{
    "sourceConnTimeout": 10,
    "sourceReadTimeout": 60
}

缓存策略

结构

PUT /domain/<Name>/cache
Content-Type: application/json
Authorization: QBox <AccessToken>
    {
	    cacheControls: [
		    {
			    time: <CCTime>,
			    timeunit: <CCTimeUnit>,
			    type: <CCType>,
			    rule: <CCRule>
		    }
	    ],
	    ignoreParam: <IgnoreParam>
    }

注意

• 缓存配置优先级依从配置数组的前后顺序依次从高到低
• 全局配置要放到最后，不然自定义规则缓存配置优先级最低
• 如果是遵循源站配置follow，只能有一条，即全部遵循源站

例子

	// .abc, .jpg后缀文件缓存1分钟，/def, /auth 目录下文件不缓存，全局缓存一个月
	// url参数不缓存
	{
	    cacheControls: [
		    {
			    time: 1,
			    timeunit: 1,
			    type: "suffix",
			    rule: ".abc;.jpg"
			},
			{
			    time: 0,
			    timeunit: 0,
			    type: "path",
			    rule: "/def;/auth"
			},
			{
			    time: 1,
			    timeunit: 5,
			    type: "all",
			    rule: "*"
			},
	    ],
	    ignoreParam: true
	}

	// 遵循源站
	{
	    cacheControls: [
		    {
			    time: 0,
			    timeunit: 0,
			    type: "follow",
			    rule: "*"
			}
	    ],
	    ignoreParam: false
	}

referer 防盗链

结构

请求结构

PUT /domain/<Name>/referer
Content-Type: application/json
Authorization: QBox <AccessToken>

{
    refererType: <RefererType>,
    refererValues: [<RefererValue>,...],
    nullReferer: <NullReferer>
}

响应结构

{
     refererType: <RefererType>,
     refererValues: [<RefererValue>, ...],
     nullReferer: <NullReferer>
}

注意

• 请求结构和响应结构不同, 请求结构是指创建域名和修改referer防盗链的请求采用的结构，响应结构是指, 获取域名信息和获取域名列表中返回结果中采用的结构

IP黑白名单

结构

请求结构

PUT /domain/<Name>/ipacl
Content-Type: application/json
Authorization: QBox <AccessToken>
{
    ipACLType: <IpACLType>,
    ipACLValues: [<IpACLValue>,...],
}

响应结构

{
    ipACLType: <IpACLType>,
    ipACLValues: [<IpACLValue>, ...]
}

注意

• 请求结构和响应结构不同, 请求结构是指创建域名和修改ip黑白名单的请求采用的结构，响应结构是指, 获取域名信息和获取域名列表中返回结果中采用的结构

UA黑白名单

结构

请求结构

PUT /domain/<Name>/uaacl
Content-Type: application/json
Authorization: QBox <AccessToken>
{
    enable: <Enable>,
    ruleType: <RuleType>,
    userAgent: [<UserAgent>, ...]
}

响应结构

{
    enable: <Enable>,
    ruleType: <RuleType>,
    userAgent: [<UserAgent>, ...]
}

注意

• 请求结构和响应结构不同, 请求结构是指创建域名和修改ua黑白名单的请求采用的结构，响应结构是指, 获取域名信息和获取域名列表中返回结果中采用的结构

修改响应头

修改CDN返回给用户的响应头

请求包

PUT /domain/<Name>/respheader
Content-Type: application/json
Authorization: QBox <AccessToken>
{
    responseHeaderControls: [
        {
            op: <op>
            key: <key>
            value: <value>
        }...
    ]
}

参数解释

错误码

开启HTTPS

HTTP升级为HTTPS

请求包

PUT /domain/<Name>/sslize
Content-Type: application/json
Authorization: QBox <AccessToken>
{
	"certid":<CertID>,
	"forceHttps": <ForceHttps>,
	"http2Enable": <Http2Enable>,
	"tlsversions": [<TlsVersion>,...]
}

参数解释

错误码

修改THHPS配置

修改THHPS配置

请求包

PUT /domain/<Name>/httpsconf
Content-Type: application/json
Authorization: QBox <AccessToken>
{
	"certId": <CertID>,
	"forceHttps": <ForceHttps>,
	"http2Enable": <Http2Enable>
        "tlsversions": [<TlsVersion>,...]
}

参数解释

错误码

创建新的域名标签

在账户下添加新的域名标签

请求包

POST /domain/tag HTTP/1.1
Content-Type: application/json
Authorization: QBox <AccessToken>
{
	tag: <Tag>,
        tagKey: <TagKey>,
        tagValue: <TagValue>,
	product: <Product>
}

参数解释

错误码

请求示例

POST /domain/tag HTTP/1.1
Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
Content-Type: application/json
Host: api.qiniu.com
{
    "tagKey": "图片",
    "tagValue": "高清",
    "product": "cdn"
}

设置域名标签

选取账户下定义好的标签，为域名配置标签列表

请求包

PUT /domain/<Domain>/tags HTTP/1.1
Content-Type: application/json
Authorization: QBox <AccessToken>
{
	kvTagList: <TagList>
}

参数解释

错误码

请求示例

PUT /domain/<Domain>/tags HTTP/1.1
Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
Content-Type: application/json
Host: api.qiniu.com
{
    "kvTagList": [{"key":"图片","value":"高清"}]
}

获取所有域名标签

获取账户下定义的域名标签

请求包

GET /domain/all/tags?product=<Product>
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <AccessToken>

参数解释

错误码