API Gateway-APIs im API-Hub ansehen

Auf dieser Seite wird beschrieben, wie Sie Ihre API Gateway-APIs im API-Hub über die Google Cloud Console oder API aufrufen. Weitere Informationen finden Sie unter API-Ressourcen auflisten.

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

Google Cloud Console

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

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

    Zum API-Hub

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

    Die Hauptseite des API-Katalogs wird geöffnet und zeigt alle verfügbaren APIs.

  3. Klicken Sie auf eine API, um weitere Details aufzurufen.

In der folgenden Tabelle werden die API-Hub-Felder beschrieben und den API Gateway-Entsprechungen zugeordnet. Informationen zu den anderen System- und benutzerdefinierten Attributen finden Sie auch in der API-Hub-Dokumentation unter Attribute verwalten.

API Hub-Feld API Gateway-Feld Beschreibung
„Übersicht“ > „Name“ „Details“ > „Name“ Name der API.
„Übersicht“ > „API-ID“ ID der API im API-Hub.
„Übersicht“ > „Zuletzt geändert“ Details> Aktualisiert Zeitstempel für die letzte Änderung der API.
„Versionen“ > „Name“ „Konfigurationen“ > „Konfigurations-ID“ ID der API-Konfiguration.
„Versionen“ > „Versions-ID“ ID der API-Konfigurationsversion im API-Hub.
„Versionen“ > „Zuletzt geändert“ „Konfigurationen“ > „Aktualisiert“ Zeitstempel für die letzte Änderung der API-Konfiguration.
„Versionen“ > „Vorgänge“ paths in der Datei mit OpenAPI-Spezifikation In der Spezifikationsdatei definierte Vorgänge. Die aufgenommenen API Gateway-Details umfassen:
  • Pfad
  • Spezifikationsdatei
  • Methode
  • Verworfene Flag
  • Zeitstempel der letzten Änderung
„Versionen“ > „Spezifikationsdatei“ „Configs“ > „Full resource location“ (Konfigurationen > Vollständiger Ressourcenstandort) Spezifikationsdatei, die der API-Konfiguration zugeordnet ist. Die aufgenommenen API Gateway-Details umfassen:
  • Name
  • Spezifikationstyp
  • Lint-Ergebnisse
  • Zeitstempel der letzten Änderung
Hinweis:Derzeit werden nur OpenAPI-Spezifikationsdateien in den API-Hub aufgenommen.
„Bereitstellungen“ > „Bereitstellungsname“ „Gateways“ > „Gateway-ID“ API Gateway-Bereitstellung im folgenden Format:
LOCATION/GATEWAY_ID
„Bereitstellungen“ > „Art der Bereitstellung“ Art der Bereitstellung. Auf API Gateway festlegen.
„Bereitstellungen“ > „Zuletzt geändert“ „Gateways“ > „Aktualisiert“ Zeitstempel für die letzte Änderung des API-Gateways.
„Bereitstellungen“ > „Ressourcen-URI“ „Gateways“ > „Vollständiger Ressourcenname“ Ressourcen-URI für das API-Gateway im folgenden Format:
projects/RUNTIME_PROJECT_ID/locations/LOCATION/gateways/GATEWAY_ID
„Bereitstellungen“ > „Verwaltungs-URL“ Gateways> Gateway URL zum Verwalten der API Gateway-Bereitstellung im folgenden Format:
https://console.cloud.google.com/api-gateway/gateway/GATEWAY_ID/location/LOCATION?project=RUNTIME_PROJECT_ID
„Bereitstellungen“ > „Quellprojekt“ „Gateways“ > „Vollständiger Ressourcenname“ Quellprojekt für die Bereitstellung.
„Bereitstellungen“ > „Endpunkte“ „Gateways“ > „Gateway-URL“ IP-Adresse, an der die Bereitstellungsressource auf API-Anfragen wartet.
Statistiken Hinweis:Derzeit sind keine Informationen zu API Gateway-APIs verfügbar.
Sicherheit Hinweis:Sicherheitsinformationen sind derzeit nicht für API Gateway APIs verfügbar.

REST

