2. Domain 域名相关 API 配置

URL: https://api-client.apeirocdn.com/api/v1

1. resources.domains.list 呈现当前的域名列表

Method : GET

① 示范 (curl 模式)

curl --location 'https://api-client.apeirocdn.com/api/v1/resources/domains?groupName=cdn-xxx&from=0&size=10&filters=servername:example.com' \
--header 'Cookie: access_token=my-token' \

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

from

integer

Default: 0

Example: from=0

从 n 开始检索

size

integer

Default: 10

Example: size=10

要检索的项目的数量

filters

string

Default: " "

filters=itemName:my_name Example: filters=servername:example.com

用于检索项目的过滤器。

使用 +AND 来分隔过滤特征
使用 * 作为通配符
itemName=栏位名称 my_name=该栏位后面的 value

2. resources.domains.create 添加域名

Method : POST

① 示范 (curl 模式)

curl --location --request POST \
  --url 'https://api-client.apeirocdn.com/api/v1/resources/domains?groupName=cdn-xxx' \
  --header 'content-type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{"servername":"example.com","serviceGroupName":"cdn-xxx-a01-ws","origins":["1.1.1.1","www.example.com"]}'

当域名是添加在 AppProfile 里时 (AppProfile 不为空值)： serviceGroupName 和 origins 这两个参数就会是套用 AppProfile 的设定，因此可以不用填写 (非必填)。尽管域名可以从 AppProfile 套用大多数的参数，但 useSystemCert 和 keypairname 这两个参数仍需要个别填写。

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body :

栏位

类型

预设/填写范例

描述

description

string

Default: ""

注解字段

3. resources.domains.get 获取域名信息

Method : GET

① 示范 (curl 模式)

curl --location --request GET 'https://api-client.apeirocdn.com/api/v1/resources/domains/{servernameId}?groupName=cdn-xxx' \
--header 'Content-type: application/json' \ 
--header 'Cookie: access_token=my-token' \
--data ''

Path :

栏位

类型

预设/填写范例

描述

servernameId

required

string

Example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

要检索的域名，必须以域名的物件 ID，(您可以点击「显示栏位 > ☑ 物件 ID」查看对应的物件 ID，或是在 api 回应中的"_id"栏位中，也能够找到对应 ID)

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

4. resources.domains.update 更新域名

Method : PATCH

① 示范 (curl 模式)

curl --location --request PATCH 'https://api-client.apeirocdn.com/api/v1/resources/domains/{servernameId}?groupName=cdn-xxx' \
  --header 'Content-Type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{"serviceGroupName":"cdn-xxx-a01-ws","origins":["1.1.1.1","www.example.com"]}'

Path :

栏位

类型

预设/填写范例

描述

servernameId

required

string

Example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

要检索的域名，必须以域名的物件 ID，(您可以在 portal 点击「显示栏位 > ☑ 物件 ID」查看对应的物件 ID。)

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body :

栏位

类型

预设/填写范例

描述

description

string

Default: ""

注解字段

5. resources.domains.delete 删除域名

Method : DELETE

① 示范 (curl 模式)

curl --location --request DELETE 'https://api-client.apeirocdn.com/api/v1/resources/domains/{servernameId}?groupName=cdn-xxx' \
--header 'content-type: application/json' \
--header 'Cookie: access_token=my-token' \
--data ''

Path :

栏位

类型

预设/填写范例

描述

servernameId

required

string

Example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

要检索的域名，必须以域名的物件 ID，(您可以在 portal 点击「显示栏位 > ☑ 物件 ID」查看对应的物件 ID。)

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

6. purge cache of the domain 针对域名清除缓存

Method : POST

① 示范 (curl 模式)

curl --location --request POST 'https://api-client.apeirocdn.com/api/v1/resources/domains/_actions/purgeCache?groupName=cdn-xxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: access_token=my-token' \
--data '{
    "keys": [
        {
            "domain": "my-domain1.com",
            "key": "/"
        },
        {
            "domain": "my-domain2.com",
            "key": "/image"
        }
    ]
}'

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body :

栏位

类型

预设/填写范例

描述

domain

required

string

my-domain1.com

项目的域名名称

key

Array of objects

non-empty

/image

清除缓存路径/资源格式

7. OWASP 相关设定

Method : 添加域名 : POST

Method : 更新域名 : PATCH

① 示范 (curl 模式)

curl --location --request POST \
  --url 'https://api-client.apeirocdn.com/api/v1/resources/domains?groupName=cdn-xxx' \
  --header 'content-type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{
  "servername": "example.com",
  "serviceGroupName": "cdn-xxx-a01-ws",
  "origins": [
    "1.1.1.1",
    "www.example.com"
  ],
   "isUseOwasp":true,
   "owaspRuleName": "sys_default"  
}'

上述为添加域名 : POST 的代码，如要更新域名请将 "--request" 更改为 PATCH。

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body :

栏位

类型

预设/填写范例

描述

isUseOwasp

boolean

Default: false

使用 OWASP 开关

owaspRuleName

required if isUseOwasp is true

string

Example: "sys_default"

OWASP 规则，当 isUseOwasp 为 true 时必填

8. 回源 URL 改写设定

Method : 添加域名 : POST

