Panoramica
Questa pagina fornisce la sintassi di riferimento per la gestione di Apigee Shadow API Discovery dalle API Apigee Management (APIM). La documentazione delle API di gestione correlate a Shadow API Discovery, inclusi i dettagli su ogni campo di una richiesta, è disponibile all'indirizzo https://cloud.google.com/apigee/docs/reference/apis/apim/rest e https://cloud.google.com/apigee/docs/reference/apis/apim/rpc
Per una panoramica di Shadow API Discovery e istruzioni per la gestione tramite la UI di Apigee nella console Google Cloud, vedi Shadow API Discovery. Le informazioni sui comportamenti e sulle limitazioni generali di Shadow API Discovery sono disponibili in Comportamenti e limitazioni.
Parametri nelle chiamate API di riferimento
Le chiamate API in questa pagina possono utilizzare i seguenti parametri, che si riferiscono alle informazioni del tuo account Apigee (ad esempio il tuo progetto) o alle informazioni utilizzate durante la creazione di job di osservazione. Per ulteriori informazioni su ciascuno di questi campi, consulta la sezione Creare job di osservazione.
- OBSERVATION_JOB_LOCATION è una posizione per un job di osservazione.
- OBSERVATION_JOB_NAME è il nome di un job di osservazione.
- OBSERVATION_SOURCE_LOCATION è una posizione di origine per il job di osservazione.
- OBSERVATION_SOURCE_NAME è il nome di un'origine di osservazione.
- PROJECT è il tuo progetto Apigee.
Crea un job di osservazione
La creazione di un job di osservazione richiede più passaggi/richieste API.
- Crea un'origine di osservazione:per creare una nuova origine di osservazione anziché utilizzarne una esistente, invia una richiesta POST all'endpoint observationSources con i dettagli dell'origine di osservazione.
La creazione di un'origine di osservazione richiede diversi minuti e avvia un'operazione a lunga esecuzione, con una risposta simile a questa: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}" } ] } } EOF
{ "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 } - Per visualizzare l'origine di osservazione appena creata:
curl \ https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME
- Crea un job di osservazione:crea un job che cerchi le API shadow utilizzando l'origine
che hai appena creato:
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" ] } EOF
Abilitare un job di osservazione
Utilizza il seguente comando per attivare un nuovo job di osservazione o un job esistente disattivato.
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' {} EOF
Visualizzare le API rilevate
Per visualizzare le API rilevate dai job di osservazione abilitati, invia questo comando:
curl https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME/apiObservations \ -X GET
Gestire i tag nei risultati dell'osservazione
Per elencare i tag già aggiunti ai risultati:
curl -H "https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION:listApiObservationTags"
Per gestire i tag:
curl -H "Content-Type: appication/json" \ "https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME/apiObservations:batchEditTags" \ -X POST -d @- <<'EOF' { "requests": [ { "apiObservationId": "API_OBSERVATION_ID", "tagActions": [ { "tag": "demo", "action": "REMOVE" }, { "tag": "Needs Attentions", "action": "ADD" }] } ] } EOF
Disattivare un job di osservazione
Questa richiesta disattiva un job di osservazione senza eliminarlo.
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' { }
Eliminare un job di osservazione
Questa richiesta elimina un job di osservazione.
curl -X DELETE https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_JOB_LOCATION/observationJobs/OBSERVATION_JOB_NAME
Eliminare un'origine dell'osservazione
Questa richiesta elimina una fonte di osservazione.
curl -X DELETE https://apim.googleapis.com/v1alpha/projects/PROJECT/locations/OBSERVATION_SOURCE_LOCATION/observationSources/OBSERVATION_SOURCE_NAME