.TH "GCLOUD_TRANSFER_AGENT\-POOLS_CREATE" 1



.SH "NAME"
.HP
gcloud transfer agent\-pools create \- create a Transfer Service agent pool



.SH "SYNOPSIS"
.HP
\f5gcloud transfer agent\-pools create\fR \fINAME\fR [\fB\-\-no\-async\fR] [\fB\-\-bandwidth\-limit\fR=\fIBANDWIDTH_LIMIT\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create an agent pool \-\- a group of agents used to connect to a source or
destination filesystem.



.SH "EXAMPLES"

To create an agent pool with name 'my\-pool', display name 'daily backups', and
no bandwidth limit, run:

.RS 2m
$ gcloud transfer agent\-pools create my\-pool \e
  \-\-display\-name='daily backups'
.RE

To create an agent pool with name 'my\-pool', display name 'daily backups', and
a bandwidth limit of 50 MB/s, run:

.RS 2m
$ gcloud transfer agent\-pools create my\-pool \e
  \-\-display\-name="daily backups" \-\-bandwidth\-limit=50
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

A unique, permanent identifier for this pool.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-no\-async\fR

Block other tasks in your terminal until the pool has been created. If not
included, pool creation will run asynchronously.

.TP 2m
\fB\-\-bandwidth\-limit\fR=\fIBANDWIDTH_LIMIT\fR

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.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

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.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

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 \fB$ gcloud help\fR for details.



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha transfer agent\-pools create
.RE