gcloud alpha transfer agent-pools create - create a Transfer Service agent pool
gcloud alpha transfer agent-pools create NAME [--no-async] [--bandwidth-limit=BANDWIDTH_LIMIT] [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...]
(ALPHA) Create an agent pool -- a group of agents used to connect to a source or destination filesystem.
To create an agent pool with name 'my-pool', display name 'daily backups', and no bandwidth limit, run:
$ gcloud alpha transfer agent-pools create my-pool \ --display-name='daily backups'
To create an agent pool with name 'my-pool', display name 'daily backups', and a bandwidth limit of 50 MB/s, run:
$ gcloud alpha transfer agent-pools create my-pool \ --display-name="daily backups" --bandwidth-limit=50
- NAME
A unique, permanent identifier for this pool.
- --no-async
Block other tasks in your terminal until the pool has been created. If not included, pool creation will run asynchronously.
- --bandwidth-limit=BANDWIDTH_LIMIT
Set how much of your bandwidth to make available to this pool's agents. A bandwidth limit applies to all agents in a pool and can help prevent the pool's transfer workload from disrupting other operations that share your bandwidth. For example, enter '50' to set a bandwidth limit of 50 MB/s. By leaving this flag unspecified, this flag unspecified, this pool's agents will use all bandwidth available to them.
- --display-name=DISPLAY_NAME
A modifiable name to help you identify this pool. You can include details that might not fit in the pool's unique full resource name.
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. This variant is also available:
$ gcloud transfer agent-pools create