SaveWebHostingCustomDomainCorsConfig - 设置静态网站的跨域配置

设置静态网站的跨域配置。

调试

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

授权信息

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

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

请求参数

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

服务空间 ID

226e5213-697c-4a52-b4ff-35a09f8*****
DomainNamestring

域名。

www.example.com
EnableCorsboolean

设置是否开启跨域功能,取值为:

  • true:开启跨域功能。
  • false:不开启跨域功能。
true
AccessControlAllowOriginstring

设置跨域校验规则,默认为“*”,跨域校验规则为:

  • 设置为“*”,不论用户请求里面是否携带“Origin”参数,也不论携带的“Origin”参数为何值,都固定返回“Access-Control-Allow-Origin:*”。
  • 跨域资源共享的响应头值设置了单个或者多个值(多个值之间用“,”分隔)。
    • 如果用户请求头里携带的“Origin”参数值与被设置的任意一个值精确匹配,就会响应对应的跨域头。
    • 如果都没有精确匹配上,则不响应跨域头。
  • 设置为通配符域名,则会校验请求头中 Origin 值是否能匹配上
https://*.example.com, https://*.example.org
AccessOriginControlboolean

当开启跨域检查后,是否检查 Origin 字段。

  • true: 只有在校验通过后才会返回跨域头;
  • false: 不检查 Origin 字段,固定返回配置的跨域头;

可选值,默认为 true。只有在开启跨域功能后该字段才有作用。

true

返回参数

名称类型描述示例值
object

Schema of Response

Codestring

请求返回状态。

  • success:成功。
  • failed:失败。
success
Messagestring

错误信息。

SpaceNotExist
HttpStatusCodestring

HTTP 请求返回的响应状态码,200 表示请求成功。

200
RequestIdstring

唯一请求 ID。

6E2E1770-E9C7-52E9-BF2C-94A0BACFADBE"
Successboolean

请求返回状态。

  • true:成功。
  • false:失败。
true
Databoolean

操作执行结果。

  • true:操作成功。
  • false:操作失败。
true

示例

正常返回示例

JSON格式

{
  "Code": "success",
  "Message": "SpaceNotExist",
  "HttpStatusCode": "200",
  "RequestId": "6E2E1770-E9C7-52E9-BF2C-94A0BACFADBE\"",
  "Success": true,
  "Data": true
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-06-01OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情