Azure Kubernetes Fleet Manager Preview API lifecycle

The Azure Kubernetes Fleet Manager (Kubernetes Fleet) preview REST APIs (APIs that end in -preview) have a lifespan of approximately one year from their release date. This means that you can expect the 2023-01-02-preview API to be deprecated around January 1, 2024.

We love when people try our preview features and give us feedback, so we encourage you to use the preview APIs and the tools built on them.

After an API version is deprecated, it will no longer function. We recommend you routinely:

• Update your ARM/Bicep/Terraform templates using preview API versions to use the latest compatible version of the API.
• Update any preview SDKs or other tools built on the preview API to the latest version.

You should perform these updates at a minimum every 6-9 months. If you fail to do so, you'll be notified that you're using a soon-to-be deprecated API version as deprecation approaches.

This article covers the Kubernetes Fleet API deprecations. See the AKS preview API lifecycle page for Azure Kubernetes Service (AKS) API deprecations.

Upcoming API deprecations

Completed API deprecations

No Kubernetes Fleet REST API deprecations to date.

How to check API versions in use

If you're unsure what client or tool is using a specific API version, check the activity logs using the following command. Update the API_VERSION with the version you want to check for.

API_VERSION="2023-08-02-preview"
az monitor activity-log list \
    --offset 30d \
    --max-events 10000 \
    --namespace microsoft.containerservice.fleets \
    --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '${API_VERSION}')]"

How to check API versions used in templates

resource symbolicname 'Microsoft.ContainerService/fleets@2023-08-15-preview' = {
    ...
}

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2023-08-15-preview",
  ...
}

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets@2023-08-15-preview"
  ...
}

How to update to a newer API version

• For Azure SDKs: Use a newer API version by updating to a newer version of the SDK.
• For Azure CLI: Update the CLI itself and the fleet extension to the latest version by running az upgrade and az extension update --name fleet.
• For Terraform: Update to the latest version of the AzureRM Terraform module. To find out what version of the API a particular Terraform release is using, check the Terraform release notes or git log this file.
• For other tools: Update the tool to the latest version.