API erstellen
Vorbereitung
Bevor Sie eine API in API Gateway erstellen können, müssen folgende Voraussetzungen erfüllt sein:
- Bereiten Sie die Entwicklungsumgebung wie unter Entwicklungsumgebung konfigurieren beschrieben vor.
Anforderungen an die API-ID
Viele der unten aufgeführten gcloud
-Befehle erfordern die Angabe der ID der API im folgenden Format: API_ID.
In API Gateway gelten folgende Anforderungen für die API-ID:
- Muss eine maximale Länge von 63 Zeichen haben.
- Darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten.
- Er darf nicht mit einem Bindestrich beginnen.
- Er darf keinen Unterstrich enthalten.
API erstellen
So erstellen Sie eine API:
Überprüfen Sie anhand der Projekt-ID, die vom folgenden Befehl zurückgegeben wurde, ob der Dienst im richtigen Projekt erstellt wird.
gcloud config list project
Wenn Sie das Standardprojekt ändern müssen, führen Sie den folgenden Befehl aus und ersetzen Sie PROJECT_ID durch die ID des Google Cloud-Projekts, in dem Sie den Dienst erstellen möchten:
gcloud config set project PROJECT_ID
Wenn Ihre Projekt-ID einen Doppelpunkt (
:
) enthält, lesen Sie die Informationen unter Unter Auf Domains beschränkte Projekte finden Sie weitere Informationen zum Erstellen eines API in Ihrem Projekt.Hier erhalten Sie Hilfe zum Befehl
apis create
:gcloud api-gateway apis create --help
Führen Sie den folgenden Befehl aus, um die API zu erstellen:
gcloud api-gateway apis create API_ID --project=PROJECT_ID
wobei
- API_ID gibt die ID der neuen API an. Richtlinien zur API-ID
- PROJECT_ID gibt die Google Cloud-Projekt-ID an.
Beim Erstellen der API gibt API Gateway Informationen an das Terminal aus.
Nach erfolgreichem Abschluss können Sie den folgenden Befehl verwenden, um Details zur neuen API aufzurufen:
gcloud api-gateway apis describe API_ID --project=PROJECT_ID
Dieser Befehl gibt Folgendes zurück:
createTime: '2020-02-29T21:52:20.297426875Z' displayName: API_ID managedService: MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog name: projects/PROJECT_ID/locations/global/apis/API_ID state: ACTIVE updateTime: '2020-02-29T21:52:20.647923711Z'
gcloud-Optionen
Die Google Cloud CLI bietet viele Optionen, einschließlich der in der gcloud-Referenz Darüber hinaus können Sie für API Gateway beim Erstellen einer API die folgenden Optionen festlegen:
--async
: Gibt die Steuerung sofort an das Terminal zurück, ohne auf den Abschluss des Vorgangs zu warten.--display-name=NAME
: Gibt den Anzeigenamen der API an, d. h. den in der Benutzeroberfläche angezeigten Namen. Verwenden Sie keine Leerzeichen im Namen. Verwenden Sie stattdessen Bindestriche und Unterstriche. Der Standardwert ist API_ID.--labels=KEY1=VALUE1,KEY2=VALUE2,...
: Gibt Labels an, die der API-Konfiguration zugeordnet sind.--managed-service
: Gibt einen bereits verwalteten Dienst für die API an, z. B. einen vorhandenen Endpoints-Dienst.
Auf Domains beschränkte Projekte
Wenn Ihr Projekt auf Ihre Domain beschränkt ist, enthält die Projekt-ID den Namen
Die Domain gefolgt von einem Doppelpunkt (:
), z. B. example.com:my-project
. Ich
muss beim Erstellen einer API auf Domainebene einen gültigen verwalteten Dienst bereitstellen
Projekt arbeiten.
Wenn Sie gcloud
verwenden, geben Sie den Namen des verwalteten Dienstes mit dem Flag --managed-service
an, wie in den gcloud-Optionen beschrieben.
APIs auflisten
So listen Sie alle APIs in einem Projekt auf:
gcloud api-gateway apis list --project=PROJECT_ID
Dieser Befehl gibt die Ausgabe in folgender Form zurück:
NAME DISPLAY_NAME MANAGED_SERVICE STATE projects/PROJECT_ID/locations/global/apis/API_ID API_ID MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog ACTIVE
Verwenden Sie die Projekt- und API-ID, um detaillierte Informationen zur API zu erhalten:
gcloud api-gateway apis describe API_ID --project=PROJECT_ID
API aktualisieren
Nach dem Erstellen können Sie die Labels und den Anzeigenamen einer vorhandenen API aktualisieren.
Verwenden Sie die folgenden gcloud
-Optionen, um eine vorhandene API zu aktualisieren:
--display-name
--update-labels
--clear-labels
--remove-labels
Beispiel:
gcloud api-gateway apis update API_ID --project=PROJECT_ID \ --update-labels=a=1,b=2
Verwenden Sie den folgenden Befehl, um alle Aktualisierungsoptionen aufzurufen:
gcloud api-gateway apis update --help
API löschen
So löschen Sie eine API:
- Löschen Sie die mit der API verknüpften API-Konfigurationen.
- Löschen Sie die API:
So löschen Sie eine API:
Ermitteln Sie die Liste der mit der API verknüpften API-Konfigurationen:
gcloud api-gateway api-configs list --api=API_ID --project=PROJECT_ID
Löschen Sie alle mit der API verknüpften API-Konfigurationen:
gcloud api-gateway api-configs delete CONFIG_ID --api=API_ID --project=PROJECT_ID
Löschen Sie die API:
gcloud api-gateway apis delete API_ID --project=PROJECT_ID