Stay organized with collections
Save and categorize content based on your preferences.
This page describes viewing information about a worker pool, and deleting
worker pools.
Required roles
To get the permissions that
you need to manage Cloud Run worker pools and worker pool revisions,
ask your administrator to grant you the
Cloud Run Developer (roles/run.developer)
IAM role on your Cloud Run worker pool.
Replace WORKER_POOL with the name of your worker pool.
Delete existing worker pools
The following considerations apply to deleting a worker pool:
Deleting a worker pool deletes all resources related to this worker pool, including all
revisions of this worker pool whether they are processing workloads or not.
Deleting a worker pool does not automatically remove container images from Artifact Registry.
To delete container images used by the deleted revisions from Artifact Registry,
refer to Deleting images.
After you delete a worker pool, the worker pool remains visible in the Google Cloud CLI
until the deletion is fully complete. However, you cannot update the worker pool.
Deleting a worker pool is permanent. There is no undo or restore.
[[["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-29 UTC."],[],[],null,["# Manage worker pools\n\n| **Preview\n| --- Cloud Run worker pools**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis page describes viewing information about a worker pool, and deleting\nworker pools.\n\n### Required roles\n\n\nTo get the permissions that\nyou need to manage Cloud Run worker pools and worker pool revisions,\n\nask your administrator to grant you the\n\n\n[Cloud Run Developer](/iam/docs/roles-permissions/run#run.developer) (`roles/run.developer`)\nIAM role on your Cloud Run worker pool.\n\n\nFor a list of IAM roles and permissions that are associated with\nCloud Run, see\n[Cloud Run IAM roles](/run/docs/reference/iam/roles)\nand [Cloud Run IAM permissions](/run/docs/reference/iam/permissions).\nIf your Cloud Run worker pool interfaces with\nGoogle Cloud APIs, such as Cloud Client Libraries, see the\n[service identity configuration guide](/run/docs/configuring/workerpools/service-identity).\nFor more information about granting roles, see\n[deployment permissions](/run/docs/reference/iam/roles#additional-configuration)\nand [manage access](/iam/docs/granting-changing-revoking-access).\n\nCreate a worker pool\n--------------------\n\nCloud Run creates a new worker pool the first time you deploy a container image. See [Deploy a new worker pool](/run/docs/deploy-worker-pools#worker-pool)\nfor more instructions.\n\nView the list of worker pools in your project\n---------------------------------------------\n\nUse the Google Cloud console or the Google Cloud CLI to view a list of the\navailable worker pools in your project: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu. The available worker pools are listed\n in the page.\n\n### gcloud\n\nTo list the worker pools in your project: \n\n gcloud beta run worker-pools list\n\nYou can filter this list by properties of the worker pool definition, such as an\n[assigned label](/run/docs/configuring/workerpools/labels#label-listing).\n\nView more details about a worker pool\n-------------------------------------\n\nUse the Google Cloud CLI to see more details about a worker pool: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu to display the available worker pools.\n\n3. Click the worker pool to display its details pane.\n\n### gcloud\n\nTo view details about a worker pool: \n\n```bash\ngcloud beta run worker-pools describe WORKER_POOL\n```\nReplace \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of the worker pool.\n\n\u003cbr /\u003e\n\nYou can use the [`--format` flag](/sdk/gcloud/reference#--format) to format\nthe output. For example, to format the output as YAML: \n\n```bash\ngcloud beta run worker-pools describe WORKER_POOL\n --region REGION\n --format yaml\n```\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of the worker pool.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the Google Cloud region of the worker pool.\n\nDisable an existing worker pool\n-------------------------------\n\nDisabling a worker pool shuts down all instances for that worker pool. To\ndisable a worker pool, set scaling to zero: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu, then from the list of worker pools,\n click on the worker pool you want to disable.\n\n3. Click the pen icon at the right of **Scaling: Manual (Instances: )** and\n change the value to 0.\n\n4. Click **Save** to update and disable the worker pool.\n\n### gcloud\n\n```bash\ngcloud beta run worker-pools update WORKER_POOL --scaling=0\n```\n\nReplace \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of your worker pool.\n\nDelete existing worker pools\n----------------------------\n\nThe following considerations apply to deleting a worker pool:\n\n- Deleting a worker pool deletes all resources related to this worker pool, including all revisions of this worker pool whether they are processing workloads or not.\n- Deleting a worker pool does not automatically remove container images from Artifact Registry. To delete container images used by the deleted revisions from Artifact Registry, refer to [Deleting images](/artifact-registry/docs/docker/manage-images#deleting_images).\n- After you delete a worker pool, the worker pool remains visible in the Google Cloud CLI until the deletion is fully complete. However, you cannot update the worker pool.\n- Deleting a worker pool is permanent. There is no undo or restore.\n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu, then from the list of worker pools,\n select the worker pool you want to delete.\n\n3. Click **Delete**.\n\n### gcloud\n\nTo delete a worker pool, use the command: \n\n```\ngcloud beta run worker-pools delete WORKER_POOL --region REGION\n```\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of your worker pool.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the Google Cloud region of the worker pool."]]
