更新域名配置--视频点播-火山引擎

文档中心

立即注册

导航

更新域名配置

最近更新时间：2024.07.19 15:15:01首次发布时间：2024.07.18 17:51:15

此接口用于更新点播域名配置。

使用说明

此接口为模块级别的覆盖修改，具体说明如下：

如果您未指定某个模块，那么在您提交请求后，该模块的配置将保持不变。
如果您指定了某个模块，那么在您提交请求后，该模块的现有配置将被覆盖。

此接口当前仅支持修改 HTTP 响应头配置模块。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

请求地址：https://vod.volcengineapi.com?Action=UpdateDomainConfig&Version=2023-07-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数	类型	是否必选	示例值	描述
Action	String	是	`UpdateDomainConfig`	接口名称。当前 API 的名称为 `UpdateDomainConfig`。
Version	String	是	`2023-07-01`	接口版本。当前 API 的版本为 `2023-07-01`。
SpaceName	String	是	`test-space`	点播空间名称。您可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
DomainType	String	是	`play`	域名类型。取值如下： `play`：点播加速域名。 `image`：封面加速域名。说明详见域名类型介绍。
Domain	String	是	`example.test.com`	待修改配置的域名。
Config	Object	是	`-`	表示本次修改的配置
ResponseHeaderControl	Object	否	`-`	HTTP 响应头配置模块。不传此参数表示不对该模块进行修改。
ResponseHeader	Object[]	否	`-`	HTTP 响应头配置。空值表示清空该模块配置。
ResponseHeaderAction	Object	是	`-`	点播 CDN 在响应用户请求的时候，对响应头的操作。
ResponseHeaderInstances	Object[]	是	`-`	响应头的配置规则列表。每个规则都包含一个头部的操作配置。您最多可以添加 50 条规则。
Key	String	是	`Content-Disposition`	头部名称。名称不能超过 1,024 个字符，不区分大小写。可包含除以下字符外的可打印 ASCII 字符：下划线（_）、空格、双引号（"）、Delete（ASCII code 127）。同时，不能使用这些特定的名称。
Action	String	是	`set`	对响应头的操作。取值如下： `set`：设置一个头部。设置操作包括添加与修改。如果源站响应中已包含该头部，该头部的值会被覆盖。如果源站响应中没有包含该头部，该头部会被添加。 `delete`: 删除一个头部。
ValueType	String	否	`constant`	`Key` 的取值类型。仅当 `Action` 为 `set` 时有效。取值如下： `constant`：`Key` 的值是一个固定字符串。 `variable`：`Key` 的值来自一个变量。 `customize`：`Key` 的值是一个变量与固定字符串拼接后的字符串。
Value	String	否	`attachment;filename=FileName.xls`	头部的值。仅当 `Action` 为 `set` 时有效。当 `ValueType` 为 `constant` 时，您需要指定一个固定字符串作为头部的值。头部值的长度不能超过 1,024 个字符，可以包含除以下字符外的可打印 ASCII 字符：美元符号（$）、Delete（ASCII code 127）当 `ValueType` 为 `variable` 时，`Key` 的值可以是来自该列表中的某个变量。除了名称包含下划线的变量，列表中的任何一个变量都可以作为 `Key`，并赋予一个固定字符串来替换其已有的值。也就是说，当您使用任意这些名称不包含下划线的变量作为 `Key` 时，其值是可以被覆盖的。当 `ValueType` 为 `customize` 时，`Key` 的值是列表中的变量与固定字符串拼接后的字符串。在拼接的字符串中，变量使用 `${变量名}` 表示。示例值：`${remote_addr}aaa${host}ccc`。
AccessOriginControl	Boolean	否	`false`	在点播 CDN 响应用户请求时，是否校验请求头中的 `Origin` 字段。取值如下： `true`：点播 CDN 会校验 `Origin` 字段。如果校验成功，CDN 会在响应头中包含 `Access-Control-Allow-Origin` 字段。字段值与 `Origin` 字段值相同。如果校验失败，响应头中不会包含 `Access-Control-Allow-Origin` 字段。 `false`：（默认）CDN 不会校验 `Origin` 字段。在响应头中，CDN 会包含 `Access-Control-Allow-Origin` 字段。字段值是您配置的 `Access-Control-Allow-Origin` 的内容。注意该参数仅在以下条件都满足的情况下有效： `Action` 是 `set`。 `Key` 是 `Access-Control-Allow-Origin`。 `ValueType` 是 `constant`。

返回参数

本接口无特有的返回参数。具体请见公共返回参数。

请求示例

https://vod.volcengineapi.com?Action=UpdateDomainConfig&Version=2023-07-01
{
    "SpaceName": "test-space",
    "DomainType": "play",
    "Domain": "example.test.com",
    "Config": {
        "ResponseHeaderControl": {
            "ResponseHeader": [
                {
                    "ResponseHeaderAction": {
                        "ResponseHeaderInstances": [
                            {
                                "Action": "set",
                                "Key": "Access-Control-Allow-Origin",
                                "Value": "*",
                                "AccessOriginControl": false,
                                "ValueType": "constant"
                            }
                        ]
                    }
                }
            ]
        }
    }
}

返回示例

{
    "ResponseMetadata": {
        "Action": "UpdateDomainConfig",
        "Region": "cn-north-1",
        "Service": "vod",
        "Version": "2023-07-01",
        "RequestId": "20230604110420****100232280022D31"
    }
}

错误码

下表列举了本接口特有的错误码。如需了解更多错误码，详见视频点播公共错误码。

状态码	错误码	错误信息	说明
400	InvalidParameter.InvalidDomainType	Domain type must be play/image	DomainType 取值不合法
400	InvalidParameter.DomainNotFound	The domain does not exist	域名不存在
400	InvalidParameter.DomainBeLocked	The domain has been locked. Please contact sre for processing	域名已锁定