Skip to content

Files

Latest commit

poojapoojaripoojapoojari
Updated image name for US-1890458.
Jan 12, 2022
877ebd0 · Jan 12, 2022

History

History
85 lines (52 loc) · 5.32 KB

get-started-create-service-instance.md

File metadata and controls

85 lines (52 loc) · 5.32 KB
title description author ms.service ms.topic ms.custom ms.date ms.author
Quickstart - Create an Azure API Management instance
Create a new Azure API Management service instance by using the Azure portal.
dlepow
api-management
quickstart
mvc, mode-portal, devdivchpfy22
12/10/2021
danlep

Quickstart: Create a new Azure API Management service instance by using the Azure portal

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.

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

[!INCLUDE quickstarts-free-trial-note]

:::image type="content" source="media/get-started-create-service-instance/get-started-create-service-instance-created-1.png" alt-text="Screenshot of API Management instance.":::

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.

    :::image type="content" source="media/get-started-create-service-instance/create-resource.png" alt-text="Select Create a resource.":::

  2. On the Create a resource page, select Integration > API Management.

    :::image type="content" source="media/get-started-create-service-instance/create-resource-page.png" alt-text="Screenshot of New Azure API Management instance.":::

  3. In the Create API Management page, enter settings.

    :::image type="content" source="media/get-started-create-service-instance/create-api-management-instance-1.png" alt-text="Create API Management instance.":::

    Setting Description
    Subscription The subscription under which this new service instance will be created.
    Resource group Select a new or existing resource group. A resource group is a logical container into which Azure resources are deployed and managed.
    Region Select a geographic region near you from the available API Management service locations.
    Resource name A unique name for your API Management service. The name can't be changed later. The service name refers to both the service and the corresponding Azure resource.
    The service name is used to generate a default domain name: <name>.azure-api.net. If you would like to configure a custom domain name later, see Configure a custom domain.
    Organization name The name of your organization. This name is used in many places, including the title of the developer portal and sender of notification emails.
    Administrator email The email address to which all the notifications from API Management will be sent.
    Pricing tier Select Developer tier to evaluate the service. This tier isn't for production use. For more information about scaling the API Management tiers, see upgrade and scale.

  4. Select Review + create.

    [!TIP] It can take 30 to 40 minutes to create and activate an API Management service in this tier. To quickly find a newly created service, select Pin to dashboard.

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

Review the properties of your service on the Overview page.

:::image type="content" source="media/get-started-create-service-instance/get-started-create-service-instance-created-1.png" alt-text="API Management instance.":::

When your API Management service instance is online, you're ready to use it. Start with the tutorial to import and publish your first API.

Clean up resources

When no longer needed, you can remove the resource group and all the 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.

    :::image type="content" source="media/get-started-create-service-instance/resource-groups.png" alt-text="Resource group navigation.":::

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

    :::image type="content" source="media/get-started-create-service-instance/resource-group-page.png" alt-text="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.

    :::image type="content" source="media/get-started-create-service-instance/delete-resource-group.png" alt-text="Delete resource group.":::

Next steps

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