查询加速域名的部署历史信息

更新时间:2024-03-19 17:45:13

适用产品

CDN Pro

接口描述

该接口用来查询加速域名在生产和演练环境的历史部署信息。可通过查询参数指定查询起止时间。

调用频率

单用户调用频率:300/5min

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Params 参数

参数名称描述
startdateString
指定查询开始时间,以RFC 3339日期格式表示。必须使用UTC时区,不支持指定其它时区。示例:startdate=2019-11-14T00:00:00Z。如果开始时间未指定,则默认为您开通CDN Pro服务的时间。
enddateString
指定查询结束时间,以RFC 3339日期格式表示。必须使用UTC时区,不支持指定其它时区。示例:enddate=2019-12-14T00:00:00Z。如果结束时间未指定,则默认为当前时间。
targetString
取值范围: all,staging,production 默认值: all 根据加速域名的部署环境过滤。该值可以是'all', 'staging', 或'production',分别表示所有环境,演练环境和生产环境。

Path 参数

参数名称描述
*hostnameString
加速域名。

返回参数

Body 参数

参数名称描述
hostnameString
加速域名。
historyList
加速域名部署到生产环境或从生产环境卸载的历史信息。如果加速域名从未部署到生产环境,则返回空对象。
targetString
加速域名所部署的环境。
propertyIdString
加速域名对应的加速项目的ID。
deploymentDateString
RFC 3339格式的日期,表示加速项目的部署时间,采用UTC时区。示例:'2020-04-24T20:09:15Z'。
undeploymentDateString
RFC 3339格式的日期,表示加速项目的卸载时间,采用UTC时区。示例:'2020-04-24T20:09:15Z'。

错误码

错误代码(code)描述(message)HTTP状态码语义
InvalidDateInvalid parameter 'startdate'. 'abc' is not a valid RFC3339 timestamp in UTC. The timestamp should be in "yyyy-MM-dd'T'HH:mm:ss'Z'" format.400startdate参数取值无效。必须采用RFC3339日期格式,必须是UTC时区。日期格式为:"yyyy-MM-dd'T'HH:mm:ss'Z'"。

示例

200
400
200
请求示例
复制代码 复制成功
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://open.chinanetcenter.com/cdn/hostnames/historical/{hostname}" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json"
返回示例
复制代码 复制成功
{
    "hostname": "test20201203.com",
    "history": [
        {
            "target": "staging",
            "propertyId": "8453f93ad91fd4338eb87510",
            "deploymentDate": "2021-01-29T08:06:38Z",
            "undeploymentDate": "2021-01-29T09:30:49Z"
        },
        {
            "target": "production",
            "propertyId": "8453f93ad91fd4338eb87510",
            "deploymentDate": "2021-01-29T09:30:49Z",
            "undeploymentDate": "2021-01-29T09:35:42Z"
        },
        {
            "target": "staging",
            "propertyId": "8453f93ad91fd4338eb87510",
            "deploymentDate": "2021-01-29T09:35:42Z",
            "undeploymentDate": "2021-01-29T09:38:22Z"
        },
        {
            "target": "staging",
            "propertyId": "8453f93ad91fd4338eb87516",
            "deploymentDate": "2021-02-13T08:06:12Z"
        }
    ]
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!