.TH "GCLOUD_BMS_NFS\-SHARES_CREATE" 1



.SH "NAME"
.HP
gcloud bms nfs\-shares create \- create a Bare Metal Solution NFS share



.SH "SYNOPSIS"
.HP
\f5gcloud bms nfs\-shares create\fR (\fINFS_SHARE\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-allowed\-client\fR=[\fIPROPERTY\fR=\fIVALUE\fR,...] \fB\-\-size\-gib\fR=\fISIZE_GIB\fR \fB\-\-storage\-type\fR=\fISTORAGE_TYPE\fR [\fB\-\-async\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a Bare Metal Solution NFS share.



.SH "EXAMPLES"

To create an NFS share called \f5\fImy\-share\fR\fR in region
\f5\fIus\-central1\fR\fR, with requested size of 256 Gib, SSD storage and 2
allowed clients, run:

.RS 2m
$ gcloud bms nfs\-shares create my\-share \-\-region=us\-central1 \e
    \-\-size\-gib=256 \-\-storage\-type=SSD \e
    \-\-allowed\-client=network=my\-network,\e
network\-project\-id=some\-other\-project,cidr=10.130.240.24/29,\e
mount\-permissions=READ_ONLY,allow\-dev=yes,allow\-suid=no,\e
enable\-root\-squash=yes \e
    \-\-allowed\-client=network=my\-network2,cidr=10.130.240.26/28,\e
mount\-permissions=READ_WRITE,allow\-dev=yes,allow\-suid=yes,\e
enable\-root\-squash=no
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Nfs share resource \- nfs_share. The arguments in this group can be used to
specify the attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5nfs_share\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fINFS_SHARE\fR

ID of the nfs_share or fully qualified identifier for the nfs_share.

To set the \f5nfs_share\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5nfs_share\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the resource.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5nfs_share\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-allowed\-client\fR=[\fIPROPERTY\fR=\fIVALUE\fR,...]

Adds an allowed client to the NFS share. This flag can be repeated to specify
multiple allowed clients.

.RS 2m
.TP 2m
\fBnetwork\fR
The name of the network to allow.

.TP 2m
\fBnetwork\-project\-id\fR
The project ID of the allowed client network. If not present, the project ID of
the NFS share will be used.

.TP 2m
\fBcidr\fR
The subnet of IP addresses permitted to access the NFS share.

.TP 2m
\fBmount\-permissions\fR
The mount permissions for the allowed client. \f5\fIMOUNT_PERMISSIONS\fR\fR must
be one of: \f5READ_ONLY\fR, \f5READ_WRITE\fR.

.TP 2m
\fBallow\-dev\fR
If \f5\fIyes\fR\fR, allows creation of devices.

.TP 2m
\fBallow\-suid\fR
If \f5\fIyes\fR\fR, allows SUID.

.TP 2m
\fBenable\-root\-squash\fR
If \f5\fIyes\fR\fR, enables root squashing which is a special mapping of the
remote superuser (root) identity when using identity authentication .

.RE
.sp
.TP 2m
\fB\-\-size\-gib\fR=\fISIZE_GIB\fR

The requested size of the NFS share in GiB

.TP 2m
\fB\-\-storage\-type\fR=\fISTORAGE_TYPE\fR

Specifies the storage type of the underlying volume which will be created for
the NFS share. \fISTORAGE_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBHDD\fR
The storage type of the underlying volume will be HDD
.TP 2m
\fBSSD\fR
The storage type of the underlying volume will be SSD
.RE
.sp



.RE
.sp

.SH "OPTIONAL FLAGS"

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

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.


.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 bms nfs\-shares create
.RE