get-started-create-service-instance.md

title	description	services	documentationcenter	author	manager	editor	ms.service	ms.workload	ms.topic	ms.custom	ms.date	ms.author
Create an Azure API Management instance | Microsoft Docs	Follow the steps of this tutorial to create a new Azure API Management instance.	api-management		vladvino	cflower		api-management	integration	quickstart	mvc	11/28/2017	apimpm

Create a new Azure API Management service instance

Azure API Management (APIM) helps organizations publish APIs to external, partner, and internal developers to unlock the potential of their data and services. API Management provides the core competencies to ensure a successful API program through developer engagement, business insights, analytics, security, and protection. APIM enables you to create and manage modern API gateways for existing backend services hosted anywhere. For more information, see the Overview topic.

This quickstart describes the steps for creating a new API Management instance using the Azure portal.

[!INCLUDE quickstarts-free-trial-note]

Sign in to Azure

Sign in to the Azure portal.

Create a new service

1. From the Azure portal menu, select Create a resource. You can also select Create a resource on the Azure Home page.

   

2. On the New screen, select Integration and then select API Management.

   

3. In the API Management service screen, enter settings.

   

   | Setting | Suggested value | Description | |-------------------------|-----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Name | A unique name for your API Management service | The name can't be changed later. Service name is used to generate a default domain name in the form of {name}.azure-api.net. If you would like to use a custom domain name, see Configure a custom domain.
   Service name is used to refer to the service and the corresponding Azure resource. | | Subscription | Your subscription | The subscription under which this new service instance will be created. You can select the subscription among the different Azure subscriptions that you have access to. | | Resource Group | apimResourceGroup | You can select a new or existing resource. A resource group is a collection of resources that share lifecycle, permissions, and policies. Learn more here. | | Location | West USA | Select the geographic region near you. Only the available API Management service regions appear in the drop-down list box. | | Organization name | The name of your organization | This name is used in a number of places, including the title of the developer portal and sender of notification emails. | | Administrator email | [email protected] | Set email address to which all the notifications from API Management will be sent. | | Pricing tier | Developer | Set Developer tier to evaluate the service. This tier is not for production use. For more information about scaling the API Management tiers, see upgrade and scale. |

4. Choose Create.

   [!TIP] It usually takes between 20 and 30 minutes to create an API Management service. Selecting Pin to dashboard makes finding a newly created service easier.

[!INCLUDE api-management-navigate-to-instance]

Clean up resources

When no longer needed, you can remove the resource group and all related resources by following these steps:

1. In the Azure portal, search for and select Resource groups. You can also select Resource groups on the Home page.

   

2. On the Resource groups page, select your resource group.

   

3. On the resource group page, select Delete resource group.

4. Type the name of your resource group, and then select Delete.

   

Next steps

[!div class="nextstepaction"] Import and publish your first API