Stay organized with collections Save and categorize content based on your preferences.
This page describes how to create a pull queue. You must create the queue before you can add tasks to it. The page also describes how to pause or delete a queue.
This API is supported for first-generation runtimes and can be used when upgrading to corresponding second-generation runtimes. If you are updating to the App Engine Python 3 runtime, refer to the migration guide to learn about your migration options for legacy bundled services. Defining queues withqueue.yaml
You can define pull queues using the queue.yaml file for your application. The process is the same as creating named push queues, with a specialized directive, mode: pull, added to the file.
queue:
- name: my-queue-name
mode: pull
You use the gcloud CLI gcloud command to upload the file.
gcloud app deploy queue.yaml
serviceusage.services.list permission. This permission can be added either using the serviceusage.serviceUsageViewer role or by creating a custom role with that permission. Caution: Queue creation for the Task Queue service can also be managed using Queue Management methods available directly through the Cloud Tasks API, but mixing the queue.yamlqueue.yaml file via the gcloud CLI below version 332.0.0 uses a deprecated interface to the service. Starting on 2022-09-20, attempts to use the upload method can fail with server errors. To resolve this, make sure the Cloud Tasks API is enabled in your project and your gcloud CLI is updated to at least version 332.0.0. Disabling queues
You can disable, or pause, a queue by removing its definition from your queue configuration file and then uploading the updated file.
Once the updated file is uploaded, the queue is set to "disabled" and its rate is set to 0. Any tasks that are in the queue or new tasks that are added to the queue will not be processed. You can re-enable the disabled queue by uploading a new queue file with the queue defined.
You can also pause a queue from within the Cloud Tasks page in the Google Cloud console.
Deleting queuesTo delete a queue you must first disable it:
Remove the queue definition from your queue configuration file.
Upload the changed file.
gcloud app deploy queue.yaml
Once the queue is disabled, use the Google Cloud console to delete it.
In the Google Cloud console, select the queue.
Click Delete queue.
If you delete a queue from the Google Cloud console, you must wait 7 days before recreating with the same name.
Important: The local development server (dev_appserver) does not support pull queues. To test your pull queues and make sure you have the details of your configuration correct, you'll need to push your queue configuration file to an App Engine staging environment. What's next
Learn how to create tasks.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["This guide details the process of creating pull queues using the `queue.yaml` file, which requires adding a `mode: pull` directive and deploying the file via the `gcloud app deploy queue.yaml` command."],["Pull queues can be paused by removing their definition from the `queue.yaml` file and re-deploying, effectively setting the queue's rate to 0, but can be re-enabled by adding them back in."],["Deleting a pull queue involves first disabling it by removing its definition from `queue.yaml`, uploading the updated file, and then using the Google Cloud console to complete the deletion."],["Using a service account for queue configuration deployment requires the `serviceusage.services.list` permission, accessible through the `serviceusage.serviceUsageViewer` role or a custom role."],["Mixing the `queue.yaml` method with Queue Management methods is discouraged, and using `gcloud` CLI versions older than `332.0.0` for uploading `queue.yaml` can result in errors, requiring an update and enabled Cloud Tasks API."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4