Freigeben über


Lernprogramm: Erstellen oder Verknüpfen eines API Centers mit der API-Verwaltung

In diesem Lernprogramm wird gezeigt, wie Sie eine Azure API Management-Instanz in ein Azure API Center integrieren. Wenn eine Verknüpfung hergestellt wird, werden die APIs der API-Verwaltungsinstanz – und optionale API-Definitionen – kontinuierlich mit dem API Center-Bestand synchronisiert. API Center ist ein zentraler Katalog- und Governance-Hub für APIs und zugehörige Artefakte, und API Management-Kunden verwenden es, um APIs zu ermitteln und wiederzuverwenden, Definitionen in teamsübergreifend zu teilen und konsistente Governance- und Lebenszyklusrichtlinien anzuwenden.

Hinweis

Nur ein API Center kann mit einer einzelnen API-Verwaltungsinstanz verknüpft werden.

In diesem Tutorial erfahren Sie:

  • Erstellen eines neuen API Centers und Verknüpfen mit einer API-Verwaltungsinstanz
  • Verknüpfen eines vorhandenen API Center und Synchronisieren von APIs
  • Anzeigen synchronisierter APIs und Entfernen des Links bei Bedarf

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen.

  • Ein Azure-Konto mit einem aktiven Abonnement ist erforderlich. Falls Sie noch über keins verfügen, können Sie ein kostenloses Konto erstellen.
  • Ein vorhandener API-Verwaltungsdienst im Abonnement, in dem Sie APIs verwalten möchten
  • Berechtigungen als Mitwirkender (oder Besitzerrechte) für die API-Verwaltungsressource und die Berechtigung, Ressourcen in einer Ressourcengruppe zu erstellen.

Diese Schritte zeigen, wie Sie ein neues API Center erstellen und mit einer API-Verwaltungsinstanz verknüpfen, damit APIs synchronisiert werden.

  1. Öffnen Sie im Azure-Portal Ihren API-Verwaltungsdienst.

  2. Wechseln Sie im linken Menü zu APIs>API-Center. Die API-Verwaltungsinstanz im Azure-Portal mit API Center wurde im linken Menü hervorgehoben.

  3. Wählen Sie im mittleren Bereich unter "API Center für API-Ermittlung verwenden", "Wiederverwenden" und "Governance" die Option "Neu erstellen" aus.

  4. Wählen Sie auf der Seite "API Center erstellen " die Option "Neuen Link erstellen" aus.

  5. Stellen Sie Werte für die folgenden Felder bereit:

    Feld Einzelheiten
    Ressourcengruppe Wählen Sie eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine neue.
    Standort Wählen Sie eine Region aus. Regionen, die für DAS API Center verfügbar sind, können sich von der Region Ihrer API-Verwaltungsinstanz unterscheiden.
    Name Geben Sie einen eindeutigen Namen für die API Center-Instanz an.
    Preisplan Wählen Sie einen Plan aus.
    Lebenszyklus Wählen Sie den Lebenszyklusstatus aus, der APIs zugeordnet werden soll, wenn sie synchronisiert werden. Diese Metadaten können später geändert werden.
  6. Klicken Sie auf „Erstellen“.

    • Nach Abschluss des Vorgangs sollte eine Meldung "Anforderung erfolgreich " und eine Bestätigung angezeigt werden, dass Der API-Verwaltungsdienst und das API Center synchronisiert werden.

Verwenden eines vorhandenen API-Centers

Diese Schritte zeigen, wie Sie eine API-Verwaltungsinstanz mit einem API Center verknüpfen, das bereits vorhanden ist.

  1. Wählen Sie im Abschnitt "API Center" Ihres API-Verwaltungsdiensts die Option "Vorhandenes API Center verwenden" aus.
  2. Wählen Sie im Dropdownmenü das API Center aus, das Sie verknüpfen möchten.
  3. Wählen Sie "APIs synchronisieren" aus, um die Synchronisierung zwischen dem API-Verwaltungsdienst und dem ausgewählten API Center zu starten.

Anzeigen verknüpfter API Center und synchronisierter APIs

Verwenden Sie diesen Abschnitt, um den Integrationsstatus zu überprüfen und APIs anzuzeigen, die aus der API-Verwaltung synchronisiert wurden.

  1. Wechseln Sie im Azure-Portal zur API Center-Ressource.
  2. Wechseln Sie im API Center-Randleistenmenü zu Plattformen>Integrationen. Der Status für die Integration mit der API-Verwaltung sollte "Verknüpft" und "Synchronisieren" sagen.
  3. Um synchronisierte APIs anzuzeigen, wechseln Sie zu Bestandsressourcen>.
    Ein Symbol wird angezeigt, das angibt, dass die APIs verknüpft sind. Screenshot einer API Center-Instanz im Azure-Portal mit hervorgehobenen Ressourcen im Randleistenmenü und Linksymbolen, die im Hauptbereich hervorgehoben sind

Führen Sie die folgenden Schritte aus, um die Verknüpfung zwischen API-Verwaltung und API Center zu entfernen oder die API Center-Ressource zu löschen.

  1. Wechseln Sie in der API Center-Ressource zu ">".
  2. Suchen Sie die verknüpfte API-Verwaltungsinstanz.
  3. Wählen Sie das Papierkorbsymbol aus, um den Link zu löschen.

Bereinigen von Ressourcen

Löschen Sie alle Ressourcen, die Sie für dieses Lernprogramm erstellt haben, um Gebühren zu vermeiden.

Wenn Sie ein API Center für dieses Lernprogramm erstellt und nicht mehr benötigen, löschen Sie die API Center-Ressource und jede von Ihnen erstellte Ressourcengruppe, um Gebühren zu vermeiden.

Synchronisieren von APIs aus einer API-Verwaltungsinstanz