Creates an agent pool resource.
HTTP request
POST https://storagetransfer.googleapis.com/v1/projects/{projectId}/agentPools
The URL uses gRPC Transcoding syntax.
Path parameters
projectId
string
Required. The ID of the Google Cloud project that owns the agent pool.
Authorization requires the following IAM
permission on the specified resource projectId
:
-
storagetransfer.agentpools.create
Query parameters
agentPoolId
string
Required. The ID of the agent pool to create.
The agentPoolId
must meet the following requirements:
- Length of 128 characters or less.
- Not start with the string
goog. - Start with a lowercase ASCII character, followed by:
- Zero or more: lowercase Latin alphabet characters, numerals, hyphens (
-), periods (.), underscores (_), or tildes (~). - One or more numerals or lowercase ASCII characters.
- Zero or more: lowercase Latin alphabet characters, numerals, hyphens (
As expressed by the regular expression: ^(?!goog)[a-z]([a-z0-9-._~]*[a-z0-9])?$
.
Request body
The request body contains an instance of AgentPool
.
Response body
If successful, the response body contains a newly created instance of AgentPool
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

