Shadow API Discovery: Verwaltungs-APIs

Überblick

Diese Seite enthält die Referenzsyntax zum Verwalten von Apigee Shadow API Discovery über die Apigee Management APIs (APIM). Die Dokumentation für die Management APIs im Zusammenhang mit der Shadow API Discovery, einschließlich Informationen zu den einzelnen Feldern in einer Anfrage, finden Sie unter https://cloud.google.com/apigee/docs/reference/apis/apim/rest und https://cloud.google.com/apigee/docs/reference/apis/apim/rpc

Eine Übersicht über die Shadow API-Erkennung und eine Anleitung zu ihrer Verwaltung über die Apigee-UI in der Cloud Console finden Sie unter Shadow API-Erkennung. Informationen zu den allgemeinen Verhaltensweisen und Einschränkungen der Shadow API-Erkennung finden Sie unter Verhaltensweisen und Einschränkungen.

Parameter in Referenz-API-Aufrufen

Die API-Aufrufe auf dieser Seite können die folgenden Parameter verwenden, die sich entweder auf Ihre Apigee-Kontoinformationen (z. B. Ihr Projekt) oder auf Informationen beziehen, die beim Erstellen von Beobachtungsjobs verwendet werden. Weitere Informationen zu jedem dieser Felder finden Sie unter Beobachtungsjobs erstellen.

  • OBSERVATION_JOB_LOCATION ist ein Standort für einen Beobachtungsjob.
  • OBSERVATION_JOB_NAME ist der Name eines Beobachtungsjobs.
  • OBSERVATION_SOURCE_LOCATION ist ein Quellspeicherort für den Beobachtungsjob.
  • OBSERVATION_SOURCE_NAME ist der Name einer Beobachtungsquelle.
  • PROJECT ist Ihr Apigee-Projekt.

Beobachtungsjob erstellen

Das Erstellen eines Beobachtungsjobs erfordert mehrere Schritte/API-Anfragen.

  1. Beobachtungsquelle erstellen: Wenn Sie eine neue Beobachtungsquelle erstellen möchten, anstatt eine vorhandene zu verwenden, senden Sie eine POST-Anfrage an den Endpunkt der Beobachtungsquelle mit den Details zur Beobachtungsquelle.
    curl \ https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources?observation_source_id=OBSERVATION_SOURCE_NAME \
-X POST \
-H 'Content-type: application/json' \
-d @- <<'EOF'
{
  "gclbObservationSource": {
    "pscNetworkConfigs": [
      {
        "network": "projects/PROJECT/global/networks/{network_name}",
        "subnetwork":"projects/PROJECT/regions/OBSERVATION_SOURCE_LOCATION/subnetworks/{subnet_name}"
      }
    ]
  }
}
    Das Erstellen einer Beobachtungsquelle dauert einige Minuten und startet eineLRO mit einer Antwort wie dieser: 
    {
"name": "projects/{project/locations/OBSERVATION_SOURCE_LOCATION/operations/operation-",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.apim.vl.ApiDiscoveryOperationMetadata",
  "createTime": "",
  "target": "projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME",
  "verb": "create",
  "requestedCancellation": false,
  "apiVersion": "vl"
},
"done": false
}
  2. So rufen Sie die neu erstellte Beobachtungsquelle auf: 
    curl \
https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME
  3. Beobachtungsjob erstellen: Erstellen Sie einen Job, der mithilfe der soeben erstellten Quelle nach Schatten-APIs sucht: 
    curl \
https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs?observation_job_id=OBSERVATION_JOB_NAME \
-X POST \
-H 'Content-type: application/json' \
-d @- <<'EOF'
{
  "sources": [
    "projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME"
  ]
}

Beobachtungsjob aktivieren

Verwenden Sie den folgenden Befehl, um einen neuen Beobachtungsjob oder einen deaktivierten vorhandenen Job zu aktivieren.

curl https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME:enable \
-X POST \
-H 'Content-type: application/json' \
-d @- <<'EOF'
{
}

Erkannte APIs aufrufen

Senden Sie den folgenden Befehl, um APIs aufzurufen, die durch aktivierte Beobachtungsjobs gefunden wurden:

curl https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME/apiObservations \
-X GET

Beobachtungsjob deaktivieren

Mit dieser Anfrage wird ein Beobachtungsjob deaktiviert, ohne ihn zu löschen.

curl https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationsJobs/OBSERVATION_JOB_NAME:disable \
-X POST \
-H 'Content-type: application/json' \
-d @- <<'EOF'
{
}

Beobachtungsjob löschen

Mit dieser Anfrage wird ein Beobachtungsjob gelöscht.

curl -X DELETE https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME

Beobachtungsquelle löschen

Mit dieser Anfrage wird eine Beobachtungsquelle gelöscht.

curl -X DELETE https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME