ReleaseDomainVersion - 发布指定的版本--内容分发网络-火山引擎

文档中心

立即注册

导航

内容分发网络

ReleaseDomainVersion - 发布指定的版本

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

将一个版本发布到指定的环境。

关于如何在预发布环境中测试域名配置，参见预发布版本。

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
Domain	String	否	表示一个域名，发布该域名下的指定版本。	`www.example.com`
Env	String[]	否	表示版本发布到的环境，有以下取值： `prod`：表示线上环境。 `staging`：表示预发布环境。该参数的默认值是 `["prod"]`。	`["prod","staging"]`
VersionId	String	否	表示待发布的版本号。您可以调用 ListDomainVersions 获取域名下的所有版本号。	`V-251105.32062`

返回参数

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

请求示例

POST https://cdn.volcengineapi.com/?Action=ReleaseDomainVersion&Version=2021-03-01
{
    "Domain": "wwww.example.com",
    "VersionId": "V-251105.74028",
    "Env": [
        "prod",
        "staging"
    ]
}

错误码

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