gcloud beta netapp volumes create - create a Cloud NetApp Volume

gcloud beta netapp volumes create(VOLUME :--location=LOCATION)--capacity=CAPACITY--protocols=PROTOCOL,[PROTOCOL,…]--storage-pool=STORAGE_POOL[--async][--backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]][--block-devices=[host-groups=HOST-GROUPS],[name=NAME],[os-type=OS-TYPE],[size-gib=SIZE-GIB]][--cache-parameters=[cache-config=CACHE-CONFIG],[enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME]][--cache-pre-populate=[exclude-path-list=EXCLUDE-PATH-LIST],[path-list=PATH-LIST],[recursion=RECURSION]][--description=DESCRIPTION][--enable-kerberos=ENABLE_KERBEROS][--export-policy=[access-type=ACCESS-TYPE],[allowed-clients=ALLOWED-CLIENTS],[anon-uid=ANON-UID],[has-root-access=HAS-ROOT-ACCESS],[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],[nfsv3=NFSV3],[nfsv4=NFSV4],[squash-mode=SQUASH-MODE]][--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION],[replication-schedule=REPLICATION-SCHEDULE]][--labels=[KEY=VALUE,…]][--large-capacity=LARGE_CAPACITY][--multiple-endpoints=MULTIPLE_ENDPOINTS][--restricted-actions=RESTRICTED_ACTION,[…]][--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"][--share-name=SHARE_NAME][--smb-settings=SMB_SETTING,[SMB_SETTING,…]][--snap-reserve=SNAP_RESERVE][--snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]][--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"][--snapshot-hourly=[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]][--snapshot-monthly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]][--snapshot-weekly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]][--source-snapshot=SOURCE_SNAPSHOT][--throughput-mibps=THROUGHPUT_MIBPS][--tiering-policy=[tier-action=ENABLED|PAUSED,…]][--unix-permissions=UNIX_PERMISSIONS][--source-backup=SOURCE_BACKUP :--backup_vault=BACKUP_VAULT][GCLOUD_WIDE_FLAG …]

gcloudbetanetappvolumescreateNAME--capacity=1024--protocols=nfsv3,nfsv4--share-name=share1--storage-pool=sp1--description="test description"--enable-kerberos=true--unix-permissions=0755--async

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

gcloudbetanetappvolumescreateNAME--capacity=1024--protocols=smb--share-name=share2--storage-pool=sp2--description="test smb"--security-style=ntfs--smb-settings=SHOW_SNAPSHOT,SHOW_PREVIOUS_VERSIONS,ACCESS_BASED_ENUMERATION--snap-reserve=0.1--async

Volume resource - The Volume to create. The arguments in this group can be usedto specify the attributes of this resource. (NOTE) Some attributes are not givenarguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argumentvolume on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

This must be specified.

VOLUME

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

To set thevolume attribute:

• provide the argumentvolume on the command line.

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

--location=LOCATION

The location of the volume.

To set thelocation attribute:

• provide the argumentvolume on the command line with a fullyspecified name;
• provide the argument--location on the command line;
• set the propertynetapp/location.

--capacity=CAPACITY

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

--protocols=PROTOCOL,[PROTOCOL,…]

Type of File System protocols for the Cloud NetApp Files Volume. Valid componentvalues are:NFSV3,NFSV4,SMB.

Storage pool resource - The Storage Pool to associate with Volume. Thisrepresents a Cloud resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

• provide the argument--storage-pool on the command line with afully specified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--storage-pool on the command line with afully specified name;
• provide the argument--location on the command line;
• set the propertynetapp/location.

This must be specified.

--storage-pool=STORAGE_POOL

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

To set thestorage_pool attribute:

• provide the argument--storage-pool on the command line.

--async

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

--backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]

Backup Config contains backup related config on a volume.

