发布较新的预览版或稳定 API 版本后,Azure 应用配置控制平面预览 API(所有以 -preview 结尾的控制平面 API)将在 90 天后弃用。 该策略适用于之后发布的所有 API 版本,包括 2023-09-01-preview。
当人们尝试预览功能并提供反馈时,我们非常喜欢,因此我们鼓励你使用预览 API。
API 版本弃用后,它将不再正常运行! 我们建议你定期:
- 使用预览版 API 更新 ARM/BICEP 模板,以使用最新版本的预览版 API。
- 将基于预览版 API 构建的任何预览版 SDK 或其他工具更新到最新版本。
应至少每 6-9 个月执行一次这些更新。 如果无法执行此操作,则会在弃用临近时收到通知,提示你使用的是即将弃用的 API 版本。
注释
2023-09-01-preview 之前的 API 版本不会遵循本文档开头概述的 90 天模式。 请参阅即将弃用表和已完成弃用表,以查看您使用的预览 API 版本是否具有弃用日期。
如何检查正在使用的 API 版本
如果不确定哪个客户端或工具正在使用此 API 版本,请使用以下命令检查活动日志:
API_VERSION=<impacted API version, such as 2021-10-01-preview>
az monitor activity-log list --offset 30d --max-events 10000 --namespace Microsoft.AppConfiguration --query "[?eventName.value == 'EndRequest' && httpRequest.uri != null && contains(httpRequest.uri, '$API_VERSION')].[eventTimestamp, httpRequest.uri]" --output table
如何查找可用的 API 版本
如果想要了解可用的 API 版本,则可以对资源类型使用以下命令:
az provider show --namespace Microsoft.AppConfiguration --query "resourceTypes[?resourceType=='configurationStores'].apiVersions"
如何更新到较新版本的 API
- 对于 Azure SDK:通过更新到较新版本的 SDK 来使用较新的 API 版本。
- 对于 Azure CLI:通常通过运行
az upgrade来更新 CLI 本身。 - 对于 REST 请求:更新
api-version查询参数。 - 对于其他工具:将该工具更新为最新版本。
即将弃用
目前还没有预定的弃用。
已弃用
尚未完成弃用。