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