全部产品
Search
文档中心

CDN:SetCdnDomainStagingConfig - 设置模拟环境配置

更新时间:Dec 18, 2024

调用SetCdnDomainStagingConfig设置模拟环境下的加速域名配置。

接口说明

说明 单用户调用频率:30 次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
cdn:SetCdnDomainStagingConfigupdate
*Domain
acs:cdn:*:{#accountId}:domain/{#DomainName}

请求参数

名称类型必填描述示例值
DomainNamestring

加速域名,仅支持单个域名进行设置。

example.com
Functionsstring

功能列表,格式如下:

说明
  • functionName(功能名称):可配置功能请参见功能列表,多个参数之间用半角逗号(,)分隔。
  • argNamefunctionName 的配置项(可配置多个配置项)。
  • argValuefunctionName 的配置项的取值。
  • [
      {
        "functionArgs": [
          {
            "argName": "功能参数 A",
            "argValue": "功能参数 A 对应的值"
          },
          {
            "argName": "功能参数 B",
            "argValue": "功能参数 B 对应的值"
          }
        ],
        "functionName": "功能名称"
      }
    ]
    
    [{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"xxx"}],"functionName":"edge_function"}]

    edge_function 边缘函数功能说明

    所有参数值均按照字符串类型处理。

    功能名称参数
    edge_function:边缘函数必填参数:
    rule:DSL 规则;
    pri:优先级;
    enable:本条规则是否生效,取值范围 on/off;
    可选参数:
    name:规则名称。仅支持英文字母和下划线;
    pos:规则执行位置;
    brk:命中本条规则后,当前执行位置剩余规则均跳过;
    option:option 管控;
    grammar:grammar 管控,可选值:空、es2、js;
    jsmode:js 域名白单管控,可选值:redirect、bypass;

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    04F0F334-1335-436C-A1D7-6C044FE73368
    DomainConfigListarray<object>

    域名配置清单。

    DomainConfigModelobject
    ConfigIdlong

    配置 ID。

    1234567
    DomainNamestring

    域名。

    www.example.com
    FunctionNamestring

    功能名称。

    set_resp_header

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
      "DomainConfigList": [
        {
          "ConfigId": 1234567,
          "DomainName": "www.example.com",
          "FunctionName": "set_resp_header"
        }
      ]
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidFunctionName.ValueNotSupported%s-
    400InvalidArgValue.Malformed%s-
    400ConfigurationConflictsThe staging environment has a configuration in effect and cannot modify the production environment configuration.现在模拟环境的配置和生产环境配置不一致,无法直接修改生产环境配置。请您前往模拟环境完成您所需的配置,然后发布到生产环境进行覆盖。
    400InvalidArgName.ValueNotSupported%s-
    400GrayConfigExistThe domain exists other gray config.域名已经存在其他灰度配置。
    400InvalidRule.Malformed%s-
    400InvalidDomain.BelongToConfigGroupThis Domain activated in configuration group and should modify by config group.-
    400EdgeScriptCountExceedLimitThe number of rules exceeds the default limit.超过默认规则数量限制,如需提升数量,请提交工单咨询。
    400EdgeScripOptionsHasInnerConfigThe extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket.扩展项存在后台配置或该配置的参数不合法,如有疑问,请提交工单咨询
    400EdgeScriptGrammarNotSupportA background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.存在后台定制规则或该配置的参数不合法,如有疑问,请提交工单咨询
    400EdgeScriptNotSupportJsJavaScript rules are not supported. For more information, submit a ticket.未开放JS规则,如有疑问,请提交工单咨询
    400MissingRequiredArgrequired argument missing.功能配置时,缺少必要的参数。

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2024-12-18OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
    2024-04-29OpenAPI 错误码发生变更查看变更详情
    2023-05-25OpenAPI 错误码发生变更查看变更详情