CreateDomainVersion - 创建版本--内容分发网络-火山引擎

文档中心

立即注册

导航

内容分发网络

CreateDomainVersion - 创建版本

最近更新时间：2025.11.07 14:28:29首次发布时间：2025.11.07 14:28:29

在 CDN 中通过复制一个现有版本来创建一个版本。在创建版本时，您可以指定需要修改的 CDN 特性配置。

要使用该 API，请提交工单。

注意

您无法修改版本中的 IPv6 配置和加速区域的配置。

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
Domain	String	是	表示创建哪个域名的配置版本。	`www.example.com`
Message	String	否	表示版本的备注。	`Remarks`
OriginalVersion	String	否	表示复制哪个版本的配置。您可以调用 ListDomainVersions 获取域名下的所有版本的版本号。对于指定的版本，您可以调用 DescribeDomainVersion 获取该版本中的配置。	`V-251105.32062`

返回参数

参数名称	数据类型	参数说明	示例
VersionId	String	表示创建的版本号。	`V-251105.32063`

请求示例

POST https://cdn.volcengineapi.com/?Action=CreateDomainVersion&Version=2021-03-01
{
    "Domain": "xddtest201105-kkkk1.byte-test.com",
    "OriginVersion": "V-251105.32062",
    "Message": "Remarks",
    "OriginProtocol": "http"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20251105144511B6F07E627F4CD864A548",
        "Action": "CreateDomainVersion",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "VersionId": "V-251105.34470"
    }
}

错误码

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