Edit a volume

This page provides details about which volume settings are editable and instructions for how to edit a volume.

Editable settings

You can change the following settings of a volume after it's created:

  • Storage pool settings: you can re-assign the volumes of Premium and Extreme service levels to a different pool to change its service level. For example, if the storage pool hosts a Premium service level volume, you can re-assign the volume to an Extreme service level storage pool and the other way around. The change to service levels lets you manage volume throughput limits and per GiB costs.

  • Volume details: the capacity of a volume is adjustable up and down in 1 GiB increments. The size of the file data in the volume must be smaller than the volume capacity. When you increase the volume capacity, the pool that hosts the volume must have enough available capacity to accommodate the additional capacity requirement.

    Changing the volume capacity can impact the maximum achievable throughput of volumes of Standard, Premium, or Extreme service level.

    If the storage pool doesn't have enough capacity to accommodate the additional capacity requirement, you can increase the capacity of the pool, see Storage pool capacity.

  • Protocol configurations: you can change the configuration for selected protocols, but you can't change the protocol itself. For example, if the volume's protocol type is Server Message Block (SMB), you can choose to enable or disable SMB encryption, hide or show the SMB share, and enable or disable access-based enumeration.

  • Export rules: for volumes that use NFSv3 or NFSv4.1 protocol types, you can edit the export rules.

  • Auto-tiering: for volumes in storage pools that allow auto-tiering, you can enable auto-tiering. For volumes which have already enabled auto-tiering, you can pause or resume auto-tiering, and you can edit the cooling threshold.

  • Snapshot schedules: you can modify the snapshot schedule. You can either make the snapshot directory visible if you want to enable file system access to snapshot versions by clients or allow scheduled snapshots to configure the volume to automatically take snapshots.

  • Backup configuration: you can do the following in backup configuration with Standard, Premium, or Extreme service level:

    • Attach a volume to a backup vault.

    • Remove a volume from a backup vault.

    • Set a schedule for automatic backups by attaching a backup policy.

  • Labels: you can add, modify, or delete labels.

Considerations

Consider the following before you edit a volume:

  • For volumes in an active volume replication, changes to either the source or destination volume also apply to the replication partner. For volumes in a stopped replication, changes apply independently from the replication partner.

  • You can only move volumes to pools that are in the same location and have the same Active Directory policy, customer-managed encryption key (CMEK) policy, LDAP, and Virtual Private Cloud (VPC) settings as the pool that hosts the volume. Auto-tiered volumes can only be moved to a storage pool that allows auto-tiering, regardless of whether auto-tiering is enabled or paused for the volume.

  • Only pools that satisfy the conditional criteria are listed for selections. The target storage pool needs enough available capacity to accommodate the volume.

  • The maximum throughput for Standard, Premium, and Extreme service level volumes depends on the capacity of the volume and the service level you chose. An Extreme volume goes twice as fast as a Premium volume of the same capacity. A larger volume provides higher performance based on additional IOPS or throughput.

Edit a volume

Use the following instructions to edit a volume using the Google Cloud console or Google Cloud CLI:

Console

  1. Go to the NetApp Volumes page in the Google Cloud console.

    Go to NetApp Volumes

  2. Identify the volume you want to edit.

  3. Click Show more icon on the volume and click Edit.

  4. Edit volume details and save your changes.

gcloud

Edit a volume using the following command:

gcloud netapp volumes update VOLUME_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --storage-pool=STORAGE_POOL \
  --description=DESCRIPTION \
  --capacity=CAPACITY \
  --share-name=SHARE_NAME

Replace the following information:

  • VOLUME_ID: the ID of the volume.

  • PROJECT_ID: the name of the project to create the volume in.

  • LOCATION: the location for the volume.

  • STORAGE_POOL: the storage pool to create the volume in.

  • DESCRIPTION: the new description of the volume.

  • CAPACITY: the size of the volume. It defines the capacity that NAS clients see.

Example to edit a volume

The following example shows you how to edit a volume:

gcloud netapp volumes update volume-id --project=project-id --location=us-central1 --storage-pool=pool-id --description=description --capacity=capacity --share-name=share-name

Example to edit an auto-tiered volume

The following example shows you how to edit an auto-tiered volume:

gcloud beta netapp volumes update volume-id --project=project-id --location=location --tiering-policy=tier-action=ENABLED,cooling-threshold-days=31

For more information on additional optional flags, see Google Cloud SDK documentation on volumes.

What's next

Delete a volume.