Operazioni a lunga esecuzione

L'API Submission è asincrona e restituisce un'operazione a lunga esecuzione. L'operazione potrebbe non essere completata quando il metodo restituisce una risposta.

Recupero dello stato di un'operazione

Di seguito viene mostrato come eseguire il polling dello stato di un'operazione.

Chiama il metodo GET per il tipo di operazione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • project-number: il numero del tuo progetto Google Cloud
  • operation-id: il tuo ID operazione

Metodo HTTP e URL: 

GET https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id"

PowerShell

Esegui questo comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-number/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.webrisk.v1.SubmitUriMetadata",
    "state": "RUNNING"
  }
  "done": false,
  ...
}

Informazioni sullo stato dell'operazione

Il campo metadata.state nella risposta indica lo stato attuale dell'invio. Al termine dell'operazione, il campo state in SubmitUriMetadata viene aggiornato. Gli stati possibili sono i seguenti:

  • SUCCEEDED: indica che l'URL inviato è stato aggiunto alla lista bloccata di Navigazione sicura.
  • CLOSED: indica che l'URL inviato non è stato aggiunto alla lista bloccata di Navigazione sicura perché non è stato rilevato che viola le norme di Navigazione sicura.
  • RUNNING: indica che l'invio è ancora in fase di elaborazione.

Informazioni sui motivi di CHIUSURA

Quando lo stato dell'operazione è CLOSED, SubmitUriMetadata potrebbe includere un campo closed_reason. Questo campo fornisce un contesto aggiuntivo sul motivo per cui l'invio è stato chiuso senza che l'URL sia stato aggiunto a una blocklist.

I valori possibili per closed_reason sono:

  • CLOSED_REASON_UNSPECIFIED: il motivo non è specificato.
  • NO_THREAT_DETECTED:
    • Descrizione: l'URL inviato è stato analizzato correttamente e non è stato rilevato che contenga contenuti dannosi. Ciò indica che, in base alla nostra analisi, l'URL non soddisfa i criteri per l'inserimento nella blocklist.
    • Azione utente consigliata: in genere non sono necessarie ulteriori azioni per questo URL, in quanto non è stato rilevato come minaccia. Non inviare nuovamente la richiesta ripetutamente, a meno che i contenuti non cambino e non emergano nuove prove di attività dannose.
  • HOST_UNRESOLVABLE:
    • Descrizione: non è stato possibile completare l'analisi perché il nome host dell'URL non è stato risolto dal DNS. Spesso questo significa che il sito web non è disponibile, il dominio non esiste più o si è verificato un problema DNS temporaneo. Non possiamo aggiungere URL inattivi o segnaposto alla blocklist.
    • Azione consigliata per l'utente:
      • Verifica l'URL: assicurati che il nome host sia corretto e che il sito web sia attivo e accessibile pubblicamente.
      • Invia di nuovo: puoi inviare di nuovo l'URL in un secondo momento se confermi che il sito è attivo.
  • CONTENT_UNREACHABLE:
    • Descrizione: l'analisi non è stata completata perché non è stato possibile accedere ai contenuti del sito web. Questo può accadere per diversi motivi, ad esempio:
      • La pagina web non esiste più (errore "404 Not Found").
      • Il server del sito web ha riscontrato un errore (si tratta di un "errore del server 5xx").
      • Il sito web potrebbe mostrare contenuti diversi al nostro sistema di analisi rispetto a quelli che mostrerebbe a un visitatore normale (si tratta di cloaking), impedendo una valutazione completa.
    • Azione consigliata per l'utente:
      • Controlla l'accessibilità: verifica che i contenuti dannosi siano raggiungibili. Tieni presente che alcuni siti potrebbero mostrare contenuti dannosi solo in condizioni specifiche (ovvero in determinate località geografiche, su dispositivi o browser).
      • Fornisci maggiori informazioni: se l'URL è accessibile a determinate condizioni, invialo di nuovo. Utilizza i campi ThreatDiscovery in SubmitUriRequest per fornire ulteriori dettagli, ad esempio la regione e la piattaforma in cui è stata osservata la minaccia. Queste informazioni possono aumentare la probabilità di un'analisi riuscita.