批量更新域名配置
更新時間 2025-08-08 14:04:03
最近更新時間: 2025-08-08 14:04:03
分享文章
接口描述:調用本接口批量更新域名配置信息
請求方式:post
請求路徑:/domain/batch-update-domain-configuration-information
使用說明:
- 修改域名之前,您需要先開通對應產品類型的服務,且保證資源包/按需服務有效;
- 該域名沒有在途工單;
- 單個用戶一分鐘限制調用10次。
請求參數說明:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| domain | list< string> | 是 | 域名列表 | 單次調用域名個數最多不超過20個,相同域名去重 |
| product_code | string | 是 | 產品類型 | “001”(靜態加速),“003”:(下載加速), “004”(視頻點播加速),“008”(CDN加速),“014”(下載加速閑時) |
| ipv6_enable | int | 否 | ipv6啟用 | 未傳代表不修改,1(啟用); 2(關閉) |
| origin | list<origin_single> | 否 | 回源信息 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段origin_single詳細說明見下方 |
| xos_origin_is | int | 否 | 是否開啟云存儲XOS源站配置功能 | 枚舉值:0(關閉), 1(開啟);默認0 |
| xos_origin | object | 否 | 云存儲XOS源站信息 | 未傳代表不修改,有傳代表整個數組全量修改,字段xos_origin詳細說明見下方 |
| req_host | string | 否 | 回源host設置 | 傳空字符串""代表刪除,未傳代表不修改 |
| origin_host_type | int | 否 | 主備源攜帶不同的回源host是否開啟 | 未傳代表不修改,0(關閉) ;1(開啟)。主備源攜帶不同的回源host開啟(origin_host_type等于1):同時配置origin帶不同的回源host和回源host,且都有傳具體值,則以origin帶不同的回源host生效(清空回源host)。 |
| origin_host_http | dict | 否 | http類型origin帶不同的回源host | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改 |
| black_referer | dict | 否 | referer黑名單 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,字段black_referer詳細說明見下方 |
| white_referer | dict | 否 | referer白名單 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,字段white_referer詳細說明見下方 |
| user_agent | dict | 否 | user_agent黑白名單配置 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,字段user_agent詳細說明見下方 |
| filetype_ttl | list<filetype_ttl_single> | 否 | 緩存類型設置 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段filetype_ttl_single詳細說明見下方 |
| ip_black_list | string | 否 | ip黑名單 | 傳空字符串""代表刪除,未傳代表不修改,黑白名單只允許存在一個,若同時存在只處理黑名單,支持ip段與ip,多個ip/ip段以逗號分割,示例:1.1.1.1,2.2.2.2,::1,3.3.3.3-4.4.4.4 |
| ip_white_list | string | 否 | ip白名單 | 傳空字符串""代表刪除,未傳代表不修改,黑白名單只允許存在一個,若同時存在只處理白名單,支持ip段與ip,多個ip/ip段以逗號分割,示例:1.1.1.1,2.2.2.2,::1,3.3.3.3-4.4.4.4 |
| req_headers | list<req_headers_single> | 否 | 自定義回源請求頭 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段req_headers_single詳細說明見下方 |
| resp_headers | list<resp_headers_single> | 否 | 自定義響應頭 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段resp_headers_single詳細說明見下方 |
| error_code | list<error_code_single> | 否 | 錯誤狀態碼緩存 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段error_code_single詳細說明見下方 |
| shared_host | string | 否 | 共享緩存域名 | 傳空字符串""代表刪除,未傳代表不修改 |
| https_status | string | 否 | https是否開啟 | 未傳代表不修改,取值:on、off,取值為on時,cert_name為必傳字段 |
| cert_name | string | 否 | 國際證書備注名 | 未傳代表不修改,傳空字符串代表刪除 |
| cert_name_gm | string | 否 | 國密證書備注名 | 未傳代表不修改,傳空字符串代表刪除 |
| https_basic | dict | 否 | https基礎信息 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,字段https_basic詳細說明見下方 |
| basic_conf | dict | 否 | http配置基礎信息 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,字段basic_conf詳細說明見下方 |
| limit_speed_uri | list<limit_speed_uri_single> | 否 | 基于url參數限速 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段limit_speed_uri_single詳細說明見下方 |
| limit_speed_uri_condition | dict | 否 | limit_speed_uri的condition配置 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,格式:{“{key}”:[{“mode”:類型,“content”:“配置內容,多個以逗號間隔”}]},mode類型為int,取值默認0,可以為:0(文件后綴),1(目錄),2(首頁),3(全部文件),4(全路徑),key為limit_speed_uri中的id.使用限制:一個key對應的數組大小只能是1,因為配置平臺實際只支持配置一條;content必填,長度大于0,不能為空字符串或者空白字符串 |
| limit_speed_const | list<limit_speed_const_single> | 否 | 基于固定值限速 | 傳空數組[]代表刪除,未傳代表不修改,有傳代表整個數組全量修改,字段limit_speed_const_single詳細說明見下方 |
| limit_speed_const_condition | dict | 否 | limit_speed_const的condition配置 | 傳空對象{}代表刪除,未傳代表不修改,有傳代表整個dict全量修改,格式:{“{key}”:[{“mode”:類型,“content”:“配置內容,多個以逗號間隔”}]},mode類型為int,取值默認0,可以為:0(文件后綴),1(目錄),2(首頁),3(全部文件),4(全路徑),key為limit_speed_const中的id。使用限制:一個key對應的數組大小只能是1,因為配置平臺實際只支持配置一條;content必填,長度大于0,不能為空字符串或者空白字符串 |
詳細參數說明 :
1)參數origin_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| origin | string | 是 | 源站ip或域名 | |
| port | int | 是 | 回源地址端口 | 默認80;支持http自定義端口,http不支持下發443端口;該字段功能由【basic_conf.http_origin_port】字段替代,若兩個字段均傳值需保持一致,且修改以http_origin_port字段為準。 |
| weight | int | 是 | 權重 | 權重,范圍1-100, role和weight都不存在或取值一致時,按輪詢策略,默認10, |
| role | string | 是 | 源站角色 | 取值:master/slave 默認master |
| protocol | string | 否 | 源站類型 | 默認http,目前不支持自定義配置https源站。 |
2)參數xos_origin:
| 參數 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| xos_origin[*].origin | string | 是 | 云存儲XOS源站 | |
| xos_origin[*].ak | string | 否 | 云存儲XOS源站加密ak | ak與sk必須同時填寫 |
| xos_origin[*].sk | string | 否 | 云存儲XOS源站加密sk | ak與sk必須同時填寫 |
3)參數black_referer:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| allow_empty | string | 是 | referer是否允許為空 | 取值"on", “off”,默認“off” |
| allow_list | list< string> | 是 | referer黑名單列表 | |
| referer_empty_protocol | string | 否 | referer允許空協議 | 取值"on", “off”,默認“off” |
4)參數white_referer:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| allow_empty | string | 是 | referer是否允許為空 | 取值"on", “off”,默認“off” |
| allow_list | list< string> | 是 | referer白名單列表 | |
| referer_empty_protocol | string | 否 | referer允許空協議 | 取值"on", “off”,默認“off” |
5)參數user_agent:
| 參數 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| type | int | 是 | 類型 | 枚舉值:0(黑名單),1(白名單) |
| ua | list | 是 | user_agent列表,多個用英文,隔開 |
6)參數filetype_ttl_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| cache_type | int | 是 | 緩存類型 | 1(不緩存);2(遵循源站); 3(強制緩存);4(custom緩存)。 |
| cache_with_args | int | 是 | 是否帶參數緩存 | 0(不帶參數緩存);1(帶參數緩存); 默認0。 |
| mode | int | 否 | 模式 | 0(文件后綴);1(目錄); 2(首頁);3(全部文件);4:(全路徑);5( 正則),默認0 |
| file_type | string | 是 | 緩存文件類型,多個以逗號隔開 | 當模式mode為文件后綴時,緩存文件類型例如:jpg,png,css(以",“分割);當模式mode為目錄時,緩存文件類型例如/test,/a/b/c(不能以”/"結尾);當模式mode為首頁時,緩存文件類型固定為/ ;當模式mode為全部文件時,緩存文件類型固定為/ ;當模式mode為全路徑時,緩存文件類型例如/index.html,/test/*.jpg |
| priority | int | 否 | 優先級 | 范圍:1-100,默認10。 |
| ttl | int | 是 | 緩存時間,單位秒 | 取值范圍:0-94608000。 |
7)參數req_headers_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| key | string | 是 | 自定義回源請求頭名稱 | |
| value | string | 否 | 自定義回源請求頭值 | 默認"" |
8)參數resp_headers_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| key | string | 是 | 自定義響應頭名稱 | |
| value | string | 否 | 自定義響應頭值 | 默認"" |
9)參數error_code_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| code | list< int> | 是 | 錯誤狀態碼 | |
| ttl | int | 是 | 緩存時間 | 單位秒 |
10)參數https_basic:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| force_status | string | 否 | 強制跳轉狀態碼 | 默認:302 |
| http_force | string | 否 | http強制跳轉 | 取值:“on”:跳轉 “off”:不跳轉 |
| https_force | string | 否 | https強制跳轉 | 取值:“on”:跳轉 “off”:不跳轉 |
| origin_protocol | string | 是 | https回源協議 | 取值: http:回http協議回源 https:用https協議回源, follow_request:跟隨訪問協議進行回源 |
11)參數basic_conf:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| follow_302 | int | 否 | 是否拉取跳轉后文件 | 0(否);1(是) |
| use_http2 | int | 否 | 是否開啟http2 | 取值:0(不開啟);1(開啟);默認0 |
| http_origin_port | int | 否 | http請求回源端口 | 未傳不修改;不支持443端口 |
| https_origin_port | int | 否 | https請求回源端口 | 未傳不修改;取值范圍:1-65535 |
12)參數limit_speed_uri_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| id | string | 是 | limit_speed_uri列表內唯一 | 可以考慮使用時間戳拼上列表索引,比如時間戳為11657615509083,拼上序列化0,則id為:116576155090830 |
| unit | string | 是 | 單位 | 可選值b/s,Kb/s,Mb/s |
| args | string | 是 | uri參數名 | |
| time_seg | string | 否 | 時段 | 正則表達式,比如:(08:[2-5][0-9] |
| weight | int | 否 | 優先級 | 默認值10,取值范圍[1,) |
13)參數limit_speed_const_single:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| id | string | 是 | 基于固定值限速唯一標識,limit_speed_const列表內唯一 | 可以考慮使用時間戳拼上列表索引,比如時間戳為11657615509083,拼上序列化0,則id為:116576155090830 |
| rate | int | 是 | 限速值 | 取值范圍[0,) |
| time_seg | string | 否 | 時段 | 正則表達式,比如:(08:[2-5][0-9] |
| unit | string | 是 | 單位 | 可選值b/s(即Byte/s),Kb/s(即KByte/s),Mb/s(即MByte/s) |
| weight | int | 否 | 優先級 | 默認值10,取值范圍[1,) |
返回參數說明:
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| code | int | 是 | 狀態碼,成功100000 |
| message | string | 是 | 描述信息,成功返回success,其他返回異常信息描述 |
| success_number | int | 否 | 操作成功的個數 |
| domain_details | list< object> | 否 | 每個域名操作結果 |
| domain_details[*].domain | string | 否 | 單個域名 |
| domain_details[*].code | string | 否 | 單個域名操作的狀態碼,成功100000 |
| domain_details[*].message | string | 否 | 單個域名操作的描述信息,成功返回success,其他返回異常信息描述 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/domain/batch-update-domain-configuration-information
示例1:
請求參數:
{
"domain": [
"a.a1.daliqc.cn",
"a.a2.daliqc.cn",
"a.a3.daliqc.cn",
"a.a4.daliqc.cn"
],
"product_code": "008",
"ipv6_enable": 2,
"origin": [
{
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
},
{
"role": "master",
"port": 80,
"origin": "test.hnoss.xstore.daliqc.cn",
"weight": 10
}
],
"xos_origin_is": 1,
"xos_origin": {
"origin": "test.hnoss.xstore.daliqc.cn",
"ak": "akxxx",
"sk": "skxxx"
},
"req_host": "www.test.daliqc.cn",
"black_referer": {
"allow_list": [
"www.test1.daliqc.cn"
],
"allow_empty": "on",
"referer_empty_protocol": "on"
},
"user_agent": {
"type": 0,
"ua": [
"linux",
"windows"
]
},
"filetype_ttl": [
{
"ttl": 300,
"file_type": "ts,mp4",
"cache_type": 2,
"mode": 0,
"cache_with_args": 0
}
],
"ip_black_list": "1.1.1.1,2.2.2.2,3.3.3.3",
"resp_headers": [
{
"value": "reqheadertest",
"key": "Test"
}
],
"https_status": "off",
"https_basic": {
"https_force": "on",
"origin_protocol": "https"
},
"basic_conf": {
"follow_302": 1,
"use_http2": 1,
"http_origin_port": 80,
"https_origin_port": 8080
},
"limit_speed_uri": [
{
"id": "116576155090830",
"unit": "Kb/s",
"args": "good",
"weight": 2
}
],
"limit_speed_uri_condition": {
"116576155090830": [
{
"mode": 1,
"content": "/sss"
}
]
},
"limit_speed_const": [
{
"id": "116576155090830",
"unit": "Mb/s",
"rate": 1,
"weight": 2
}
],
"limit_speed_const_condition": {
"116576155090830": [
{
"mode": 1,
"content": "/sss"
}
]
}
}
返回結果:
{
"code": 100000,
"message": "success",
"success_number": 4,
"domain_details": [
{
"code": 100000,
"message": "success",
"domain": "a.a1.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a2.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a3.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a4.daliqc.cn"
}
]
}
錯誤碼請參考:參數code和message含義