Verwenden Sie die API List APIs, um alle API Gateway APIs im API-Hub aufzulisten. Wenn Sie den Filter für die Plug-in-Instanz hinzufügen, können Sie nur die API-Assets für die angegebene API Gateway-Plug-in-Instanz auflisten.

Beispiel:

curl 'https://apihub.googleapis.com/v1/projects/HUB_PROJECT_ID/locations/HUB_LOCATION/apis?filter=source_metadata.plugin_instance_action_source.plugin_instance="projects/HUB_PROJECT_ID/locations/HUB_LOCATION/plugins/PLUGIN_TYPE/instances/PLUGIN_INSTANCE_ID"' \
  -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

Ersetzen Sie Folgendes:

  • HUB_PROJECT_ID ist der Name des API-Hub-Hostprojekts. Das Hostprojekt wurde bei der Bereitstellung des API-Hubs ausgewählt.
  • HUB_LOCATION: der Standort des Hostprojekts. Der Standort wurde bei der Bereitstellung des API-Hubs ausgewählt.
  • PLUGIN_TYPE: Art des Plug-ins. Auf system-api-gateway festgelegt.
  • PLUGIN_INSTANCE_ID: ID der API Gateway-Plug-in-Instanz. Verwenden Sie die API list plugin instances, um die ID der Plugin-Instanz abzurufen.

Im Folgenden finden Sie ein Beispiel für die Antwort.

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78",
      "displayName": "test-api-1",
      "versions": [
        "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78/versions/843a7e72-c5d2-4af8-95b0-162fa5d5ea10",
        "projects/myproject/locations/us-west1/apis/4fc95784-16b0-4b6e-8b7f-a08607febf78/versions/b6af2674-4a0e-410e-990d-d90ccbe6867e"
      ],
      "createTime": "2025-12-12T18:55:54.445487Z",
      "updateTime": "2025-12-12T18:55:54.445487Z",
      "apiStyle": {
        "attribute": "projects/myproject/locations/us-west1/attributes/system-api-style",
        "enumValues": {
          "values": [
            {
              "id": "rest",
              "displayName": "REST",
              "description": "REST",
              "immutable": true
            }
          ]
        }
      },
      "fingerprint": "test-api-1",
      "sourceMetadata": [
        {
          "pluginInstanceActionSource": {
            "pluginInstance": "projects/myproject/locations/us-west1/plugins/system-api-gateway/instances/90b21a65-38b4-4159-8e9d-07a8b6cecab0",
            "actionId": "sync-metadata"
          },
          "sourceType": "PLUGIN",
          "originalResourceId": "projects/runtimeproject/locations/global/apis/test-api-1",
          "originalResourceCreateTime": "2025-12-11T01:57:54.841944920Z",
          "originalResourceUpdateTime": "0001-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

In der folgenden Tabelle werden die Felder beschrieben, die in der Antwort mit API-Metadaten aus API Gateway gefüllt werden. Informationen zu den anderen System- und benutzerdefinierten Attributen finden Sie auch in der API-Hub-Dokumentation unter Attribute verwalten.

API-Feld Beschreibung
name ID der API im API-Hub im folgenden Format: projects/HUB_PROJECT_ID/locations/HUB_LOCATION/apis/API_ID

Hinweis:API_ID wird im Ressourcennamen verwendet, um sicherzustellen, dass der Wert eindeutig ist.

displayName Anzeigename der API.
createTime Zeitstempel für die Erstellung der API.
updateTime Zeitstempel für die Erstellung der API.
fingerprint Eindeutige ID für die API (wird in der Regel auf den Anzeigenamen festgelegt).
sourceMetadata Informationen zur API Gateway-Plug-in-Instanz, einschließlich:
  • ID der Plug‑in-Instanz im folgenden Format: projects/HUB_PROJECT_ID/locations/HUB_LOCATION/plugins/system-api-gateway/instances/PLUGIN_INSTANCE_ID
  • Der ursprüngliche API Gateway-Ressourcenname im folgenden Format: projects/RUNTIME_PROJECT_ID/locations/LOCATION/apis/API_ID