This tutorial shows you how to ingest API metadata from Azure API Management (APIM) platform into Apigee API hub. You'll use a pre-builtApplication Integration template and a set of scripts to perform a manual and on-demand ingestion of your API data.

Objectives

In this tutorial, you will complete the following steps:

• Step 1:Create an Azure App
• Step 2:Configure Google Cloud resources
• Step 3:Create and publish an integration in Application Integration
• Step 4:Execute the integration to ingest API data from Azure APIM to API hub
• Step 5:Verify and view the ingested API data in API hub

Costs

In this document, you use the following billable components of Google Cloud:

• Application Integration

To generate a cost estimate based on your projected usage, use thepricing calculator.

When you finish the tasks that are described in this document, you can avoid continued billing by deleting the resources that you created. For more information, seeClean up.

Before you begin

1. Ensure the following in your Microsoft Azure portal:

   1. An active Azure account with an active subscription.
   2. An existing Azure APIM service instance deployed within a resource group. For this tutorial, you'll need the names of the APIM service and the resource group, and the Azure subscription ID.

2. Ensure that you do the following in your Google Cloud console:

   1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

      Roles required to select or create a project

      • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
      • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
      Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

      Go to project selector

   2. Verify that billing is enabled for your Google Cloud project.

   3. Make sure that you have the following role or roles on the project:

      • API hub Admin (roles/apihub.admin)
      • Application Integration Admin (roles/integrations.admin)
      • Service Account Admin (roles/iam.serviceAccountAdmin)
      • Service Usage Admin (roles/serviceusage.serviceUsageAdmin)
      • Project IAM Admin (roles/resourcemanager.projectIamAdmin)

      Check for the roles

      1. In the Google Cloud console, go to theIAM page.

         Go to IAM
      2. Select the project.

      3. In thePrincipal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

      4. For all rows that specify or include you, check theRole column to see whether the list of roles includes the required roles.

      Grant the roles

      1. In the Google Cloud console, go to theIAM page.

         Go to IAM
      2. Select the project.
      3. Clickperson_addGrant access.

      4. In theNew principals field, enter your user identifier. This is typically the email address for a Google Account.

      5. In theSelect a role list, select a role.
      6. To grant additional roles, clickaddAdd another role and add each additional role.
      7. ClickSave.

      Alternatively, you can grant theOwner (roles/owner) orEditor (roles/editor) IAM role to your user account. This lets you manage the resources in your project.

   4. Provision API hub in your Google Cloud project.

   5. Provision Application Integration in your Google Cloud project.

      Note: Both API hub and Application Integration must be provisioned within the same location in your project.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used in this tutorial, either delete the project that contains the resources, or keep the project and delete the individual resources.