調用BatchSetCdnDomainConfig進行域名批量配置。
接口說明
- 單用戶調用頻率：3 次/秒。
- 支持批量配置域名，多個域名用半角逗號（,）分隔，一次最多支持配置 50 個域名。
- 調用 BatchSetCdnDomainConfig 給域名配置某些功能后，將會生成唯一的 ConfigId，通過 ConfigId 可以完成更新和刪除配置操作。具體使用方法，請參見 ConfigId 使用與查詢。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| cdn:BatchSetCdnDomainConfig | update | *Domain acs:cdn:*:{#accountId}:domain/{#DomainNames} |
|
|
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| DomainNames | string | 是 | 加速域名，多個域名用半角逗號（,）分隔。 | www.example.com |
| Functions | string | 是 | 功能列表，格式如下：
parentId 為 -1：表示刪除該配置里面已有的規則條件。 不使用 parentId 的情況下，配置示例如下： 使用函數origin_request_header添加回源 HTTP 請求頭的時候引用了configid=222728944812032的規則條件，請求參數如下： 使用 parentId 的情況下，配置示例如下： 使用函數origin_request_header添加回源 HTTP 請求頭的時候引用了configid=222728944812032的規則條件，請求參數如下： 對一個已經使用了 parentId 的功能配置刪除對 parentId 的引用，配置示例如下： 函數origin_request_header添加回源 HTTP 請求頭的時候已經引用了configid=222728944812032的規則條件，現在要刪掉對規則條件的引用，請求參數如下： | [{"functionArgs": [{"argName": "key","argValue": "Content-Encoding"},{"argName": "value","argValue": "gzip"}],"functionName": "set_resp_header"} ] |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
"DomainConfigList": {
"DomainConfigModel": [
{
"ConfigId": 1234567,
"DomainName": "www.example.com",
"FunctionName": "set_resp_header"
}
]
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidFunctions.Malformed | The specified Functions is incorrectly formatted. | 配置格式錯誤。 |
| 400 | InvalidArgValue.Malformed | The specified ArgValue is invalid. | 參數格式錯誤，請檢查更新后重試。 |
| 400 | Invalid%s.ValueNotSupported | [%s] is not supported. | - |
| 400 | Invalid%s.Malformed | The specified ArgValue [%s] is invalid. | - |
| 400 | MissingParameter%s | The specified value of ArgName[%s] is missing. | 參數不能為空。 |
| 400 | InvalidFunctionArgs.Malformed | The specified FunctionArgs is invalid. | 指定的功能參數是錯誤的。 |
| 400 | MissingParameter | The specified ArgValue is missing. | - |
| 400 | InvalidHeaderKey.ValueNotSupported | The specified value of parameter HeaderKey is not supported. | 指定的HTTP頭參數不合法，超出可選范圍。取值：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。 |
| 400 | TooManyDomains | The count of domain is over 50. | - |
| 400 | InvalidRule.Malformed | %s | - |
| 400 | ConfigurationConflicts | The staging environment has a configuration in effect and cannot modify the production environment configuration. | 現在模擬環境的配置和生產環境配置不一致，無法直接修改生產環境配置。請您前往模擬環境完成您所需的配置，然后發布到生產環境進行覆蓋。 |
| 400 | InvalidFunction.NotSupported | The domain is not supported to set the function. | 域名不支持設置該功能。 |
| 400 | InvalidDomain.BelongToConfigGroup | This Domain activated in configuration group and should modify by config group. | - |
| 400 | EntityNotExist.Role | EntityNotExist.Role | - |
| 400 | MissingParameterFunctions | The specified value of Functions is missing. | - |
| 400 | NoPermission.SLR | The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize AliyunCDNFullAccess or custom policy:Service Name:cdn-ddos.cdn.aliyuncs.com,Role: AliyunServiceRoleForCDNAccessingDDoS,Permission: ram: CreateServiceLinkedRole | 當前用戶沒有創建服務關聯角色的權限，請聯系主賬號或權限管理員授權AliyunCDNFullAccess或授權創建服務關聯角色的自定義權限策略。自定義權限策略的相關信息如下： Service Name：cdn-ddos.cdn.aliyuncs.com 服務關聯角色名稱：AliyunServiceRoleForCDNAccessingDDoS 執行該操作所需的用戶權限：ram:CreateServiceLinkedRole |
| 400 | ConfigExceedLimit | Count of config entries exceeds the limit. | 配置條數超過限制。 |
| 400 | EdgeScriptCountExceedLimit | The number of rules exceeds the default limit. | 超過默認規則數量限制，如需提升數量，請提交工單咨詢。 |
| 400 | EdgeScripOptionsHasInnerConfig | The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket. | 擴展項存在后臺配置或該配置的參數不合法，如有疑問，請提交工單咨詢 |
| 400 | EdgeScriptGrammarNotSupport | A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket. | 存在后臺定制規則或該配置的參數不合法，如有疑問，請提交工單咨詢 |
| 400 | EdgeScriptNotSupportJs | JavaScript rules are not supported. For more information, submit a ticket. | 未開放JS規則，如有疑問，請提交工單咨詢 |
| 400 | ServiceInvokeFailed | Failed to invoke service. | 調用內部服務失敗。 |
| 400 | ConfigParentExceedLimit | Config parent exceed limit. | 已引用的高級條件規則超過閾值。 |
| 400 | Function.InvalidParentId | The specified parentId does not exist. | 指定的規則條件不存在 |
| 400 | BatchSetBusinessError | some configs error:%s | 發生配置錯誤：%s |
| 400 | ConfigDuplicate | Duplicate configuration. This function has already been configured and cannot be added repeatedly. | 配置重復，該功能已經存在配置，不允許重復添加。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-11-26 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-06-13 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-05-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-05-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-03-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |