Erste Schritte mit API Gateway und dem API-Hub

In dieser Anleitung erfahren Sie, wie Sie API Gateway mit dem API-Hub verbinden, um die API-Metadaten aus Ihrem API Gateway-Projekt nahtlos im API-Hub zu veröffentlichen.

In dieser Anleitung verwenden Sie die Google Cloud -Konsole.

Aufgabenliste

Verwenden Sie beim Durcharbeiten der Anleitung die folgende Aufgabenliste. Alle Aufgaben sind erforderlich, um API Gateway mit dem API-Hub zu verbinden.

1. Führen Sie die unter Vorbereitung beschriebenen Schritte aus.

2. API in API Gateway bereitstellen

3. API Gateway-Projekt an API-Hub anhängen

4. API Gateway-API im API-Hub ansehen

5. Vermeiden Sie Gebühren, die Ihrem Google Cloud-Konto in Rechnung gestellt werden. Siehe Bereinigen.

Hinweise

Bevor Sie beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:

1. API Gateway in Ihrem Projekt einrichten

2. API-Hub in Ihrem Hostprojekt einrichten

API Gateway in Ihrem Projekt einrichten

So richten Sie API Gateway in Ihrem Projekt ein:

1. Rufen Sie in der Google Cloud Console die Seite API Gateway auf.

   Zu API Gateway

   Hinweis: Wenn Sie die Ressourcen, die Sie in dieser Anleitung erstellen, danach nicht weiter verwenden wollen, erstellen Sie ein neues Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

2. Für API Gateway müssen Sie die folgenden Google-Dienste aktivieren:

   Name	Titel
   apigateway.googleapis.com	API Gateway API
   servicemanagement.googleapis.com	Service Management API
   servicecontrol.googleapis.com	Service Control API

   Wenn Sie diese Dienste für das ausgewählte Projekt nicht aktiviert haben, werden Sie jetzt dazu aufgefordert.

3. Hier kannst du überprüfen, ob das der Fall ist.

   Weitere Informationen zum Aktivieren der Abrechnung

API-Hub in Ihrem Hostprojekt einrichten

1. Erstellen Sie ein Google Cloud -Projekt oder wählen Sie eines aus, das als Hostprojekt verwendet werden soll.

   Ein Hostprojekt ist ein Google Cloud Projekt in Ihrer Google Cloud Organisation, das Sie als Nutzerprojekt für alle API-Hubressourcen festlegen. Pro Hostprojekt kann genau eine API-Hubinstanz bereitgestellt werden.

   Damit APIs in allen API-Gateways zentral ermittelt werden können, empfehlen wir, ein dediziertes Hostprojekt für die API-Hubinstanz zu verwenden und mehrere API-Gateway-Projekte, die als Laufzeitprojekte bezeichnet werden, an die API-Hubinstanz anzuhängen.

   Wenn bereits eine Instanz des API-Hubs in Ihrer Google Cloud -Organisation oder Ihrem Google Cloud -Ordner bereitgestellt wurde, empfehlen wir, diesen Schritt zu überspringen und Ihr API Gateway-Projekt an die vorhandene API-Hub-Instanz anzuhängen.

2. IAM-Rollen (Identity and Access Management) gewähren, die zum Verbinden von API Gateway mit dem API-Hub erforderlich sind.

3. API-Hub in Ihrem Hostprojekt bereitstellen

API in API Gateway bereitstellen

Führen Sie die API Gateway-Kurzanleitung aus, um einen „Hello World“-Cloud Run-Dienst bereitzustellen und ein Gateway zu erstellen, das auf diesen Dienst verweist.

Die helloworld-API wird beispielsweise im helloworld-gateway-API-Gateway bereitgestellt, wie auf der Seite „Gateways“ in Google Cloud console zu sehen ist.

API Gateway-Projekt an den API-Hub anhängen

So hängen Sie Ihr API Gateway-Projekt an den API-Hub an:

1. Rufen Sie in der Google Cloud Console die Seite API-Hub auf.

   Zum API-Hub

2. Wählen Sie in der Drop-down-Liste Ihr API-Hub-Hostprojekt aus.
3. Klicken Sie im linken Navigationsmenü auf  Einstellungen, um die Seite Einstellungen zu öffnen.
4. Rufen Sie den Tab Projektverknüpfungen auf.
5. Klicken Sie auf Laufzeitprojekt anhängen.
   Der Bereich Ressource auswählen wird angezeigt.
6. Klicken Sie auf das Google Cloud -Projekt, in dem API Gateway bereitgestellt wird.
7. Wählen Sie im Bereich Einstellungen für die Projektzuordnung die Option API Gateway und alle anderen API-Assets aus, die Sie automatisch importieren möchten.
8. Klicken Sie auf Speichern.

Ihr Laufzeitprojekt wird angehängt und in der Liste der angehängten Laufzeitprojekte in der Google Cloud Console angezeigt.

Beispiel:

Zum Aktivieren der Echtzeit-Datenerfassung erstellt der API-Hub eine API Gateway-Plug‑in-Instanz für das angehängte Laufzeitprojekt, wenn Sie API Gateway-Assets importieren. Sie können diese Plugin-Instanz auf der Seite Projektzuordnungen in der Spalte Zugeordnete Plugins aufrufen.

API Gateway API im API-Hub ansehen

So rufen Sie Ihre API Gateway-API im API-Hub auf:

1. Rufen Sie in der Google Cloud Console im API-Hub die Seite APIs auf.

   Zum API-Hub

2. Suchen Sie die „Hallo Welt“-API, die Sie in API Gateway bereitgestellt haben.

   Wählen Sie bei Bedarf im Drop-down-Menü Filter die Option Gateway: API Gateway aus, um nur die API Gateway-APIs aufzurufen.

   Beispiel:

   

3. Klicken Sie auf die API, um weitere Details aufzurufen, einschließlich der API-Metadaten.

Bereinigen

So vermeiden Sie, dass Ihrem Google Cloud Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

• Gateway löschen
• API löschen

Alternativ können Sie auch die Google Cloud Projekte löschen, die für diese Anleitung verwendet werden.

Nächste Schritte

• Weitere Informationen zu API Gateway
• Weitere Informationen zum Zentralisieren von APIs mit API Hub