Manage boot volume snapshots
You can create, delete, view, and restore a boot volume snapshot.
View boot volume snapshot details
You can view the list of snapshots of a boot volume and their details, including the following:
- ID
- Name
- Description
- Create time
- Associated volume
Type
Console
- Go to the Compute Engine > Bare Metal Solution > Volumes page.
- Click the volume name.
- On the Volume details page, in the Snapshots section, you can view the list of snapshots and their details.
gcloud
To list all the snapshots for a boot volume, issue the gcloud bms volumes
snapshots list command.
gcloud bms volumes snapshots list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
To view details of a specific boot volume snapshot, issue the gcloud bms
volumes snapshots describe command.
gcloud bms volumes snapshots describe --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME
API
To list all boot volume snapshots, enter your project ID, region, and volume
name into the following curl command. Copy the command, paste it into the
Cloud Shell prompt, and press the Enter or Return key.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json" \ "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"
To view details of a boot volume snapshot, enter your project ID, region,
volume name, and snapshot name into the following curl command. Copy the
command, paste it into the Cloud Shell prompt, and press the
Enter or Return key.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json" \ "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"
Create a boot volume snapshot
You can create snapshots for boot volumes.
Console
- Go to the Compute Engine > Bare Metal Solution > Volumes page.
- Click the volume name.
- On the Volume details page, in the Snapshots section, click Create.
- On the Create a new volume snapshot page:
- In the Name field, enter a unique name for the snapshot.
- In the Description field, enter a description for the snapshot.
- Click Create.
gcloud
To create a boot volume snapshot, issue the gcloud bms volumes snapshot
command.
gcloud bms volumes snapshot --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME --description=DESCRIPTION
API
To create a boot volume snapshot, enter your project ID, region, volume
name, snapshot name, and snapshot description into the following curl
command. Copy the command, paste it into the Cloud Shell prompt,
and press the Enter or Return key.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"
-d \
'{\''name\'':
\''projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME\'', \''description\'': \''DESCRIPTION\''}' \
Delete a boot volume snapshot
You can delete boot volume snapshots.
Console
- Go to the Compute Engine > Bare Metal Solution > Volumes page.
- Click the volume name.
- On the Volume details page, in the Snapshots section, select the snapshot that you want to delete.
- Click Delete.
- When prompted, click Confirm.
gcloud
To delete a boot volume snapshot, issue the gcloud bms volumes snapshots
delete command.
gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=SNAPSHOT_NAME
When prompted, type "Y" and press the Enter or Return key.
API
To delete a boot volume snapshot, enter your project ID, region, volume
name, and snapshot name into the following curl command. Copy the command,
paste it into the Cloud Shell prompt, and press the Enter or
Return key.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json" \ "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"
Restore a boot volume snapshot
You can restore a boot volume from a snapshot.
Console
- Go to the Compute Engine > Bare Metal Solution > Servers page.
Stop the server attached to the volume that you want to restore. See Operate your Bare Metal Solution server.
Wait for the shutdown to complete before moving to the next step.
Go to the Compute Engine > Bare Metal Solution > Volumes page.
For the volume that you want to restore, click the volume name.
On the Volume details page:
- For the snapshot that you want to restore, click .
- Click Restore.
- When prompted, click Confirm.
gcloud
To restore a boot volume snapshot, issue the gcloud bms volumes restore
command.
gcloud bms volumes restore --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot=SNAPSHOT_NAME
API
To restore a boot volume snapshot, enter your project ID, region, volume
name, and snapshot name into the following curl command. Copy the command,
paste it into the Cloud Shell prompt, and press the Enter or
Return key.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json" \ -H "Content-Length:0" \ "https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME:restoreVolumeSnapshot"
Because restoring a boot volume takes a while to complete, you can check the status by following the steps in View the status of a long-running operation.