Quickstart: Create an APC Gateway

  • Article

In this quickstart, you learn how to create an Azure Programmable Connectivity (APC) gateway and subscribe to API plans in the Azure portal.

Note

Deleting and modifying existing APC Gateways is not supported during the preview. Please open a support ticket in the Azure Portal if you need to delete an APC Gateway.

Note

Moving an APC Gateway to a different resource group is not supported. If you need to move an APC Gateway to a different resource group, you must delete it and recreate it.

Prerequisites

  • If you don't have an Azure subscription, create a free account before you begin.
  • Register your Azure subscription with the provider Microsoft.ProgrammableConnectivity, following these instructions

Sign in to the Azure portal

Sign in to the Azure portal.

Create a new APC Gateway

  1. In the Azure portal, Search for APC Gateways and then select Create.

    Screenshot of Azure portal showing the search box.

  2. Select the Subscription, Resource Group, and Region for the gateway.

    Screenshot of the create gateway page in Azure portal.

  3. Provide a Name for the gateway and click Next.

Select APIs

  1. Click on the API that you want to use.

  2. Select the country.

  3. Add the plans you want to subscribe to.

    Screenshot of the select APIs page in the Azure portal.

  4. Click Done.

  5. Click Next.

Provide application details

In order to use the operators' APIs, you must provide extra details, which are shared with the operators.

  1. Fill out the Application name, Application description, Legal entity, Tax number, and the privacy manager's email address in the text boxes.

    Screenshot of the application details page in the Azure portal.

  2. Click Next.

Agree to operators' terms and conditions

On the Terms and Conditions page.

  1. Click Awaiting input and then I Agree.

    Screenshot of the terms and conditions page in the Azure portal.

  2. Repeat for each line.

  3. Click Next.

Verify details and create

Once you see the Validation passed message, click Create.

Screenshot of the verify and create page in Azure portal.

Wait for approval

On clicking Create your APC Gateway and one or more Operator API Connections are created. Each Operator API Connection represents a connection between your APC Gateway and a particular API at a particular operator.

Operator API Connections don't finish deploying until the relevant operator has approved your onboarding request. For some operators approval is a manual process, and so may take several days.

After an operator approves your onboarding request for an Operator API Connection, you are able to use APC with that Operator API Connection. This is the case even if your APC Gateway has other Operator API Connections that are not yet approved, with that operator or with another operator.