Synchronizace rozhraní API z instance služby API Management

Tento článek ukazuje, jak integrovat (propojit) instanci služby API Management, aby API instance byla neustále aktuální v inventáři centra API.

Tip

Tento článek vysvětluje, jak integrovat instanci služby API Management z centra rozhraní API. Případně můžete rychle nastavit integraci přímo z instance služby API Management. V levé nabídce vaší instance v části Rozhraní API vyberte Centrum rozhraní API a vyberte cílové centrum rozhraní API ve vašem předplatném, do které chcete synchronizovat rozhraní API.

Note

Když propojte API Center Standard s instancí služby API Management na úrovni Standard, Standard v2, Premium nebo Premium v2, můžete ho nyní používat bez dalších poplatků. Další informace najdete v tématu Plány a funkce centra API.

O integraci instance služby API Management

I když můžete pomocí Azure CLI importovat rozhraní API na vyžádání ze služby Azure API Management do služby Azure API Center, integrace (propojení) instance služby API Management umožňuje průběžnou synchronizaci, aby inventář rozhraní API zůstal aktuální. Azure API Center může také synchronizovat rozhraní API ze zdrojů, včetně služby Amazon API Gateway.

Když instanci služby API Management integrujete jako zdroj rozhraní API, stane se toto:

1. Všechna rozhraní API a volitelně definice rozhraní API (specifikace) z instance služby API Management se přidají do inventáře centra api. Servery MCP a rozhraní API agenta A2A ve službě API Management jsou součástí rozhraní API přidaných do inventáře.
2. V Centru rozhraní API nakonfigurujete prostředí typu Azure API Management .
3. Pro každou synchronizovanou definici rozhraní API ze služby API Management se vytvoří přidružené nasazení .

Rozhraní API služby API Management se automaticky synchronizují do centra rozhraní API při každé změně nastavení existujících rozhraní API (například přidají se nové verze), vytvoří se nová rozhraní API nebo se odstraní rozhraní API. Tato synchronizace je jednosměrná ze služby API Management do centra rozhraní Azure API, což znamená, že aktualizace rozhraní API v centru api se nesynchronují zpět do instance služby API Management.

Note

• Počet integrovaných instancí služby API Management (zdrojů rozhraní API) je omezen .
• Můžete nakonfigurovat integrovanou instanci služby API Management ve virtuální síti.
• Aktualizace rozhraní API ve službě API Management se obvykle synchronizují do centra rozhraní API během několika minut, ale synchronizace může trvat až 24 hodin.
• Definice rozhraní API se také synchronizují do centra rozhraní API, pokud vyberete možnost jejich zahrnutí během integrace.

Entity synchronizované ze služby API Management

Do synchronizovaných rozhraní API v centru rozhraní API můžete přidat nebo aktualizovat vlastnosti metadat a dokumentaci, které zúčastněným stranám pomůžou zjišťovat, pochopit a využívat rozhraní API. Přečtěte si další informace o předdefinovaných a vlastních vlastnostech metadat služby Azure API Center.

Následující tabulka ukazuje vlastnosti entity, které je možné upravit ve službě Azure API Center a vlastnosti nastavené na základě jejich hodnot ve zdroji rozhraní API.

Entity	Vlastnosti konfigurovatelné ve službě API Center	Vlastnosti určené v integrovaném zdroji rozhraní API
API	souhrn lifecycleStage termsOfService licence externalDocumentation customProperties	title description kind
Verze rozhraní API	lifecycleStage	title definice (pokud jsou synchronizované)
Environment	title description druh server.managementPortalUri onboarding customProperties	server.type
Deployment	title description server stav customProperties	server.runtimeUri

Note

Id prostředků a systému pro entity synchronizované s Azure API Center se generují automaticky a není možné je změnit.

Prerequisites

• Centrum rozhraní API ve vašem předplatném Azure. Pokud jste nevytvořili centrum rozhraní API, přečtěte si článek Rychlý start: Vytvoření centra rozhraní API.

• Instance služby Azure API Management ve stejném nebo jiném předplatném. Instance musí být ve stejném adresáři.

