CTG海外融合CDN API
  1. 域名配置
CTG海外融合CDN API
  • 鉴权说明
  • API鉴权
    • 获取token代码示例
    • 鉴权接口
  • 域名操作
    • 域名创建
    • 域名开启
    • 域名关闭
    • 域名删除
    • 获取域名列表
  • 域名配置
    • 查询域名源站
      GET
    • 设置域名源站
      PUT
    • 查询域名回源host
      GET
    • 设置域名回源host
      PUT
    • 查询域名HTTPS
      GET
    • 设置域名HTTPS
      PUT
    • 查询域名是否强制跳转HTTPS
      GET
    • 设置域名强制跳转HTTPS
      PUT
    • 查询域名智能压缩
      GET
    • 设置域名智能压缩
      PUT
    • 查询域名IPV6
      GET
    • 设置域名IPV6
      PUT
    • 查询域名HTTP响应头域
      GET
    • 设置域名HTTP响应头域
      POST
    • 查询域名IP 黑白名单
      GET
    • 设置域名IP黑白名单
      POST
    • 查询域名Referer黑白名单
      GET
    • 设置域名Referer黑白名单
      POST
    • 查询域名UA黑白名单
      GET
    • 设置域名UA黑白名单
      POST
    • 查询域名回源协议
      GET
    • 设置域名回源协议
      PUT
    • 查询域名回源HTTP请求头
      GET
    • 设置域名回源HTTP请求头
      POST
    • 查询域名HTTP/2
      GET
    • 设置域名HTTP/2
      PUT
    • 查询域名HTTP/3
      GET
    • 设置域名HTTP/3
      PUT
    • 查询域名最低tls版本
      GET
    • 设置域名最低tls版本
      PUT
    • 查询域名回源超时时间(仅限AWS渠道)
      GET
    • 设置域名回源超时时间(仅限AWS渠道)
      PUT
    • 查询国家/地区数据(ISO)
      GET
    • 查询域名区域访问控制(仅限AWS渠道)
      GET
    • 设置域名区域访问控制(仅限AWS渠道)
      PUT
    • 获取AWS缓存策略列表
      GET
    • 查询域名缓存策略
      GET
    • 设置域名缓存策略
      PUT
    • 获取AWS回源请求头策略列表
      GET
    • 获取AWS响应头策略列表
      GET
    • 获取加速域名的AWS回源请求头策略(仅限AWS渠道)
      GET
    • 设置加速域名的AWS回源请求头策略(仅限AWS渠道)
      PUT
    • 获取加速域名的AWS响应头策略(仅限AWS渠道)
      GET
    • 设置加速域名的AWS响应头策略(仅限AWS渠道)
      PUT
  • 证书管理
    • 申请AWS证书
    • 获取AWS签发证书的验证信息
    • 上传证书
    • 更新证书
    • 获取证书列表
  • 内容管理
    • 根据预热URL获取用户的AWS预热区域和预热国家
    • 根据预热区域获取aws的所有pop点(国家)列表
    • 预取内容
    • 查询预取状态
    • 刷新内容
    • 查询刷新状态
  • 统计分析
    • 查询CDN消耗明细
    • 查询HTTP状态码请求数明细数据
    • 查询国家、地区消耗明细
    • Top域名
    • Top URL
    • Top Referer
    • Top UA
    • 查询命中流量
    • 查询命中请求数
    • 查询请求数
    • 查询HTTP状态码请求数汇总
  • 日志管理
    • 日志下载列表
  1. 域名配置

设置域名缓存策略

PUT
/API/cdn/domain/cache/conf
设置域名缓存策略

请求参数

Header 参数
Authorization
string 
必需
该值格式为: Bearer {token},Bearer是固定前缀,token是通过请求签名认证接口获取到的,参考鉴权接口文档
默认值:
Bearer Af8VDldHtQxxxF4n=H8tLRl9Er7WdhaXvWWd/
Content-Type
string 
json 类型
必需
默认值:
application/json
Body 参数application/json
domain
string 
加速域名名称
必需
cache_conf
array [object {3}] 
必需
可填多个策略,写在越前面的策略,优先级越高; 如果cache_conf设成[],则代表是删除缓存策略,遵循源站策略
path
string 
必需
路径模式, 支持通配符如img/.jpg, img/, *.jpg
type
integer 
必需
缓存类型,可选值: 1(文件后缀)、2(目录)
policy_id
string 
缓存策略ID
必需
示例
{
  "domain": "apitest1.rgslb.link",
  "cache_conf": [
    {
      "path": "/img/*",
      "type": 1,
      "policy_id": "658327ea-f89d-4fab-a63d-7e88639e58f6"
    }
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://ctgcdn.esurfingcloud.com/API/cdn/domain/cache/conf' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "domain": "apitest1.rgslb.link",
  "cache_conf": [
    {
      "path": "/img/*",
      "type": 1,
      "policy_id": "658327ea-f89d-4fab-a63d-7e88639e58f6"
    }
  ]
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
返回状态码,1为成功,其他为失败
message
string 
返回信息
必需
data
object 
必需
id
string 
配置ID
必需
name
string 
加速域名
必需
username
string 
所属用户
必需
cache_type
integer 
可选
策略类型,固定值3(自定义)
cache_conf
array [object {5}] 
必需
缓存配置,如果要配置多个path,则写多个配置即可,
示例
{
    "code": 1,
    "message": "OK",
    "data": {
        "id": "195",
        "name": "apitest1.rgslb.link",
        "username": "test",
        "cache_type": 3,
        "cache_conf": [
            {
                "priority": 1,
                "type": 1,
                "path": "/img/*",
                "policy_id": "658327ea-f89d-4fab-a63d-7e88639e58f6",
                "policy_name": ""
            }
        ]
    }
}
修改于 2024-08-07 02:32:18
上一页
查询域名缓存策略
下一页
获取AWS回源请求头策略列表
Built with