DescribeDomainEnvVersion - 获取环境中的发布版本--内容分发网络-火山引擎

文档中心

立即注册

导航

内容分发网络

DescribeDomainEnvVersion - 获取环境中的发布版本

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

获取指定域名在线上环境和预发布环境中发布的版本，以及上一次发布到这两个环境中的版本。

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
Domain	String	是	表示要查询的域名。	`www.example.com`

返回参数

参数名称	数据类型	参数说明	示例
LastProdVersion	String	表示上一个发布到线上环境的版本号。	`V-251105.32062`
LastStagingVersion	String	表示上一个发布到预发布环境的版本号。	`V-251105.94145`
ProdVersion	String	表示发布到线上环境的版本号。	`V-251105.94145`
StagingVersion	String	表示发布到预发布环境的版本号。如果该参数值为空（""），表示没有任何版本发布到预发布环境。	`V-251105.34470`

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeDomainEnvVersion&Version=2021-03-01
{
    "Domain": "www.example.com"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2025110516301894081A19C76AF7039175",
        "Action": "DescribeDomainEnvVersion",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "LastProdVersion": "V-251105.32062",
        "LastStagingVersion": "V-251105.94145",
        "ProdVersion": "V-251105.94145",
        "StagingVersion": "V-251105.34470"
    }
}

错误码

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