• Pro Azure CLI:

  • Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

    

  • Pokud chcete spouštět referenční příkazy CLI lokálně, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

    • Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

  Note

  Příkazy az apic vyžadují apic-extension rozšíření Azure CLI. Rozšíření se dá nainstalovat dynamicky, když spustíte první az apic příkaz, nebo rozšíření můžete nainstalovat ručně. Další informace najdete v tématu Správa rozšíření Azure CLI: Instalace, aktualizace a odebrání.

  Nejnovější změny a aktualizace najdete v apic-extensionpoznámkách k verzi. Některé funkce můžou vyžadovat verzi Preview nebo konkrétní verzi rozšíření.

  Note

  Příklady příkazů Azure CLI můžete spustit v tomto článku v PowerShellu nebo prostředí Bash. Pokud je vyžadována jiná syntaxe proměnných, článek obsahuje samostatné příklady příkazů pro obě prostředí.

Povolit spravovanou identitu ve vašem API centru

V tomto scénáři centrum rozhraní API používá spravovanou identitu pro přístup k prostředkům Azure. V závislosti na vašich potřebách povolte buď systémově přiřazené, nebo jednu či více uživatelsky přiřazených spravovaných identit.

Následující příklady ukazují, jak povolit spravovanou identitu přiřazenou systémem pomocí webu Azure Portal nebo Azure CLI. Na vysoké úrovni jsou kroky konfigurace podobné spravované identitě přiřazené uživatelem.

Portal

1. Na portálu přejděte do centra rozhraní API.
2. V nabídce bočního panelu v části Zabezpečení vyberte Spravované identity.
3. Vyberte Přiřazený systém a nastavte stav na Zapnuto.
4. Vyberte Uložit.

Azure CLI

Pomocí následujícího příkazu az apic update nastavte identitu přiřazenou systémem v centru rozhraní API. Nahraďte jména svého centra API a skupiny prostředků.

az apic update --name <api-center-name> --resource-group <resource-group-name> --identity '{"type": "SystemAssigned"}'

Přiřaďte spravované identitě roli Čtenář služby API Management

Pokud chcete povolit import rozhraní API, přiřaďte spravované identitě centra API roli Čtenář služby Správa rozhraní API ve vaší instanci Správy rozhraní API. Můžete použít portál nebo Azure CLI.

Portal

1. Na portálu přejděte do vaší instance služby API Management.
2. V nabídce vlevo vyberte Řízení přístupu (IAM).
3. Vyberte + Přidat přiřazení role.
4. Na stránce Přidat přiřazení role nastavte hodnoty následujícím způsobem:
   1. Na kartě Role vyberte čtečku služby API Management.
   2. Na kartě Členové, v části Přiřadit přístup k – Vyberte Spravovanou identitu>+ Vybrat členy.
   3. Na stránce Vybrat spravované identity vyberte spravovanou identitu přiřazenou systémem centra rozhraní API, kterou jste přidali v předchozí části. Klepněte na tlačítko Vybrat.
   4. Vyberte Zkontrolovat + přiřadit.

Azure CLI

1. Získejte hlavní ID identity. Pro identitu přiřazenou systémem použijte příkaz az apic show .

   #! /bin/bash
   apicObjID=$(az apic show --name <api-center-name> \
       --resource-group <resource-group-name> \
       --query "identity.principalId" --output tsv)
   

   # Formatted for PowerShell
   $apicObjID=$(az apic show --name <api-center-name> `
       --resource-group <resource-group-name> `
       --query "identity.principalId" --output tsv)
   

2. Pomocí příkazu az apim show získejte ID prostředku své instance API Management.

   #! /bin/bash
   apimID=$(az apim show --name <apim-name> --resource-group <resource-group-name> --query "id" --output tsv)
   

   # Formatted for PowerShell
   $apimID=$(az apim show --name <apim-name> --resource-group <resource-group-name> --query "id" --output tsv)
   

3. Pomocí příkazu az role assignment create přiřaďte spravované identitě roli API Management Service Reader ve vaší instanci API Management.

   #! /bin/bash
   scope="${apimID:1}"
   
   az role assignment create \
       --role "API Management Service Reader Role" \
       --assignee-object-id $apicObjID \
       --assignee-principal-type ServicePrincipal \
       --scope $scope 
   

   # Formatted for PowerShell
   $scope=$apimID.substring(1)
   
   az role assignment create `
       --role "API Management Service Reader Role" `
       --assignee-object-id $apicObjID `
       --assignee-principal-type ServicePrincipal `
       --scope $scope 
   

