内容优化--内容分发网络-火山引擎

文档中心

立即注册

内容分发网络

UpdateCdnConfig - 修改加速域名配置

内容优化

API 说明

API 名称：UpdateCdnConfig。
API 域名：cdn.volcengineapi.com。
API 描述：修改加速域名的配置。

注意

该 API 对加速域名的配置模块进行覆盖式修改，说明如下：

在您创建一个 API 请求时，如果未指定某个模块，在您提交 API 请求后，该模块的已有配置不会发生改变。
如果您指定了某个模块，但没有指定该模块下的某个可选参数，则该参数会使用默认值。在您提交 API 请求后，该参数的已有值就会被默认值覆盖。

使用限制

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明

请求方式：POST
请求地址：https://cdn.volcengineapi.com/?Action=UpdateCdnConfig&Version=2021-03-01

公共参数

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `UpdateCdnConfig`。
Version	String	是	接口版本。当前 API 的版本为 `2021-03-01`。

请求正文参数

智能压缩

参数名称	数据类型	是否必选	参数说明	示例
Compression	Object	否	表示 "智能压缩" 特性的配置。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "Compression": {
        "CompressionRules": [
            {
                "CompressionAction": {
                    "CompressionFormat": "all",
                    "CompressionTarget": "*",
                    "CompressionType": [
                        "gzip"
                    ]
                },
                "Condition": {
                    "ConditionRule": [
                        {
                            "Object": "filetype",
                            "Operator": "match",
                            "Type": "url",
                            "Value": "png"
                        }
                    ]
                }
            },
            {
                "CompressionAction": {
                    "CompressionFormat": "customize",
                    "CompressionTarget": "text/xml,text/css",
                    "CompressionType": [
                        "gzip",
                        "br"
                    ],
                    "MinFileSizeKB": 512,
                    "MaxFileSizeKB": 2048
                }
            }
        ],
        "Switch": true
    }
}

页面优化

参数名称	数据类型	是否必选	参数说明	示例
PageOptimization	Object	否	表示 "页面优化" 特性的配置。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "PageOptimization": {
        "Switch": true,
        "OptimizationType": [
            "html",
            "css"
        ]
    }
}

视频拖拽

参数名称	数据类型	是否必选	参数说明	示例
VideoDrag	Object	否	表示 "视频拖拽" 特性的配置。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "VideoDrag": {
        "Switch": false
    }
}

标准 HLS 加密改写

参数名称	数据类型	是否必选	参数说明	示例
RewriteHLS	Object	否	表示 "标准 HLS 加密改写" 特性的配置。要使用该功能，请提交工单。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "RewriteHLS": {
        "Switch": true,
        "SignName": "sign_name"
    }
}

返回参数

由于该 API 没有响应参数，响应正文只有包含请求元数据的 ResponseMetadata 结构体，没有 Result 结构体。

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022010415564801021219713102003D3F",
        "Action": "UpdateCdnConfig",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。

最近更新时间：2025.12.19 16:49:08

这个页面对您有帮助吗？

有用

无用