本文档记录了 Volcengine SDK 的版本发布说明。请访问 使用 SDK 调用,获取 SDK 的下载链接。
新版本的 SDK 新增了以下 API:
API 名称 | API 功能 |
---|---|
BatchUpdateCdnConfig | 批量更新加速域名配置 |
AddCertificate | 上传证书(新版) |
DeleteUsageReport | 删除用量导出任务 |
CreateUsageReport | 创建用量导出任务 |
ListUsageReports | 获取用量导出任务列表 |
DescribeDistrictData | 获取访问统计的细分数据 |
DescribeEdgeData | 获取计费区域的细分数据 |
DescribeDistrictSummary | 获取访问统计的汇总数据 |
DescribeEdgeSummary | 获取计费区域的汇总数据 |
DescribeOriginData | 获取回源统计的细分数据 |
DescribeOriginSummary | 获取回源统计的汇总数据 |
DescribeUserData | 获取独立访客的细分数据 |
DescribeDistrictRanking | 获取访问数据的统计排名 |
DescribeEdgeRanking | 获取计费区域的统计排名 |
DescribeOriginRanking | 获取回源数据的统计排名 |
DescribeEdgeStatusCodeRanking | 获取访问状态码的统计排名 |
DescribeOriginStatusCodeRanking | 获取回源状态码的统计排名 |
DescribeStatisticalRanking | 获取热门对象的统计排名 |
DescribeCdnService | 获取 CDN 的计费信息 |
新版本的 SDK 移除了以下 API:
API 名称 | API 描述 | 替换接口 |
---|---|---|
DescribeAccountingData | 获取计费指标的细分数据 | DescribeBillingDetail |
DescribeIPInfo | 查询单个 IP 是否归属 CDN | DescribeCdnUpperIp |
DescribeIPListInfo | 查询多个 IP 是否归属 CDN | DescribeCdnUpperIp |
AddCdnCertificate | 上传证书 | AddCertificate |
DescribeCdnData | 获取访问统计的细分数据 | DescribeDistrictData |
DescribeEdgeNrtDataSummary | 获取访问统计的汇总数据 | DescribeDistrictData |
DescribeCdnOriginData | 获取回源统计的细分数据 | DescribeOriginData |
DescribeOriginNrtDataSummary | 获取回源统计的汇总数据 | DescribeOriginSummary |
DescribeEdgeStatisticalData | 获取独立访客的细分数据 | DescribeUserData |
DescribeEdgeTopNrtData | 获取访问数据的统计排名 | DescribeDistrictRanking |
DescribeOriginTopNrtData | 获取回源数据的统计排名 | DescribeOriginRanking |
DescribeEdgeTopStatusCode | 获取访问状态码的统计排名 | DescribeEdgeStatusCodeRanking |
DescribeOriginTopStatusCode | 获取回源状态码的统计排名 | DescribeOriginStatusCodeRanking |
DescribeEdgeTopStatisticalData | 获取热点及访客的统计排名 | DescribeStatisticalRanking |
DescribeCdnDataDetail | 获取单个域名的省份和 ISP 的细分数据 | 无 |
DescribeDistrictIspData | 获取多个域名的省份和 ISP 的细分数据 | 无 |
说明
无法找到该类型
的错误消息,您需要调整代码。Volcengine SDK for Go 和 Volcengine SDK for Java 的示例代码也更新了。您可以参照更新的示例代码来更新您的代码。
在 Volcengine SDK for Go 的部分 API 中,某些参数的数据类型变更为指针。以下表格列出了受影响的 API。
API 名称 | API 功能 | 变更为指针类型的参数 |
---|---|---|
AddCdnDomain | 添加加速域名 | 参见 AddCdnDomainRequest 参数。 |
UpdateCdnConfig | 修改加速域名配置 | 与 AddCdnDomain 相同。 |
DescribeCdnConfig | 获取加速域名配置 | 参见 DescribeCdnConfigResponse 参数。 |
DescribeContentTasks | 获取刷新与预热任务列表 | EndTime、StartTime |
DescribeContentBlockTasks | 获取 URL 封禁与解封任务列表 | Url、Domain、EndTime、StartTime |
DescribeCdnUpperIp | 获取回源层节点的所有 IP | IpVersion |
DescribeCdnDataDetail | 获取单个域名的省份和 ISP 的细分数据 | Domain |
DescribeEdgeStatisticalData | 获取独立访客的细分数据 | Domain |
DescribeEdgeTopStatisticalData | 获取热点及访客的统计排名 | Metric |
DescribeEdgeTopNrtData | 获取访问数据的统计排名 | EndTime、StartTime |
DescribeOriginTopNrtData | 获取回源数据的统计排名 | EndTime、StartTime |
以 AddCdnDomain 为例,以下的截图演示了如何调整代码。图中红色底色的代码是需要调整的代码,黄色底色的代码是调整后的代码。
在 Volcengine SDK for Java 中的 API 中,某些结构体名称和参数名称有变更。以下表格列出了受影响的 API。
API 名称 | API 功能 | 发生名称变更的参数 |
---|---|---|
AddCdnDomain | 添加加速域名 | 在 AddCdnDomainRequest 参数中:
|
UpdateCdnConfig | 修改加速域名配置 | 在 UpdateCdnConfigRequest 参数中:
|
AddResourceTags | 添加资源标签 | 在 AddResourceTagsRequest 参数中:
|
DeleteResourceTags | 删除资源标签 | 在 DeleteResourceTagsRequest 参数中:
|
UpdateResourceTags | 更新资源标签 | 在 UpdateResourceTagsResponse 参数中:
|
ListResourceTags | 查询标签清单 | 在 ListResourceTagsResponse 参数中:
|
DescribeAccountingData | 获取计费指标的细分数据 | 在 DescribeAccountingDataResponse 参数中:
|
DescribeCdnConfig | 获取域名配置详情 | 在 DescribeCdnConfigResponse 参数中:
|
DescribeCdnDataDetail | 获取单个省份和运营商的细分数据 | 在 DescribeCdnDataDetailResponse 参数中:
|
DescribeCdnData | 获取访问统计的细分数据 | 在 DescribeCdnDataResponse 参数中:
|
DescribeCdnOriginData | 获取回源统计的细分数据 | 在 DescribeCdnOriginDataResponse 参数中:
|
DescribeCdnService | 获取服务相关信息 | 在 DescribeCdnServiceResponse 参数中:
|
DescribeContentBlockTasks | 获取封禁解封任务信息 | 在 DescribeContentBlockTasksResponse 参数中:
|
DescribeEdgeNrtDataSummary | 获取访问统计的汇总数据 | 在 DescribeEdgeNrtDataSummaryResponse 参数中:
|
DescribeEdgeStatisticalData | 获取独立访客的细分数据 | 在 DescribeEdgeStatisticalDataResponse 参数中:
|
DescribeEdgeTopNrtData | 获取访问数据的统计排序 | 在 DescribeEdgeTopNrtDataResponse 参数中:
|
DescribeEdgeTopStatisticalData | 获取热点及访客统计排序 | 在 DescribeEdgeTopStatisticalDataResult 参数中:
|
DescribeEdgeTopStatusCode | 获取访问状态码的统计排序 | 在 DescribeEdgeTopStatusCodeResponse 参数中:
|
DescribeIPListInfo | 批量获取 IP 归属信息 | 在 DescribeIPListInfoResponse 参数中:
|
DescribeOriginNrtDataSummary | 获取回源统计的汇总数据 | 在 DescribeOriginNrtDataSummaryResponse 参数中:
|
DescribeOriginTopNrtData | 获取回源数据的统计排序 | 在 DescribeOriginTopNrtDataResponse 参数中:
|
DescribeOriginTopStatusCode | 获取回源状态码的统计排序 | 在 DescribeOriginTopStatusCodeResponse 参数中:
|
ListCdnDomains | 获取域名列表 | 在 ListCdnDomainsResponse 参数中:
|
以 AddCdnDomain 为例,以下的截图演示了如何调整代码。图中红色底色的代码是需要调整的代码,绿色底色的代码是调整后的代码。
Volcengine SDK for Python 中有一个 API 的名称发生了变更。以下表格列出了受影响的 API。
API 名称 | API 功能 | 变更后的 API 名称 |
---|---|---|
describe_iplist_info | 批量获取 IP 归属信息 | describe_ip_list_info |
新版本的 SDK 新增了以下 API:
在您升级 SDK 前,您可能需要检查您当前正在使用的 SDK 的版本。SDK 的版本就是 SDK 安装包的版本。包版本的查看方法依赖于安装包的工具。以下列表展示了如何在常用的包安装工具中查看 SDK 安装包的版本。
pip list
命令或者 pip show volcengine
命令来查看包的版本。composer show volcengine/volc-sdk-php -i
命令来查看包的版本。mvn -Dverbose dependency:tree
命令来查看包的版本。