- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Examples
- Try it!
Lists all non-deleted WorkforcePool
s under the specified parent. If showDeleted
is set to true
, then deleted pools are also listed.
HTTP request
GET https://iam.googleapis.com/v1/{location=locations/*}/workforcePools
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
location
|
The location of the pool. Format: |
Query parameters
| Parameters | |
|---|---|
parent
|
Required. The parent resource to list pools for. Format: |
pageSize
|
The maximum number of pools to return. The default value is 50. The maximum value is 100. |
pageToken
|
A page token, received from a previous |
showDeleted
|
Whether to return soft-deleted pools. |
Request body
The request body must be empty.
Response body
Response message for workforcePools.list.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"workforcePools"
:
[
{
object (
|
| Fields | |
|---|---|
workforcePools[]
|
A list of pools. |
nextPageToken
|
A token, which can be sent as |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/iam
For more information, see the Authentication Overview .

