Crie filas do Cloud Tasks

Consola

1. Na Google Cloud consola, aceda à página Cloud Tasks > Filas.

   Aceder a Filas

2. Clique em add_box Criar fila.

3. Introduza um Nome da fila, por exemplo, my-queue.

4. Na lista Região, selecione uma localização suportada onde a fila vai ser executada, por exemplo, asia-south1.

   Se a sua organização restringir a localização dos recursos e quiser criar a sua fila em us-central1 ou us-central2, a política da organização tem de permitir a criação de filas em us-central1 e us-central2 (mesmo que só precise de uma fila numa dessas regiões).

5. Opcionalmente, pode configurar ainda mais a sua fila.

6. Clique em Criar.

gcloud

Use o comando gcloud tasks queues create para criar a sua fila:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Substitua o seguinte:

• QUEUE_ID: o identificador que atribui à sua fila, por exemplo, my-queue.

• LOCATION: uma região suportada onde a fila vai ser executada, por exemplo, asia-south1.

  Se a sua organização restringir a localização dos recursos e quiser criar a fila em us-central1 ou us-central2, a política da organização tem de permitir a criação de filas em us-central1 e us-central2 (mesmo que só precise de uma fila numa dessas regiões).

Outras flags para o comando da CLI gcloud permitem-lhe configurar limites de taxa, opções de repetição, tipos de filas e muito mais.

API REST

Para criar uma fila, use o método projects.locations.queues.create.

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

• PROJECT_ID: o ID do seu Google Cloud projeto.
• LOCATION: uma região suportada onde a fila vai ser executada, por exemplo, asia-south1.

  Se a sua organização restringir a localização dos recursos e quiser criar a sua fila em us-central1 ou us-central2, a política da organização tem de permitir a criação de filas em us-central1 e us-central2 (mesmo que só precise de uma fila numa dessas regiões).

• QUEUE_ID: o identificador que atribui à sua fila, por exemplo, my-queue.

Corpo JSON do pedido:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

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

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Queue:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}

Consola

1. Na Google Cloud consola, aceda à página Cloud Tasks > Filas.

   Aceder a Filas

   Uma marca de verificação verde check_circle deve indicar que a fila está em execução.

2. Para ver mais detalhes, clique no nome da fila e, de seguida, clique no separador Configuração.

gcloud

Use o comando gcloud tasks queues describe para verificar se a fila foi criada com êxito:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Substitua o seguinte:

• QUEUE_ID: o ID da fila (o nome abreviado)
• LOCATION: a localização da fila

O resultado deve ser semelhante ao seguinte:

name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID
rateLimits:
  maxBurstSize: 100
  maxConcurrentDispatches: 1000
  maxDispatchesPerSecond: 500.0
retryConfig:
  maxAttempts: 100
  maxBackoff: 3600s
  maxDoublings: 16
  minBackoff: 0.100s
state: RUNNING

API REST

Para obter uma fila, use o método projects.locations.queues.get.

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

• PROJECT_ID: o ID do seu Google Cloud projeto.
• LOCATION: a região na qual a fila está implementada. Por exemplo, us-central1.
• QUEUE_ID: o ID curto da fila, por exemplo, my-queue.

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

Se for bem-sucedido, o corpo da resposta contém uma instância de Queue:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}