Integrace instance služby API Management

Instanci služby API Management můžete integrovat pomocí portálu nebo Azure CLI.

Portal

1. Na portálu přejděte do centra rozhraní API.
2. V části Platformy vyberte Integrace.
3. Vyberte + Nová integrace>ze služby Azure API Management.
4. Integrujte službu Azure API Management:
   1. Vyberte, jestli se mají synchronizovat všechna rozhraní API z instance služby API Management, nebo jenom rozhraní API, která jsou v pracovním prostoru služby API Management.
   2. Vyberte předplatné, skupinu prostředků a službu Azure API Management , kterou chcete integrovat. Pokud chcete synchronizovat pouze rozhraní API z pracovního prostoru, vyberte možnost Zvolit pracovní prostor.
   3. V podrobnostech o integraci zadejte identifikátor. Pokud jste ještě nenakonfigurovali spravovanou identitu s přístupem k instanci služby API Management, povolte automatickou konfiguraci spravované identity a přiřaďte oprávnění. Tento výběr automaticky přiřadí systémem centra API přidělenou spravovanou identitu s potřebnými oprávněními k synchronizaci rozhraní API z instance API Management.
   4. V části Podrobnosti o prostředí zadejte název prostředí (název ), typ prostředí a volitelný popis.
   5. V podrobnostech rozhraní API:
      1. Vyberte životní cyklus synchronizovaných rozhraní API. (Tuto hodnotu pro rozhraní API můžete aktualizovat po jejich přidání do centra rozhraní API.)
      2. Volitelně můžete vybrat, jestli se mají zahrnout definice rozhraní API se synchronizovanými rozhraními API.
5. Vyberte Vytvořit.

Azure CLI

Spuštěním příkazu az apic integration create apim integrujte instanci služby API Management do centra rozhraní API.

Note

• Tento příkaz je k dispozici pouze ve verzi Preview rozšíření APIC.
• Před použitím tohoto příkazu nainstalujte novou verzi Preview.

• Zadejte názvy skupiny prostředků, centra rozhraní API a integrace.

• Pokud jsou instance služby API Management a centrum rozhraní API ve stejné skupině prostředků, můžete jako hodnotu zadat azure-apimnázev instance služby API Management. V opačném případě zadejte ID prostředku Azure.

az apic integration create apim \
    --resource-group <resource-group-name> \
    --service-name <api-center-name> \
    --integration-name <apim-integration-name> \
    --azure-apim <apim-instance-name>

Instance API Management je integrovaná jako prostředí ve vašem centru API. Rozhraní API služby API Management se synchronizují do inventáře centra rozhraní API.

Smazat integraci

I když je zdroj rozhraní API integrovaný, nemůžete odstranit synchronizovaná rozhraní API z centra rozhraní API. Pokud potřebujete, můžete integraci odstranit. Když odstraníte integraci:

• Synchronizovaná rozhraní API v inventáři centra API se odstraní.
• Prostředí a nasazení, které jsou přidružené ke zdroji rozhraní API, jsou odstraněny.

Integraci můžete odstranit pomocí portálu nebo Azure CLI.

Portal

1. Na portálu přejděte do centra rozhraní API.
2. V části Prostředky vyberte Integrace prostředí>(Preview).
3. Vyberte integraci a pak vyberte Odstranit (ikona koše).

Azure CLI

Spuštěním příkazu az apic integration delete (Preview) odstraňte integraci. Zadejte názvy skupiny prostředků, centra rozhraní API a integrace.

az apic integration delete \
    --resource-group <resource-group-name> \
    --service-name <api-center-name> \
    --integration-name <integration-name> \

Související obsah

• Správa inventáře rozhraní API pomocí příkazů Azure CLI
• Import rozhraní API ze služby API Management do centra azure API
• Registrace a zjišťování serverů MCP v centru rozhraní API
• Dokumentace ke službě Azure API Management