BackupConfigwillhavethefollowingformat`--backup-config=backup-policies=BACKUP_POLICIES,backup-vault=BACKUP_VAULT_NAME,enable-scheduled-backups=ENABLE_SCHEDULED_BACKUPS

backup-policies is a pound-separated (#) list of backup policy names,backup-vault can include a single backup-vault resource name, andenable-scheduled-backups is a Boolean value indicating whether or not scheduledbackups are enabled on the volume.

--block-devices=[host-groups=HOST-GROUPS],[name=NAME],[os-type=OS-TYPE],[size-gib=SIZE-GIB]

A block device to be created with the volume.

This flag can be repeated to specify multiple block devices.

The following keys are available:

name

A user-defined name for the block device.

host-groups

A comma-separated list of host groups that can mount the block volume.

os-type

The OS type of the volume. Allowed values areOS_TYPE_UNSPECIFIED,LINUX,WINDOWS.

size-gib

The size of the block device in GiB. Note that this value is ignored duringvolume creation and is system-managed.

--cache-parameters=[cache-config=CACHE-CONFIG],[enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME]

Cache Parameters contains cache parameters of a volume.

CacheParameterswillhavethefollowingformat`--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`

*peer-volume-name*:::Nameoftheuser's local source volume*peer-cluster-name*::: Name of the user'slocalsourcecluster*peer-svm-name*:::Nameoftheuser'slocalsourcevserversvm*peer-ip-addresses*:::Hashtag-separated(#) list of IP addresses*enable-global-file-lock*:::Iftrue,enableglobalfilelock*cache-config*:::Cache-configasahashtag-separated(#) list of key-value pairs

--cache-pre-populate=[exclude-path-list=EXCLUDE-PATH-LIST],[path-list=PATH-LIST],[recursion=RECURSION]

Cache Pre-populate contains cache pre-populate parameters of a volume.

Cache Pre-populate will have the following format--cache-pre-populate=path-list=PATH_LIST1#PATH_LIST2,exclude-path-list=EXCLUDE_PATH_LIST1#EXCLUDE_PATH_LIST2,recursion=RECURSION

path-list

Hashtag-separated(#) list of paths to be pre-populated

exclude-path-list

Hashtag-separated(#) list of paths to be excluded from pre-population

recursion

Boolean value indicating pre-populate recursion.

--description=DESCRIPTION

A description of the Cloud NetApp Volume

--enable-kerberos=ENABLE_KERBEROS

Boolean flag indicating whether Volume is a kerberos Volume or not

--export-policy=[access-type=ACCESS-TYPE],[allowed-clients=ALLOWED-CLIENTS],[anon-uid=ANON-UID],[has-root-access=HAS-ROOT-ACCESS],[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],[nfsv3=NFSV3],[nfsv4=NFSV4],[squash-mode=SQUASH-MODE]

Export Policy of a Cloud NetApp Files Volume. This will be a field similar tonetwork in which export policy fields can be specified as such:--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,squash-mode=SQUASH_MODE,anon-uid=ANON_UID

--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION],[replication-schedule=REPLICATION-SCHEDULE]

Hybrid Replication Parameters contains hybrid replication parameters on avolume.

HybridReplicationParameterswillhavethefollowingformat--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#…],

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-nameis the name of the user's local source vserver svm, peer-ip-addresses is aampersand-separated(#) list of ip addresses, cluster-location is the name of thesource cluster location, description is the description of the replication,replication-schedule is the schedule of corresponding hybrid replicationcreated, hybrid-replication-type is the hybrid replication type of thecorresponding hybrid replication created, large-volume-constituent-count is thenumber of constituent volumes in the large volume, and labels is anhashtag-separated(#) key value pair of labels with key and value separated bycolon(:) for the replication.

--labels=[KEY=VALUE,…]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers.

--large-capacity=LARGE_CAPACITY

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

--multiple-endpoints=MULTIPLE_ENDPOINTS

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

--restricted-actions=RESTRICTED_ACTION,[…]

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

--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"

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

SECURITY_STYLE must be one of:

ntfs

NTFS security style for Volume.

unix

UNIX security style for Volume

--share-name=SHARE_NAME

Share name of the Mount path clients will use.

--smb-settings=SMB_SETTING,[SMB_SETTING,…]

List of settings specific to SMB protocol for a Cloud NetApp Files Volume. Validcomponent values are:ENCRYPT_DATA,BROWSABLE,CHANGE_NOTIFY,NON_BROWSABLE,OPLOCKS,SHOW_SNAPSHOT,SHOW_PREVIOUS_VERSIONS,ACCESS_BASED_ENUMERATION,CONTINUOUSLY_AVAILABLE.

--snap-reserve=SNAP_RESERVE

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

The snap-reserve option is deprecated

--snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]

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

--snapshot-directory=SNAPSHOT_DIRECTORY; 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

--snapshot-hourly=[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]

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

--snapshot-monthly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]

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

--snapshot-weekly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]

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

Snapshot resource - The source Snapshot to create the Volume from. Thisrepresents a Cloud resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

• provide the argument--source-snapshot on the command line with afully specified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--source-snapshot on the command line with afully specified name;
• set the propertynetapp/location.

To set thevolume attribute:

• provide the argument--source-snapshot on the command line with afully specified name.

--source-snapshot=SOURCE_SNAPSHOT

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

To set thesnapshot attribute:

• provide the argument--source-snapshot on the command line.

--throughput-mibps=THROUGHPUT_MIBPS

The desired throughput of the volume in MiB/s.

--tiering-policy=[tier-action=ENABLED|PAUSED,…]

Tiering Policy contains auto tiering policy on a volume.

TieringPolicywillhavethefollowingformat--tiering-policy=tier-action=TIER_ACTION,cooling-threshold-days=COOLING_THRESHOLD_DAYS

tier-actionisanenum,supportedvaluesareENABLEDorPAUSED,
cooling-threshold-daysisanintegerrepresentstimeindaystomarkthevolume'sdatablockascoldandmakeiteligiblefortiering,canberangefrom7-183.Defaultis31.

--unix-permissions=UNIX_PERMISSIONS

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

Backup resource - The source Backup to create the Volume from. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argument--source-backup on the command line with afully specified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--source-backup on the command line with afully specified name;
• set the propertynetapp/location.

--source-backup=SOURCE_BACKUP

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

To set thebackup attribute:

• provide the argument--source-backup on the command line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--backup_vault=BACKUP_VAULT

The Backup Vault of the backup.

To set thebackup_vault attribute:

• provide the argument--source-backup on the command line with afully specified name;
• provide the argument--backup_vault on the command line;
• provide the argument--backup-vault on the command line.

Run$gcloud help for details.