Rychlý Start: vytvoření nové instance služby Azure API Management Service pomocí šablony ARM

V tomto rychlém startu se dozvíte, jak pomocí šablony Azure Resource Manager (šablony ARM) vytvořit instanci služby Azure API Management (APIM). APIM pomáhá organizacím při publikování rozhraní API pro externí, partnerské a interní vývojáře, aby odemkli potenciál jejich dat a služeb. Služba API Management nabízí základní možnosti pro zajištění úspěšného programu s rozhraním API prostřednictvím zapojení vývojářů, informací o podniku, analýz, zabezpečení a ochrany. APIM umožňuje vytvářet a spravovat moderní brány rozhraní API pro stávající služby back-end hostované kdekoli. Další informace najdete v tématu Přehled.

Šablona Resource ARM je soubor JSON (JavaScript Object Notation), který definuje infrastrukturu a konfiguraci projektu. Tato šablona používá deklarativní syntaxi. V deklarativní syntaxi popíšete zamýšlené nasazení, aniž byste museli psát sekvenci programovacích příkazů pro vytvoření tohoto nasazení.

Pokud vaše prostředí splňuje požadavky a jste obeznámeni s používáním šablon ARM, vyberte tlačítko Nasazení do Azure. Šablona se otevře v prostředí Azure Portal.

Nasazení do Azure

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Kontrola šablony

Šablona použitá v tomto rychlém startu je jednou z šablon pro rychlý start Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.4.1008.15138",
      "templateHash": "10451446506799526629"
    }
  },
  "parameters": {
    "apiManagementServiceName": {
      "type": "string",
      "defaultValue": "[format('apiservice{0}', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "The name of the API Management service instance"
      }
    },
    "publisherEmail": {
      "type": "string",
      "minLength": 1,
      "metadata": {
        "description": "The email address of the owner of the service"
      }
    },
    "publisherName": {
      "type": "string",
      "minLength": 1,
      "metadata": {
        "description": "The name of the owner of the service"
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "Developer",
      "allowedValues": [
        "Developer",
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "The pricing tier of this API Management service"
      }
    },
    "skuCount": {
      "type": "int",
      "defaultValue": 1,
      "allowedValues": [
        1,
        2
      ],
      "metadata": {
        "description": "The instance size of this API Management service."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "functions": [],
  "resources": [
    {
      "type": "Microsoft.ApiManagement/service",
      "apiVersion": "2020-12-01",
      "name": "[parameters('apiManagementServiceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]",
        "capacity": "[parameters('skuCount')]"
      },
      "properties": {
        "publisherEmail": "[parameters('publisherEmail')]",
        "publisherName": "[parameters('publisherName')]"
      }
    }
  ]
}

Následující prostředek je definován v šabloně:

Další ukázky šablon pro Azure API Management najdete v šablonách rychlý Start pro Azure.

Nasazení šablony

  1. Vyberte následující obrázek a přihlaste se k Azure a otevřete šablonu. Šablona vytvoří instanci služby API Management s automaticky generovaným názvem.

    Nasazení do Azure

    V tomto příkladu je instance nakonfigurovaná na úrovni pro vývojáře, což je ekonomická možnost pro vyhodnocení API Management Azure. Tato vrstva není pro produkční použití. Další informace o škálování úrovní služby API Management najdete v tématu věnovaném upgradu a škálování.

  2. Vyberte nebo zadejte následující hodnoty.

    • Předplatné: Vyberte předplatné Azure.
    • Skupina prostředků: vyberte vytvořit novou, zadejte jedinečný název pro skupinu prostředků a pak vyberte OK.
    • Oblast: vyberte umístění pro skupinu prostředků. Příklad: střed USA.
    • Publisher e-mailu: zadejte e-mailovou adresu pro příjem oznámení.
    • Publisher název: zadejte název, který zvolíte pro vydavatele rozhraní API.
    • SKU: přijměte výchozí hodnotu pro vývojáře.
    • Počet SKU: přijměte výchozí hodnotu.
    • Umístění: přijměte vygenerované umístění pro službu API Management.

    Vlastnosti šablony API Management

  3. Vyberte zkontrolovat + vytvořit a pak si prohlédněte podmínky a ujednání. Pokud souhlasíte, vyberte vytvořit.

    Tip

    Vytvoření a aktivace služby API Management ve vrstvě pro vývojáře může trvat 30 až 40 minut.

  4. Po úspěšném vytvoření instance obdržíte oznámení:

    Oznámení o nasazení

K nasazení šablony se použije Azure Portal. kromě Azure Portal můžete použít také Azure PowerShell, Azure CLI a REST API. Další informace o dalších metodách nasazení najdete v tématu Nasazení šablon.

Kontrola nasazených prostředků

použijte Azure Portal ke kontrole nasazených prostředků nebo k vypsání nasazených prostředků použijte nástroje, jako je Azure CLI nebo Azure PowerShell.

  1. V Azure Portalvyhledejte a vyberte služby API Management a vyberte instanci služby, kterou jste vytvořili.
  2. Zkontrolujte vlastnosti služby na stránce Přehled .

Stránka s přehledem služby

Když je vaše instance API Management služby online, jste připraveni ji použít. Začněte s kurzem importu a publikování vašeho prvního rozhraní API.

Vyčištění prostředků

Pokud máte v úmyslu pokračovat v práci s dalšími kurzy, můžete chtít ponechat instanci API Management na místě. Pokud už je nepotřebujete, odstraňte skupinu prostředků, která odstraní prostředky ve skupině prostředků.

  1. V Azure Portalvyhledejte a vyberte skupiny prostředků. Skupiny prostředků můžete také vybrat na domovské stránce.

  2. Na stránce skupiny prostředků vyberte skupinu prostředků.

  3. Na stránce skupina prostředků vyberte Odstranit skupinu prostředků.

    Odstranění skupiny prostředků

  4. Zadejte název vaší skupiny prostředků a pak vyberte Odstranit.

Další kroky