Preview API Apps Deprecation
Alex Karcher
Affected Product: Azure Preview API Apps (v1)
Deprecation Date: January 18th, 2017
Removal Date: March 14th, 2017
Mitigation: Redeploy workload to App Service API Apps (v2)
Today we are announcing the deprecation of Preview API Apps, referred to as v1 API Apps for this article. v1 API Apps are deprecated immediately and will be removed from Azure on March 14th. App Service API Apps, referred to as v2 API Apps for this article, are a GA product and still under active development. Redeploy all v1 API App workloads to v2 API Apps by March 14th to avoid a service interruption.
We are excited at the growth we have seen since upgrading v1 API Apps to the App Service infrastructure and announcing general availability of v2 API Apps over a year and a half ago. Read the original announcement for all the improvements introduced in v2 API Apps.
Logic App Impact
Logic Apps had moved away from using the preview API Apps v1 based connectors almost 1 year ago and has since become generally available with over 100 managed connectors.
Please migrate your preview Logic Apps to our GA schema and discontinue use of the preview API APP v1 based connectors, as those connectors will be removed on March 14th, 2017.
API Gateway
API Gateway resources are also deprecated and will also be removed following the API App removal timeline. API Gateway resources are created in each resource group that contains a v1 API App and have the resource type "Gateway" in the portal.
Identifying Preview API Apps (v1)
v1 API Apps are only visible in the "All Resources" page of the Azure Portal, and on the page of the resource group they belong to. They are not visible in the "App Services" page of the Azure Portal by design.
v1 API Apps have the App Type "API App" and the Resource Type "Microsoft.AppService/apiapps" in the Azure portal
Opening the App settings blade on a v1 API App will show an upgrade notice as well.
Identifying App Service API Apps (v2)
v2 API Apps have the App Type "App Service" and the Resource Type "Microsoft.Web/sites" in the Azure portal, and are still under active support and development.
Upgrading Preview API Apps (v1)
Follow this guide to redeploy your v1 API App workload to a v2 API App.
Upgrading Logic Apps v1 Connectors
Use the GA release of Logic Apps with equivalent managed connectors in place of the v1 preview Connectors.
To check that you are no longer consuming a v1 connector, stop all of your v1 API Apps from the portal and check that your logic apps run successfully.
All v1 connectors will be classified as preview API Apps in the portal, shown above.
Preview (v1) API App Not Accessible in Portal
The portal experience for some v1 API Apps and connectors may be unavailable. We recommend you use Azure Resource Explorer or the Azure Resource Manager REST APIs directly to manage these v1 API Apps.
In the Azure Resource Explorer navigate to your subscription, then your resource group. Note that your v1 sites will have both a core site, under Microsoft.AppService, as well as a container site under Microsoft.Web > Sites. The core site contains your business logic, and the container contains your Azure configuration, such as deployment slots and networking settings.
Deprecation Timeline
March 14th: v1 API Apps stop running on Azure
March 28th: v1 API App data deleted from Azure
Additional Support
If you have any issues moving to v2 API Apps please check our MSDN forums, or contact support directly
Opening the App settings blade on a v1 API App will show an upgrade notice as well.
Identifying App Service API Apps (v2)
v2 API Apps have the App Type "App Service" and the Resource Type "Microsoft.Web/sites" in the Azure portal, and are still under active support and development.
Upgrading Preview API Apps (v1)
Follow this guide to redeploy your v1 API App workload to a v2 API App.
Upgrading Logic Apps v1 Connectors
Use the GA release of Logic Apps with equivalent managed connectors in place of the v1 preview Connectors.
To check that you are no longer consuming a v1 connector, stop all of your v1 API Apps from the portal and check that your logic apps run successfully.
All v1 connectors will be classified as preview API Apps in the portal, shown above.
Preview (v1) API App Not Accessible in Portal
The portal experience for some v1 API Apps and connectors may be unavailable. We recommend you use Azure Resource Explorer or the Azure Resource Manager REST APIs directly to manage these v1 API Apps.
In the Azure Resource Explorer navigate to your subscription, then your resource group. Note that your v1 sites will have both a core site, under Microsoft.AppService, as well as a container site under Microsoft.Web > Sites. The core site contains your business logic, and the container contains your Azure configuration, such as deployment slots and networking settings.
Deprecation Timeline
March 14th: v1 API Apps stop running on Azure
March 28th: v1 API App data deleted from Azure
Additional Support
If you have any issues moving to v2 API Apps please check our MSDN forums, or contact support directly