Skip to content

Commit 0b111c8

Browse files
committed
clean up command to see what preview apis are being used, clarify old api version deprecation with footnote
1 parent d18859e commit 0b111c8

File tree

1 file changed

+15
-3
lines changed

1 file changed

+15
-3
lines changed

articles/azure-app-configuration/concept-preview-api-lifecycle.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,7 @@ ms.date: 02/12/2025
1212

1313
# Preview API life cycle
1414

15-
The Azure App Configuration preview APIs (APIs that end in `-preview`) have a lifespan of ~one year from their release date.
16-
This means that you can expect the 2024-06-01-preview API to be deprecated somewhere around June 1, 2025.
15+
The Azure App Configuration preview APIs (all APIs that ends in `-preview`) are always deprecated 90 days after a newer preview API version is released. The process may differ for older API versions.[^1]
1716

1817
We love when people try our preview features and give us feedback, so we encourage you to use the preview APIs.
1918

@@ -29,11 +28,22 @@ API version as deprecation approaches.
2928
If you're unsure what client or tool is using this API version, check the [activity logs](/azure/azure-monitor/essentials/activity-log)
3029
using the following command:
3130

31+
### [bash](#tab/bash)
32+
3233
```bash
3334
API_VERSION=<impacted API version, such as 2021-10-01-preview>
34-
az monitor activity-log list --offset 30d --max-events 10000 --namespace Microsoft.AppConfiguration --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '${API_VERSION}')]"
35+
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
36+
```
37+
38+
### [PowerShell](#tab/PowerShell)
39+
40+
```powershell
41+
$API_VERSION=<impacted API version, such as 2021-10-01-preview>
42+
az monitor activity-log list --offset 30d --max-events 10000 --namespace Microsoft.AppConfiguration | ConvertFrom-Json | Where-Object { $_.eventName.value -eq "EndRequest" -and $_.httpRequest.uri -match $API_VERSION } | Select-Object eventTimestamp, httpRequest | Format-Table -Wrap -AutoSize
3543
```
3644

45+
---
46+
3747
## How to find the available API versions
3848

3949
If you want to know what API versions are available, you can use the following command for a resource type:
@@ -58,3 +68,5 @@ az provider show --namespace Microsoft.AppConfiguration --query "resourceTypes[?
5868

5969
| API version | Announce Date | Deprecation Date |
6070
|--------------------|-------------------|-------------------|
71+
72+
[^1]: API versions before 2023-09-01-preview won't follow the 90 day pattern outlined in the beginning of this document. Refer to the [Upcoming Deprecations](#upcoming-deprecations) and [Completed Deprecations](#completed-deprecations) tables to see if an API version you're using has a deprecation date.

0 commit comments

Comments
 (0)