Easily Understand Azure API Management

Introduction 

In the past, if you created a Web API application, you could directly deploy to Azure portal. But nowadays you can’t do that. You must create an API management gateway on Azure portal and only through API management can you deploy Web API applications. In this post, we will see all the steps to create an API management on Azure portal and deploy one sample Web API application into Azure portal as well.  

Azure API Management is a hybrid, multi cloud management platform for APIs across all environments. 

Azure API Management helps customers meet these challenges: 

  • Abstract backend architecture diversity and complexity from API consumers 
  • Securely expose services hosted on and outside of Azure as APIs 
  • Protect, accelerate, and see APIs 
  • Enable API discovery and consumption by internal and external users 

API Management components 

Azure API Management is made up of an API gateway, a management plane, and a developer portal. These components are Azure-hosted and fully managed by default. API Management is available in various tiers differing in ability and features. 

Image courtesy: https://docs.microsoft.com/  

We can create an Azure API management now. 

Create an API Management on Azure portal 

We can go to the Azure portal and choose to create a resource and search for API management. 

We can choose API management and click the Create button.  

This will ask for the required information.  

We can choose or create a new resource group and choose a region. Also, we can give a valid resource name, organization name and administrator email address.  

Now we can choose the pricing tier for API management. 

The developer tier is having the lower price. You can find all the price details from the link below. 

https://azure.microsoft.com/en-us/pricing/details/api-management/

We can choose the required protocol from the list.  

Finally, we can review it and create the API management now. 

It will take some time to complete the resource creation. (Usually, it takes up to 2 hours to finish the API management deployment.) 

You will get a mail from Microsoft after the API management is created. 

Above is the overview of newly created API management. We can see the developer portal URL and gateway URL in the above overview.  

We must create APIs from given templates in API management before deploying our Web API applications to Azure portal. By default, we can see an Echo API automatically created inside the API management.

We can remove the default Echo API and create our own APIs. There are various templates available in the API management for API creation. We can create any number of APIs under an API management.  

We can click Add APIs button and choose the HTTP template and create an API now.  

We can choose Basic or Full options.  

Full choice has more properties.  

We can choose Basic option and give display name and name properties.  

We can ignore other optional properties for now.  

After creating the HTTP API, we can create a Web API in Visual Studio and deploy it to Azure portal.  

Create .NET 6.0 Web API using Visual Studio 2022 

After creating the project, we can create a new API controller using scaffolding template. 

We have now created a new controller with all CRUD actions.  

We can publish this API project to Azure portal.  

Right click the solution explorer and choose the Publish menu.  

We can choose the Azure as target. You must login to the Azure portal before going ahead.  

We can choose Azure App service (Windows) and click the next button. 

We can add a new App Service now.

If you have already created an App service, you can choose from the given list. 

We can choose the API management and HTTP API that we have already created on the Azure portal. 

We can click the Finish button to create deployment steps.

We can click the Publish button to deploy our Web API to Azure portal. Our deployment will be completed in a few minutes.  

We can open the swagger documentation of API application and check whether it is working or not.  

We can open the API management on Azure portal and see those new methods we have created in the Web API application are available here as well.  

If you click the three dots menu near to the API, we can see that many options like Clone, add revision, add version, import, export, create power connector, and delete are available here.

There are many prominent features available in Azure API management. We can see those features in another post.  

Conclusion 

In this post, we have seen how to create an Azure API management in Azure portal, and we have deployed one Web API application to the Azure portal using API management. We will see more features of Azure API management in upcoming articles.