预览 API 生命周期

发布较新的预览版或稳定 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 查询参数。
  • 对于其他工具:将该工具更新为最新版本。

即将弃用

目前还没有预定的弃用。

已弃用

尚未完成弃用。