Operações de longa duração

A API Submission é assíncrona e devolve uma operação de longa duração. A operação pode não ser concluída quando o método devolve uma resposta.

Obtenha o estado de uma operação

O exemplo seguinte mostra como verificar o estado de uma operação.

Chame o método GET para o tipo Operations.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• project-number: o número do seu projeto do Google Cloud
• operation-id: o ID da operação

Método HTTP e URL:

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Execute o seguinte comando:

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

PowerShell

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

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

Quando a operação estiver concluída, é devolvido um dos seguintes valores para state:

• SUCCEEDED: indica que o URL enviado foi adicionado à lista de bloqueios da Navegação Segura.

• CLOSED: indica que não foi detetado que o URL enviado violava as Políticas de Navegação Segura e que não foi adicionado à lista de bloqueios da Navegação Segura nas últimas 24 horas.