NAME
    gcloud beta netapp storage-pools restore-volume - restores a backup to a
        volume in a specified ONTAP-mode Storage Pool

SYNOPSIS
    gcloud beta netapp storage-pools restore-volume
        (STORAGE_POOL : --location=LOCATION) --volume-uuid=VOLUME_UUID
        (--backup=BACKUP : --backup_vault=BACKUP_VAULT) [--async]
        [--file-list=[FILE_LIST,...]]
        [--restore-destination-path=RESTORE_DESTINATION_PATH]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Restores a backup to a volume within the specified Storage Pool.

    This command supports both full backup restore and selective file restore:

    Full Backup Restore: The --volume-uuid must reference a Data Protection
    (DP) volume where the backup will be restored.

    File Restore: The --volume-uuid must reference a Read-Write (RW) volume
    where the file(s) from the backup will be restored. For file restore,
    --file-list and --restore-destination-path must be included in the request
    payload.

    For the complete backup restore, users should first create a Data
    Protection volume via the ONTAP Mode APIs whereas a Read-Write volume must
    be created first for selective file restore.

EXAMPLES
    The following command restores full backup from a backup with full resource
    name
    projects/my-project/locations/us-central1/backupVaults/my-vault/backups/backup-1
    to an ONTAP-mode volume with UUID 5dc61a44-3d99-11f1-b8ff-39021cc41d7a in
    Storage Pool named NAME.

        $ gcloud beta netapp storage-pools restore-volume NAME \
          --location=us-central1 \
          --backup=projects/my-project/locations/us-central1/\
        backupVaults/my-vault/backups/backup-1 \
            --volume-uuid=5dc61a44-3d99-11f1-b8ff-39021cc41d7a

    The following command restores file1.txt from the same backup to an
    ONTAP-mode volume with UUID 5dc61a44-3d99-11f1-b8ff-39021cc41d7a in Storage
    Pool named NAME to the directory /my_restore_destination.

        $ gcloud beta netapp storage-pools restore-volume NAME \
          --location=us-central1 \
          --backup=projects/my-project/locations/us-central1/\
        backupVaults/my-vault/backups/backup-1 \
            --volume-uuid=5dc61a44-3d99-11f1-b8ff-39021cc41d7a \
            --file-list=/path/to/file1.txt \
            --restore-destination-path=/my_restore_destination

POSITIONAL ARGUMENTS
     Storage pool resource - The Storage Pool to restore into. 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 project attribute:
      ◆ provide the argument storage_pool on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     This must be specified.

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

          To set the storage_pool attribute:
          ▸ provide the argument storage_pool on the command line.

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

       --location=LOCATION
          The location of the storage_pool.

          To set the location attribute:
          ▸ provide the argument storage_pool on the command line with a
            fully specified name;
          ▸ provide the argument --location on the command line;
          ▸ set the property netapp/location.

REQUIRED FLAGS
     --volume-uuid=VOLUME_UUID
        The UUID of the ONTAP-mode volume to restore to.

     Backup resource - The Backup from which files are restored back to the
     Volume. 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 project attribute:
      ◆ provide the argument --backup on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument --backup on the command line with a fully
        specified name;
      ◆ set the property netapp/location.

     This must be specified.

       --backup=BACKUP
          ID of the backup or fully qualified identifier for the backup.

          To set the backup attribute:
          ▸ provide the argument --backup on the command line.

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

       --backup_vault=BACKUP_VAULT
          The Backup Vault of the backup.

          To set the backup_vault attribute:
          ▸ provide the argument --backup on the command line with a fully
            specified name;
          ▸ provide the argument --backup_vault on the command line;
          ▸ provide the argument --backup-vault on the command line.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --file-list=[FILE_LIST,...]
        List of files to be restored in the form of their absolute path as in
        source volume.

     --restore-destination-path=RESTORE_DESTINATION_PATH
        Name of the absolute directory path in the destination volume.

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

NOTES
    This command is currently in beta and might change without notice. This
    variant is also available:

        $ gcloud alpha netapp storage-pools restore-volume

