.TH "GCLOUD_ALPHA_NETAPP_VOLUMES_CREATE" 1



.SH "NAME"
.HP
gcloud alpha netapp volumes create \- create a Cloud NetApp Volume



.SH "SYNOPSIS"
.HP
\f5gcloud alpha netapp volumes create\fR (\fIVOLUME\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) \fB\-\-capacity\fR=\fICAPACITY\fR \fB\-\-protocols\fR=\fIPROTOCOL\fR,[\fIPROTOCOL\fR,...] \fB\-\-storage\-pool\fR=\fISTORAGE_POOL\fR [\fB\-\-async\fR] [\fB\-\-cache\-parameters\fR=[\fIcache\-config\fR=\fICACHE\-CONFIG\fR],[\fIenable\-global\-file\-lock\fR=\fIENABLE\-GLOBAL\-FILE\-LOCK\fR],[\fIpeer\-cluster\-name\fR=\fIPEER\-CLUSTER\-NAME\fR],[\fIpeer\-ip\-addresses\fR=\fIPEER\-IP\-ADDRESSES\fR],[\fIpeer\-svm\-name\fR=\fIPEER\-SVM\-NAME\fR],[\fIpeer\-volume\-name\fR=\fIPEER\-VOLUME\-NAME\fR]] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-enable\-kerberos\fR=\fIENABLE_KERBEROS\fR] [\fB\-\-export\-policy\fR=[\fIaccess\-type\fR=\fIACCESS\-TYPE\fR],[\fIallowed\-clients\fR=\fIALLOWED\-CLIENTS\fR],[\fIhas\-root\-access\fR=\fIHAS\-ROOT\-ACCESS\fR],[\fIkerberos\-5\-read\-only\fR=\fIKERBEROS\-5\-READ\-ONLY\fR],[\fIkerberos\-5\-read\-write\fR=\fIKERBEROS\-5\-READ\-WRITE\fR],[\fIkerberos\-5i\-read\-only\fR=\fIKERBEROS\-5I\-READ\-ONLY\fR],[\fIkerberos\-5i\-read\-write\fR=\fIKERBEROS\-5I\-READ\-WRITE\fR],[\fIkerberos\-5p\-read\-only\fR=\fIKERBEROS\-5P\-READ\-ONLY\fR],[\fIkerberos\-5p\-read\-write\fR=\fIKERBEROS\-5P\-READ\-WRITE\fR],[\fInfsv3\fR=\fINFSV3\fR],[\fInfsv4\fR=\fINFSV4\fR]] [\fB\-\-hybrid\-replication\-parameters\fR=[\fIcluster\-location\fR=\fICLUSTER\-LOCATION\fR],[\fIdescription\fR=\fIDESCRIPTION\fR],[\fIhybrid\-replication\-type\fR=\fIHYBRID\-REPLICATION\-TYPE\fR],[\fIlabels\fR=\fILABELS\fR],[\fIlarge\-volume\-constituent\-count\fR=\fILARGE\-VOLUME\-CONSTITUENT\-COUNT\fR],[\fIpeer\-cluster\-name\fR=\fIPEER\-CLUSTER\-NAME\fR],[\fIpeer\-ip\-addresses\fR=\fIPEER\-IP\-ADDRESSES\fR],[\fIpeer\-svm\-name\fR=\fIPEER\-SVM\-NAME\fR],[\fIpeer\-volume\-name\fR=\fIPEER\-VOLUME\-NAME\fR],[\fIreplication\fR=\fIREPLICATION\fR],[\fIreplication\-schedule\fR=\fIREPLICATION\-SCHEDULE\fR]] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-large\-capacity\fR=\fILARGE_CAPACITY\fR] [\fB\-\-multiple\-endpoints\fR=\fIMULTIPLE_ENDPOINTS\fR] [\fB\-\-restricted\-actions\fR=\fIRESTRICTED_ACTION\fR,[...]] [\fB\-\-security\-style\fR=\fISECURITY_STYLE\fR;\ default=\f5"SECURITY_STYLE_UNSPECIFIED"\fR] [\fB\-\-share\-name\fR=\fISHARE_NAME\fR] [\fB\-\-smb\-settings\fR=\fISMB_SETTING\fR,[\fISMB_SETTING\fR,...]] [\fB\-\-snap\-reserve\fR=\fISNAP_RESERVE\fR] [\fB\-\-snapshot\-daily\fR=[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]] [\fB\-\-snapshot\-directory\fR=\fISNAPSHOT_DIRECTORY\fR;\ default="true"] [\fB\-\-snapshot\-hourly\fR=[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]] [\fB\-\-snapshot\-monthly\fR=[\fIday\fR=\fIDAY\fR],[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]] [\fB\-\-snapshot\-weekly\fR=[\fIday\fR=\fIDAY\fR],[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]] [\fB\-\-source\-snapshot\fR=\fISOURCE_SNAPSHOT\fR] [\fB\-\-throughput\-mibps\fR=\fITHROUGHPUT_MIBPS\fR] [\fB\-\-tiering\-policy\fR=[\fItier\-action\fR=\fIENABLED\fR|\fIPAUSED\fR,...]] [\fB\-\-unix\-permissions\fR=\fIUNIX_PERMISSIONS\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Create a Cloud NetApp Volume



.SH "EXAMPLES"

The following command creates a NFS Volume named NAME asynchronously using the
specified arguments

.RS 2m
$ gcloud alpha netapp volumes create NAME \-\-capacity=1024 \e
  \-\-protocols=nfsv3,nfsv4 \-\-share\-name=share1 \-\-storage\-pool=sp1 \e
  \-\-description="test description" \-\-enable\-kerberos=true \e
  \-\-unix\-permissions=0755 \-\-async
.RE

The following command creates a SMB Volume named NAME asynchronously using the
specified arguments

.RS 2m
$ gcloud alpha netapp volumes create NAME \-\-capacity=1024 \e
  \-\-protocols=smb \-\-share\-name=share2 \-\-storage\-pool=sp2 \e
  \-\-description="test smb" \-\-security\-style=ntfs \e
  \-\-smb\-settings=SHOW_SNAPSHOT,SHOW_PREVIOUS_VERSIONS,\e
ACCESS_BASED_ENUMERATION \-\-snap\-reserve=0.1 \-\-async
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Volume resource \- The Volume to create. 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 \f5volume\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
\fIVOLUME\fR

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

To set the \f5volume\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5volume\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\-\-location\fR=\fILOCATION\fR

The location of the volume.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5volume\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5netapp/location\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-capacity\fR=\fICAPACITY\fR

The desired capacity of the Volume in GiB or TiB units.If no capacity unit is
specified, GiB is assumed.

.TP 2m
\fB\-\-protocols\fR=\fIPROTOCOL\fR,[\fIPROTOCOL\fR,...]

Type of File System protocols for the Cloud NetApp Files Volume. Valid component
values are: \f5NFSV3\fR, \f5NFSV4\fR, \f5SMB\fR.

.TP 2m

Storage pool resource \- The Storage Pool to associate with Volume. This
represents a Cloud 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 \f5\-\-storage\-pool\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-storage\-pool\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(em" 2m
set the property \f5netapp/location\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-storage\-pool\fR=\fISTORAGE_POOL\fR

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

To set the \f5storage_pool\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-storage\-pool\fR on the command line.
.RE
.sp


.RE
.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\-\-cache\-parameters\fR=[\fIcache\-config\fR=\fICACHE\-CONFIG\fR],[\fIenable\-global\-file\-lock\fR=\fIENABLE\-GLOBAL\-FILE\-LOCK\fR],[\fIpeer\-cluster\-name\fR=\fIPEER\-CLUSTER\-NAME\fR],[\fIpeer\-ip\-addresses\fR=\fIPEER\-IP\-ADDRESSES\fR],[\fIpeer\-svm\-name\fR=\fIPEER\-SVM\-NAME\fR],[\fIpeer\-volume\-name\fR=\fIPEER\-VOLUME\-NAME\fR]

Cache Parameters contains cache parameters of a volume.

.RS 2m
Cache Parameters will have the following format
`\-\-cache\-parameters=peer\-volume\-name=PEER_VOLUME_NAME,
  peer\-cluster\-name=PEER_CLUSTER_NAME,
  peer\-svm\-name=PEER_SVM_NAME,
  peer\-ip\-addresses=[PEER\-IP\-ADDRESS1#PEER\-IP\-ADDRESS2#...],
  enable\-global\-file\-lock=ENABLE_GLOBAL_FILE_LOCK,
  cache\-config=CACHE_CONFIG`
.RE

.RS 2m
*peer\-volume\-name*::: Name of the user's local source volume
*peer\-cluster\-name*::: Name of the user's local source cluster
*peer\-svm\-name*::: Name of the user's local source vserver svm
*peer\-ip\-addresses*::: Hashtag\-separated(#) list of IP addresses
*enable\-global\-file\-lock*::: If true, enable global file lock
*cache\-config*::: Cache\-config as a hashtag\-separated(#) list of key\-value pairs
.RE

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

A description of the Cloud NetApp Volume

.TP 2m
\fB\-\-enable\-kerberos\fR=\fIENABLE_KERBEROS\fR

Boolean flag indicating whether Volume is a kerberos Volume or not

.TP 2m
\fB\-\-export\-policy\fR=[\fIaccess\-type\fR=\fIACCESS\-TYPE\fR],[\fIallowed\-clients\fR=\fIALLOWED\-CLIENTS\fR],[\fIhas\-root\-access\fR=\fIHAS\-ROOT\-ACCESS\fR],[\fIkerberos\-5\-read\-only\fR=\fIKERBEROS\-5\-READ\-ONLY\fR],[\fIkerberos\-5\-read\-write\fR=\fIKERBEROS\-5\-READ\-WRITE\fR],[\fIkerberos\-5i\-read\-only\fR=\fIKERBEROS\-5I\-READ\-ONLY\fR],[\fIkerberos\-5i\-read\-write\fR=\fIKERBEROS\-5I\-READ\-WRITE\fR],[\fIkerberos\-5p\-read\-only\fR=\fIKERBEROS\-5P\-READ\-ONLY\fR],[\fIkerberos\-5p\-read\-write\fR=\fIKERBEROS\-5P\-READ\-WRITE\fR],[\fInfsv3\fR=\fINFSV3\fR],[\fInfsv4\fR=\fINFSV4\fR]

Export Policy of a Cloud NetApp Files Volume. This will be a field similar to
network in which export policy fields can be specified as such:
\f5\-\-export\-policy=allowed\-clients=ALLOWED_CLIENTS_IP_ADDRESSES,
has\-root\-access=HAS_ROOT_ACCESS_BOOL,access=ACCESS_TYPE,nfsv3=NFSV3,
nfsv4=NFSV4,kerberos\-5\-read\-only=KERBEROS_5_READ_ONLY,
kerberos\-5\-read\-write=KERBEROS_5_READ_WRITE,
kerberos\-5i\-read\-only=KERBEROS_5I_READ_ONLY,
kerberos\-5i\-read\-write=KERBEROS_5I_READ_WRITE,
kerberos\-5p\-read\-only=KERBEROS_5P_READ_ONLY,
kerberos\-5p\-read\-write=KERBEROS_5P_READ_WRITE\fR

.TP 2m
\fB\-\-hybrid\-replication\-parameters\fR=[\fIcluster\-location\fR=\fICLUSTER\-LOCATION\fR],[\fIdescription\fR=\fIDESCRIPTION\fR],[\fIhybrid\-replication\-type\fR=\fIHYBRID\-REPLICATION\-TYPE\fR],[\fIlabels\fR=\fILABELS\fR],[\fIlarge\-volume\-constituent\-count\fR=\fILARGE\-VOLUME\-CONSTITUENT\-COUNT\fR],[\fIpeer\-cluster\-name\fR=\fIPEER\-CLUSTER\-NAME\fR],[\fIpeer\-ip\-addresses\fR=\fIPEER\-IP\-ADDRESSES\fR],[\fIpeer\-svm\-name\fR=\fIPEER\-SVM\-NAME\fR],[\fIpeer\-volume\-name\fR=\fIPEER\-VOLUME\-NAME\fR],[\fIreplication\fR=\fIREPLICATION\fR],[\fIreplication\-schedule\fR=\fIREPLICATION\-SCHEDULE\fR]

Hybrid Replication Parameters contains hybrid replication parameters on a
volume.

.RS 2m
Hybrid Replication Parameters will have the following format
\-\-hybrid\-replication\-parameters=replication=REPLICATION,
peer\-volume\-name=PEER_VOLUME_NAME,
peer\-cluster\-name=PEER_CLUSTER_NAME,
peer\-svm\-name=PEER_SVM_NAME,
peer\-ip\-addresses=[PEER\-IP\-ADDRESS1#PEER\-IP\-ADDRESS2#...],
cluster\-location=CLUSTER_LOCATION,
description=DESCRIPTION,
replication\-schedule=REPLICATION_SCHEDULE,
hybrid\-replication\-type=HYBRID_REPLICATION_TYPE,
large\-volume\-constituent\-count=LARGE_VOLUME_CONSTITUENT_COUNT,
labels=[KEY1:VALUE1#KEY2:VALUE2#...],
.RE

replication is the desired name for the replication of the volume,
peer\-volume\-name is the name of the user's local source volume,
peer\-cluster\-name is the name of the user's local source cluster,
peer\-svm\-name is the name of the user's local source vserver svm,
peer\-ip\-addresses is a ampersand\-separated(#) list of ip addresses,
cluster\-location is the name of the source cluster location, description is the
description of the replication, replication\-schedule is the schedule of
corresponding hybrid replication created, hybrid\-replication\-type is the
hybrid replication type of the corresponding hybrid replication created,
large\-volume\-constituent\-count is the number of constituent volumes in the
large volume, and labels is an hashtag\-separated(#) key value pair of labels
with key and value separated by colon(:) for the replication.

.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.

.TP 2m
\fB\-\-large\-capacity\fR=\fILARGE_CAPACITY\fR

Boolean flag indicating whether Volume is a large capacity Volume or not

.TP 2m
\fB\-\-multiple\-endpoints\fR=\fIMULTIPLE_ENDPOINTS\fR

Boolean flag indicating whether Volume is a multiple endpoints Volume or not

.TP 2m
\fB\-\-restricted\-actions\fR=\fIRESTRICTED_ACTION\fR,[...]

Actions to be restricted for a volume. Valid restricted action options are:
\'DELETE'.

.TP 2m
\fB\-\-security\-style\fR=\fISECURITY_STYLE\fR; default=\f5"SECURITY_STYLE_UNSPECIFIED"\fR

The security style of the Volume. This can either be UNIX or NTFS.

\fISECURITY_STYLE\fR must be one of:

.RS 2m
.TP 2m
\fBntfs\fR
NTFS security style for Volume.
.TP 2m
\fBunix\fR
UNIX security style for Volume
.RE
.sp


.TP 2m
\fB\-\-share\-name\fR=\fISHARE_NAME\fR

Share name of the Mount path clients will use.

.TP 2m
\fB\-\-smb\-settings\fR=\fISMB_SETTING\fR,[\fISMB_SETTING\fR,...]

List of settings specific to SMB protocol for a Cloud NetApp Files Volume. Valid
component values are: \f5ENCRYPT_DATA\fR, \f5BROWSABLE\fR, \f5CHANGE_NOTIFY\fR,
\f5NON_BROWSABLE\fR, \f5OPLOCKS\fR, \f5SHOW_SNAPSHOT\fR,
\f5SHOW_PREVIOUS_VERSIONS\fR, \f5ACCESS_BASED_ENUMERATION\fR,
\f5CONTINUOUSLY_AVAILABLE\fR.

.TP 2m
\fB\-\-snap\-reserve\fR=\fISNAP_RESERVE\fR

(DEPRECATED) The percentage of volume storage reserved for snapshot storage. The
default value for this is 0 percent

The snap\-reserve option is deprecated

.TP 2m
\fB\-\-snapshot\-daily\fR=[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]

Make a snapshot every day e.g. at 06:00, 05:20, 23:50

.TP 2m
\fB\-\-snapshot\-directory\fR=\fISNAPSHOT_DIRECTORY\fR; default="true"

Snapshot Directory if enabled (true) makes the Volume contain a read\-only
.snapshot directory which provides access to each of the volume's snapshots

.TP 2m
\fB\-\-snapshot\-hourly\fR=[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]

Make a snapshot every hour e.g. at 04:00, 05:20, 06:00

.TP 2m
\fB\-\-snapshot\-monthly\fR=[\fIday\fR=\fIDAY\fR],[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]

Make a snapshot once a month e.g. at 2nd 04:00, 7th 05:20, 24th 23:50

.TP 2m
\fB\-\-snapshot\-weekly\fR=[\fIday\fR=\fIDAY\fR],[\fIhour\fR=\fIHOUR\fR],[\fIminute\fR=\fIMINUTE\fR],[\fIsnapshots\-to\-keep\fR=\fISNAPSHOTS\-TO\-KEEP\fR]

Make a snapshot every week e.g. at Monday 04:00, Wednesday 05:20, Sunday 23:50

.TP 2m

Snapshot resource \- The source Snapshot to create the Volume from. This
represents a Cloud 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 \f5\-\-source\-snapshot\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-source\-snapshot\fR on the command line with a fully
specified name;
.IP "\(em" 2m
set the property \f5netapp/location\fR.
.RE
.sp

To set the \f5volume\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-source\-snapshot\fR on the command line with a fully
specified name.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-source\-snapshot\fR=\fISOURCE_SNAPSHOT\fR

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

To set the \f5snapshot\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-snapshot\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-throughput\-mibps\fR=\fITHROUGHPUT_MIBPS\fR

The desired throughput of the volume in MiB/s.

.TP 2m
\fB\-\-tiering\-policy\fR=[\fItier\-action\fR=\fIENABLED\fR|\fIPAUSED\fR,...]

Tiering Policy contains auto tiering policy on a volume.

.RS 2m
Tiering Policy will have the following format
\-\-tiering\-policy=tier\-action=TIER_ACTION,
cooling\-threshold\-days=COOLING_THRESHOLD_DAYS
.RE

.RS 2m
tier\-action is an enum, supported values are ENABLED or PAUSED,
cooling\-threshold\-days is an integer represents time in days to mark the
volume's data block as cold and make it eligible for tiering, can be range from
7\-183. Default is 31.
.RE

.TP 2m
\fB\-\-unix\-permissions\fR=\fIUNIX_PERMISSIONS\fR

Unix permissions the mount point will be created with. Unix permissions are only
applicable with NFS protocol only


.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 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. These variants are also available:

.RS 2m
$ gcloud netapp volumes create
.RE

.RS 2m
$ gcloud beta netapp volumes create
.RE