ListDomainVersions - 获取指定域名下的版本--内容分发网络-火山引擎

文档中心

立即注册

导航

ListDomainVersions - 获取指定域名下的版本

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

获取指定域名下的所有版本。

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
Domain	String	是	表示一个域名，获取该域名下的所有预发布版本。	`www.example.com`
PageNum	Long	否	表示页号，展示该分页上的版本。该参数的默认值是 `1`。	`1`
PageSize	Long	否	表示分页包含的版本数量，默认值是 `10`。	`10`

返回参数

参数名称	数据类型	参数说明	示例
TotalCount	Long	表示域名下的版本数量。	`3`
Versions	Object[]	表示版本列表。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20251105153322384BF8C1FCC624027479",
        "Action": "ListDomainVersions",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "TotalCount": 3,
        "Versions": [
            {
                "CreateTime": 1762325488,
                "Creator": "example@example.com",
                "Env": [],
                "Message": "",
                "OriginalVersion": "V-251105.34470",
                "ReleaseTime": 1762325488,
                "UpdateTime": 1762325488,
                "VersionId": "V-251105.94145"
            },
            {
                "CreateTime": 1762325111,
                "Creator": "openapi_autotest",
                "Env": [],
                "Message": "Remarks",
                "OriginalVersion": "V-251105.32062",
                "ReleaseTime": 1762325111,
                "UpdateTime": 1762325111,
                "VersionId": "V-251105.34470"
            },
            {
                "CreateTime": 1762312530,
                "Creator": "System",
                "Env": [
                    "prod"
                ],
                "Message": "Built by system automatically",
                "OriginalVersion": "",
                "ReleaseTime": 1762312530,
                "UpdateTime": 1762312530,
                "VersionId": "V-251105.32062"
            }
        ]
    }
}

错误码

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