Method : 更新域名 : PATCH

① 示范 (curl 模式)

curl --location --request POST \
  --url 'https://api-client.apeirocdn.com/api/v1/resources/domains?groupName=cdn-xxx' \
  --header 'content-type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{
  "servername": "example.com",
  "serviceGroupName": "cdn-xxx-a01-ws",
  "origins": [
    "1.1.1.1",
    "www.example.com"
  ],
   "rewriteUrlRules": [
        {
            "isRewriteUrlPath": false,
            "sourcePath": "/test123",
            "destPath": "/test9999",
            "isRewriteUrlArgs": true,
            "rewriteUrlArgsRules": [
                {
                    "sourceArgs": "22"
                },
                {
                    "sourceArgs": "212"
                },
                {
                    "sourceArgs": "222"
                }
            ]
        }
    ]
}'

上述为添加域名 : POST 的代码，如要更新域名请将 "--request" 更改为 PATCH。

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body :

栏位

类型

预设/填写范例

描述

rewriteUrlRules

Array of objects

Example: See below

改写回源 URL 的规则集合

rewriteUrlRules[].description

string

Default: ""

描述此改写规则的用途

rewriteUrlRules[].isRewriteUrlPath

boolean

Default: false

是否启用路径改写

rewriteUrlRules[].sourcePath

string

Default: ""

改写目标路径

rewriteUrlRules[].destPath

string

Default: ""

替换路径

rewriteUrlRules[].isReplaceAll

boolean

Default: false

是否开启全部替换

rewriteUrlRules[].isIteration

boolean

Default: false

是否开启迭代

rewriteUrlRules[].isRewriteUrlArgs

boolean

Default: false

是否启用 args 改写

rewriteUrlRules[].rewriteUrlArgsRules

Array of objects

Default: []

改写 args 的规则集合

rewriteUrlRules[].rewriteUrlArgsRules[].sourceArgs

string

Default: ""

改写目标 args

rewriteUrlRules[].rewriteUrlArgsRules[].destArgs

string

Default: ""

替换 args

rewriteUrlRules[].rewriteUrlArgsRules[].isReplaceAll

boolean

Default: false

是否开启全部替换

rewriteUrlRules[].rewriteUrlArgsRules[].isIteration

boolean

Default: false

是否开启迭代

9. 进阶缓存设定

Method : 添加域名时增加进阶缓存设定 : POST

Method : 更新进阶缓存设定 : PATCH

① 示范 (curl 模式)

curl --location --request POST \
  --url 'https://api-client.apeirocdn.com/api/v1/resources/domains?groupName=cdn-xxx' \
  --header 'content-type: application/json' \
  --header 'Cookie: access_token=my-token' \
  --data '{
  "servername": "example.com",
   "cacheUrlRules": [
        {
        "cacheType": "cache",
        "uriPath": "/rule1",
        "description": "rule 1",
        "isSlice": true,
        "slice": 8,
        "isPassSetCookie": true,
        "browserExp": 60,
        "serverExp": 5,
        "argsType": "keepAll",
        "argsRules": [],
        "exCacheArgsRules": []
        },
        {
        "cacheType": "cache",
        "uriPath": "/rule2",
        "description": "rule 2",
        "isSlice": false,
        "slice": 5,
        "isPassSetCookie": false,
        "browserExp": 60,
        "serverExp": 11,
        "argsType": "ignoreAll",
        "argsRules": []
        }
    ]
}'

上述为添加域名时增加进阶缓存设定 : POST 的代码，如要更新设定请将 "--request" 更改为 PATCH。

Parameter :

栏位

类型

预设/填写范例

描述

groupName

required

string

groupName=cdn-xxx

项目的群组名称

Body:

栏位

类型

预设/填写范例

描述

cacheUrlRules

Array of objects

Example: See below

进阶缓存规则集合，以 "{ }" 分开多条规则

cacheType

String

Default: "" Example: "cache"

缓存类型，栏位可套用唯一值如下: - followOrigin (遵循源站) - cache (缓存) - notCache (不缓存)

uriPath

String

Default: "" Example: "/rule1"

指定缓存路径

description

String

Default: "" Example: "this-is-rule1"

描述此缓存规则的用途

isSlice

Boolean

Default: false Example: "true"

是否开启拆分缓存大小功能

slice

Number

Default: Example: "5"

缓存文件拆分大小，单位 : MB

browserExp

Number

Default: Example: "5"

资源在浏览器过期时间，单位 : min

serverExp

Number

Default: Example: "5"

资源在服务器过期时间，单位 : min

argsType

Array of objects

Default: []

Args 缓存规则集合，栏位可套用唯一值如下: - keepAll (全部保留) - ignoreAll (全部忽略) - keepParams (保留指定参数，其余忽略) - ignoreParams (忽略指定参数，其余保留)

argsRules

Array of objects Key : string Value : string

Default: [] Example: [{"key": "456", "value":"789"}, "key": "123", "value":"321"}]

argsType 缓存规则的详细对象参数

proxyCacheLock

Boolean

Default: false Example: "true"

是否开启缓存鎖功能

Previous1. Current User 生成 API 令牌 / 登入 Next3. WafRules WAF 规则相关 API 配置

Last updated 20 days ago