Ingest Microsoft Azure API data into API hub

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

The overall flow of this tutorial involves using a set of provided scripts to configure your environment. First, you'll prepare your Azure and Google Cloud projects. Then, you will deploy a pre-built integration to Google Cloud Application Integration service. Finally, you will manually trigger this integration, which will connect to your Azure API Management instance, retrieve API metadata, transform it, and ingest it into Apigee API hub.

The following diagram illustrates the workflow you'll be setting up:

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 the pricing 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, see Clean up.

Before you begin

1. Ensure the following in your Microsoft Azure account:

   1. An active Azure account with an active subscription.
   2. An existing API Management (APIM) service instance deployed within a resource group. You'll need the names of the APIM service, the resource group, and subscription ID for this tutorial.

2. Ensure that you do the following in 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 the resourcemanager.projects.create permission. Learn how to grant roles.

      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 the IAM page.

         Go to IAM
      2. Select the project.

      3. In the Principal 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 the Role column to see whether the list of roles includes the required roles.

      Grant the roles

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

         Go to IAM
      2. Select the project.
      3. Click person_add Grant access.

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

      5. In the Select a role list, select a role.
      6. To grant additional roles, click add Add another role and add each additional role.
      7. Click Save.

      Alternatively, you can grant the Owner (roles/owner) or Editor (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.

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.