Send feedback
Method: projects.locations.workerPools.list
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
Choose a location:
global africa-south1 asia-east1 asia-east2 asia-northeast1 asia-northeast2 asia-northeast3 asia-south1 asia-south2 asia-southeast1 asia-southeast2 asia-southeast3 australia-southeast1 australia-southeast2 europe-central2 europe-north1 europe-north2 europe-southwest1 europe-west1 europe-west10 europe-west12 europe-west2 europe-west3 europe-west4 europe-west6 europe-west8 europe-west9 europe-west15 me-central1 me-central2 me-west1 northamerica-northeast1 northamerica-northeast2 northamerica-south1 southamerica-east1 southamerica-west1 us-central1 us-central2 us-east1 us-east4 us-east5 us-east7 us-south1 us-west1 us-west2 us-west3 us-west4 us-west8
GET https://cloudbuild.googleapis.com/v1/{parent=projects/*/locations/*}/workerPools
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters
parent
string
Required. The parent of the collection of WorkerPools. Format: projects/{project}/locations/{location}.
Authorization requires the following IAM permission on the specified resource parent:
cloudbuild.workerpools.list
Query parameters
Parameters
pageSize
integer
The maximum number of WorkerPools to return. The service may return fewer than this value. If omitted, the server will use a sensible default.
pageToken
string
A page token, received from a previous workerPools.list call. Provide this to retrieve the subsequent page.
Request body
The request body must be empty.
Response body
Response containing existing WorkerPools.
If successful, the response body contains data with the following structure:
JSON representation
{
"workerPools" : [
{
object (WorkerPool )
}
] ,
"nextPageToken" : string
}
Fields
workerPools[]
object (WorkerPool )
WorkerPools for the specified project.
nextPageToken
string
Continuation token used to page through large result sets. Provide this value in a subsequent ListWorkerPoolsRequest to return the next page of results.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
Send feedback
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 2026-06-09 UTC.
Need to tell us more?
[[["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 2026-06-09 UTC."],[],[]]