Opérations de longue durée

L'API Submission est asynchrone et renvoie une opération de longue durée. L'opération risque de ne pas être terminée lorsque la méthode renvoie une réponse.

Obtenir l'état d'une opération

Pour interroger l'état d'une opération, procédez comme suit :

Appelez la méthode GET pour le type "Opérations".

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• project-number : numéro de votre projet Google Cloud.
• operation-id : ID d'opération

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

PowerShell

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Une fois l'opération terminée, l'une des valeurs suivantes est renvoyée pour state:

• SUCCEEDED: indique que l'URL envoyée a été ajoutée à la liste de blocage du navigateur sécurisé.

• CLOSED: indique que l'URL envoyée n'a pas été détectée comme ne respectant pas les règles de navigation sécurisée et qu'elle n'a pas été ajoutée à la liste de blocage de la navigation sécurisée au cours des dernières 24 heures.