Crea colas de Cloud Tasks

En esta página, se describe cómo crear colas de Cloud Tasks. Cuando se agregan tareas a una cola, esta las envía y se asegura de que un servicio, también conocido como trabajador , las procese de manera confiable.

Ten en cuenta lo siguiente:

Los nombres de las colas constan de tres partes: un ID del proyecto, una ubicación y un ID de la cola. Debes tener un Google Cloud proyecto que proporcione el ID del proyecto.
Si usas tareas de destino de App Engine, también debes tener una aplicación de App Engine que se encuentre en una región específica y en la que se ejecuten tu cola y tus controladores. Ten en cuenta la región cuando agregues la app.

Nota: Dos ubicaciones, llamadas europe-west y us-central en los comandos de App Engine, se llaman, respectivamente, europe-west1 y us-central1 en los comandos de Cloud Tasks.
El uso de tareas de destino de HTTP no requiere una app de App Engine. Seleccionas una Google Cloud ubicación cuando creas tu cola.

Crea una cola

Puedes crear una cola de las siguientes maneras:

En la Google Cloud consola
Con Google Cloud CLI en la terminal o en Cloud Shell
Si envías una solicitud directa a la API de Cloud Tasks

Console

En la Google Cloud consola de, ve a la página Cloud Tasks > Queues.

Ir a Queues
Haz clic en Create queue.
Ingresa un Queue name, por ejemplo, my-queue.
En la lista Region, selecciona una ubicación compatible en la que se ejecutará la cola, por ejemplo, asia-south1.

Si tu organización restringe la ubicación de los recursos y deseas crear tu cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en us-central1 y us-central2 (incluso si solo necesitas una cola en una de esas regiones).
De manera opcional, puedes configurar aún más tu cola .
Haz clic en Crear.

gcloud

Usa el gcloud tasks queues create comando para crear tu cola:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Reemplaza lo siguiente:

QUEUE_ID: el identificador que le asignas a tu cola, por ejemplo, my-queue.
LOCATION: una región compatible en la que se ejecutará la cola, por ejemplo, asia-south1.

Si tu organización restringe la ubicación de los recursos y deseas crear tu cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en us-central1 y us-central2 (incluso si solo necesitas una cola en una de esas regiones).

Otras marcas para el comando de gcloud CLI te permiten configurar límites de frecuencia, opciones de reintento, tipos de colas y mucho más.

API de REST

Para crear una cola, usa el projects.locations.queues.create método.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del Google Cloud proyecto de.
LOCATION: una región compatible en la que se ejecutará la cola, por ejemplo, asia-south1.
Si tu organización restringe la ubicación de los recursos y deseas crear tu cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en us-central1 y us-central2 (incluso si solo necesitas una cola en una de esas regiones).
QUEUE_ID: el identificador que le asignas a tu cola, por ejemplo, my-queue.

Otras propiedades configurables para el Queue recurso incluyen límites de frecuencia, opciones de reintento, tipos de colas y mucho más.

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

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

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

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"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

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

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$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

Explorador de APIs (navegador)

Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, completa cualquier otro campo obligatorio y haz clic en Ejecutar.

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada 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"
}

Pueden pasar varios minutos antes de que una cola recién creada esté disponible.

Describe tu cola

Puedes confirmar que tu cola se creó correctamente de las siguientes maneras:

En la Google Cloud consola
Con gcloud CLI en la terminal o en Cloud Shell
Si envías una solicitud directa a la API de Cloud Tasks

Console

En la Google Cloud consola de, ve a la página Cloud Tasks > Queues.

Ir a Queues

Una marca de verificación verde debería indicar que tu cola se está ejecutando.
Para obtener más detalles, haz clic en el nombre de la cola y, luego, en la pestaña Configuration.

gcloud

Usa el gcloud tasks queues describe comando para verificar que tu cola se haya creado correctamente:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Reemplaza lo siguiente:

QUEUE_ID: el ID de la cola (su nombre corto)
LOCATION: la ubicación de la cola

El resultado debería ser similar al siguiente ejemplo:

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 de REST

Para recuperar una cola, usa el projects.locations.queues.get método.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del Google Cloud proyecto de.
LOCATION: la región en la que se implementa la cola, por ejemplo, us-central1.
QUEUE_ID: el ID corto de la cola, por ejemplo, my-queue.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

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

PowerShell (Windows)

Ejecuta el siguiente comando:

$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

Explorador de APIs (navegador)

Abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia 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"
}

Soluciona problemas relacionados con la creación de una cola

Si no ves el resultado esperado, puedes probar alguna de estas opciones:

Espera al menos un minuto mientras se inicializa la cola.
Asegúrate de que no haya una cola preexistente con el mismo ID. Puedes ver las colas de tu proyecto con el gcloud tasks queues list comando:
```
gcloud tasks queues list \
    --location=LOCATION
```
Para buscar varias ubicaciones, debes realizar varias solicitudes.
Verifica si alcanzaste tu cuota de colas quota:
1. En la Google Cloud consola, ve a la página API/Service Details de la API de Cloud Tasks.
  
  Ir a API/Service Details
2. Haz clic en la pestaña Quotas &System limits.
3. Para aumentar una cuota, en la fila de la cuota, haz clic en el ícono de elipsis > Edit quota.
  
  Para obtener más información, consulta Solicita un ajuste de cuota.
Vuelve a ejecutar los comandos para crear tu cola y asegúrate de que cada paso se complete correctamente.

Crea colas de Cloud Tasks Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Crea una cola

Console

gcloud

API de REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Describe tu cola

Console

gcloud

API de REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Explorador de APIs (navegador)

Soluciona problemas relacionados con la creación de una cola

¿Qué sigue?

Crea colas de Cloud Tasks