In my previous blog, I have explained what is API management and why it should be used.

This article is to understand, how can we create the new API Management instance.

Using Portal

Using Azure Portal, below two steps are required to be done.

Please note that API management instance creation takes around 20-30 minutes.    For easy access, you can pin it to dashboard to know the progress.  You will also get an email once the API management creation is done.

Create a Resource

Click on “Create a resource” button in left navigation panel. You can find this button at the top of left navigation panel.

Once this button is clicked, you can type “API management” in the search box OR you can select Integration section and API Management would be displayed as shown in the below picture.

Then click on “API Management”. This would bring up create API Management instance panel.

API Management Create Panel

The create panel has few input fields and below are the details of those input fields:

• Name: Unique name of API management resource
• Subscription: The subscription under which this should be created
• Resource group: For logically organizing your resources
• Location: The Azure region where this should be deployed
• Organization Name: Your organization name which is exposing APIs
• Administrator Email: Administrator for this API management instance
• Pricing Tier: For now select Developer.

There are different pricing tiers available Developer, Basic, Standard, Preimum and Consumption.   Developer pricing tier is the least costly and is meant for usage during development and testing of APIs.   Please note that Developer pricing tier does not guarantee any SLA.

Once above information is provided, click on Create button. This should create the API Management instance

Using PowerShell

You can easily create API management resource using the two commands shown below.

First is to create the resource group. You do not need to run it if you already have the intended resource group.

Second is to crate the API management instance. Please note that the input parameters are same as of those explained in the above sction.

New-AzResourceGroup -Name "API-Management-Demo" -Location "West Europe" 

New-AzApiManagement -ResourceGroupName "API-Management-Demo" `
                    -Location "West Europe" `
                    -Name "my-unique-apim-name" `
                    -Organization "myOrganization" `
                    -AdminEmail "myemail@mydomain.com" `
                    -Sku "Developer"

Please note that this script uses the latest AZ PowerShell module. 

Cleaning up the resources

When no longer required, API management instance can be deleted. You can directly delete the resource group and it would delete all the resources present inside that resource group.

Below is the PowerShell command to delete the resource group:

Remove-AzResourceGroup -Name myResourceGroup

I hope this information has helped you to know more about Azure API management. Please comment and let me know your thoughts.