Snabbstart: Skapa en ny Azure API Management-tjänstinstans med hjälp av Bicep

Den här snabbstarten beskriver hur du använder en Bicep-fil för att skapa en Azure API Management-tjänstinstans (APIM). APIM hjälper organisationer att publicera API:er till externa partner och interna utvecklare för att frigöra potentialen i sina data och tjänster. API Management lägger grunden till ett effektivt API-program genom engagerade utvecklare, affärsinsikter, analyser, hög säkerhet och skydd. Med APIM kan du skapa och hantera moderna API-gatewayer för befintliga backend-tjänster som finns var som helst. Mer information finns i Översikt.

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. Den ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder den bästa redigeringsupplevelsen för dina lösningar med infrastruktur som kod i Azure.

Krav

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Granska Bicep-filen

Bicep-filen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

@description('The name of the API Management service instance')
param apiManagementServiceName string = 'apiservice${uniqueString(resourceGroup().id)}'

@description('The email address of the owner of the service')
@minLength(1)
param publisherEmail string

@description('The name of the owner of the service')
@minLength(1)
param publisherName string

@description('The pricing tier of this API Management service')
@allowed([
  'Developer'
  'Standard'
  'Premium'
])
param sku string = 'Developer'

@description('The instance size of this API Management service.')
@allowed([
  1
  2
])
param skuCount int = 1

@description('Location for all resources.')
param location string = resourceGroup().location

resource apiManagementService 'Microsoft.ApiManagement/service@2021-08-01' = {
  name: apiManagementServiceName
  location: location
  sku: {
    name: sku
    capacity: skuCount
  }
  properties: {
    publisherEmail: publisherEmail
    publisherName: publisherName
  }
}

Följande resurs definieras i Bicep-filen:

I det här exemplet konfigurerar Bicep-filen API Management instansen på developer-nivån, ett ekonomiskt alternativ för att utvärdera Azure API Management. Den här nivån är inte till för produktionsanvändning.

Fler Azure API Management Bicep-exempel finns i Azure-snabbstartsmallar.

Distribuera Bicep-filen

Du kan använda Azure CLI eller Azure PowerShell för att distribuera Bicep-filen. Mer information om hur du distribuerar Bicep-filer finns i Distribuera.

  1. Spara Bicep-filen som main.bicep på din lokala dator.

  2. Distribuera Bicep-filen med antingen Azure CLI eller Azure PowerShell.

    az group create --name exampleRG --location eastus
    
    az deployment group create --resource-group exampleRG --template-file main.bicep --parameters publisherEmail=<publisher-email> publisherName=<publisher-name>
    

    Ersätt publisher-name> och > med namnet på API-utgivarens organisation och e-postadressen för att ta emot meddelanden.

    När distributionen är klar bör du se ett meddelande som anger att distributionen lyckades.

Granska distribuerade resurser

Använd Azure Portal, Azure CLI eller Azure PowerShell för att visa en lista App Configuration distribuerade resursen i resursgruppen.

az resource list --resource-group exampleRG

När din API Management-tjänstinstans är online är du redo att använda den. Börja med självstudien för att importera och publicera ditt första API.

Rensa resurser

Om du planerar att fortsätta arbeta med efterföljande självstudier kanske du vill lämna API Management instansen på plats. Ta bort resursgruppen när den inte längre behövs, vilket tar bort resurserna i resursgruppen.

az group delete --name exampleRG

Nästa steg