How to upgrade Azure SQL Database API version from 2014-04-01 before retirement?

Question

Hello,

I received a notification that the 2014-04-01 API version for Azure SQL Database will be retired by 31 October 2025, and I need to upgrade to a newer stable version to avoid service disruption.

Here are the details of my resource:

• Resource Group: myResourceGroupTM1
• Status: Available
• Location: East US
• Subscription: Azure Subscription
• Subscription ID: b8a78c6e-166d-42a0-8b1c-6dfcf18ec112
• Server Name: ltbd-eventmachine-server.database.windows.net
• Server Admin: ltbd-eventmachine-server-admin
• Pricing Tier: General Purpose: Gen5, 2 vCores
• Earliest Restore Point: 2025-06-26 14:40 UTC

I’m not sure where the 2014-04-01 API version is being used or how to upgrade it. Could someone guide me through:

1. How to identify where the old API version is used?
2. How to update it to a supported version (e.g., 2021-02-01)?
3. Any best practices or tools to assist with this upgrade?

Thanks in advance for your help!

Answer 1

Hello Moazzem Hossain

You have been notified that the Azure SQL Database API version 2014-04-01 will be retired, and the target APIs are APIs for Azure SQL Database management operations, such as changing the pricing tier, adding firewall rules, etc., connecting to Azure SQL Database and Please be assured that the use of data acquisition and update will not be affected. This alert on the azure advisory refers to an update that is being done on the APIs from azure.

Note: Microsoft has sent an alert email to all the customers who have registered for Microsoft.sql (maybe in the past or they are registered currently). You can open Azure portal -> Subscriptions -> Resource Providers, and search for "Microsoft.Sql", if this is registered, you will receive the notification. If there is no SQL resource created in the subscription, you can ignore the notification email or unregister the resource provider to avoid confusion.

If you are currently using the Azure portal, Azure CLI, or Azure PowerShell to manage Azure SQL Database, you do not need to take any action.

If you are using the REST API to manage Azure SQL Database, please make sure that you do not specify [api-version=2014-04-01] as shown below in the URL of the API you are currently calling.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName }?api-version=2014-04-01

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName }?api-version=2021-11-01

when you are using the REST API to manage your databases try to use this below link to change API version of the database, https://learn.microsoft.com/en-us/rest/api/sql/databases/get?view=rest-sql-2021-11-01&tabs=HTTP#code-try-0

The actualizations are still being made and the documentation will be updated soon to include all client versions that needs to be updated.

I request you to refer the below document for further reference,

Azure SQL Database REST API 2014-04-01 Retirement Notice | Microsoft Learn

To check the API version of the sql server, click on sql server overview, and click on json view, where you can check the api version.

I hope this information helps. If the issue still persists, please let us know here. We will respond with more details and try to help you.

If this answers your query, do click Accept Answer and Yes for was this answer helpful.