Troubleshoot storage

A new volume reports status: ERROR instead of AVAILABLE, with a statusReason of the form the operation failed (<code>).

The platform couldn’t provision the volume. There’s no usable disk behind it.

• Delete the volume. Deleting an ERROR volume is allowed. See Delete a volume.
• Create or import the volume again.

For import failures, see Import fails with ERR_IMPORT or ERR_IMPORT_IMAGE_TOO_LARGE.

A deleted volume stays in your volume list with status: ERROR instead of disappearing.

The platform couldn’t remove the volume’s disk. The disk may still exist, so the volume still counts against your quota.

• Delete the volume again.
• If it returns to ERROR again, contact support with the volume’s URN and its statusReason.

After a resize, the volume reports modificationStatus: FAILED with a modificationStatusReason, and sizeInGib still shows the old size.

The platform accepted the resize but couldn’t apply it. The volume’s data is intact and it’s still usable at its old size.

• Request the resize again. See Resize a volume.

resize-volume fails immediately with an error such as volumes can only grow, the volume is already <n> GiB, or a volume in state <state> cannot be resized.

The requested size isn’t larger than the current size, or the volume isn’t AVAILABLE or INUSE, or another resize is still in progress. Nothing about the volume changed.

• Ask for a size larger than the current sizeInGib. Volumes can’t shrink.
• Wait for a CREATING volume to become AVAILABLE, or for modificationStatus to leave RESIZING, then retry.

delete-volume fails with the volume cannot be deleted while an instance attachment still claims it: <attachment-id>.

The volume is attached to an instance and reports INUSE.

• Find the instance. See Find the instance a volume is attached to.
• Detach the volume. See Attach and detach volumes.
• Delete the volume again.

delete-volume fails with the volume cannot be deleted while a snapshot of it still exists: <snapshot-id>, or the same message naming several snapshots.

A snapshot depends on its volume’s data. Every snapshot that isn’t DELETED blocks the delete, including one in ERROR.

• Delete each named snapshot, unprotecting it first if needed. See Delete a snapshot.
• Wait until each reports DELETED.
• Delete the volume again.

After you terminate an instance, one of its volumes is still AVAILABLE and billed, and retentionNote is set.

The volume couldn’t be deleted with the instance, most often because a snapshot of it exists. The platform keeps the volume instead of deleting your snapshot.

• Delete the volume’s snapshots, then the volume. See Delete a volume.

Creating a volume from a snapshot, creating an image, or launching from an image fails with snapshot is not available or snapshot is not protected.

A clone source must report status: COMPLETED and protectionStatus: PROTECTED.

• Wait for a PENDING snapshot to reach COMPLETED.
• Protect the snapshot, or protect it again if protectionStatus is FAILED. See Create and protect a snapshot.

If the error says the size must be greater or equal than used snapshot size, ask for at least the snapshot’s volumeSizeInGib.

delete-snapshot fails with snapshot must be unprotected before it can be deleted.

The snapshot is PROTECTED, in a protection change, or its protectionStatus is FAILED.

• Unprotect the snapshot and wait for UNPROTECTED. See Delete a snapshot.
• Delete it again.

An imported volume reports ERROR with statusReason the operation failed (ERR_IMPORT_IMAGE_TOO_LARGE) or the operation failed (ERR_IMPORT).

ERR_IMPORT_IMAGE_TOO_LARGE means the image’s virtual size is larger than sizeInGib. ERR_IMPORT means the download, conversion, or write failed: the source returned an HTTP error, sent nothing for 60 seconds, or the import took longer than 25 minutes.

• Delete the failed volume.
• Import again with sizeInGib at least the image’s virtual size, or from a faster or reachable source. See Import a disk image as a volume.

create-volume or import-volume fails with PRODUCT_UNAVAILABLE and a message such as storage class 'st1' is not available - use one of: gp1.

The storage class is published but can’t be selected.

• Use a class whose available is true, or omit the class to get gp1. See Storage classes.

Creating, importing, or resizing a volume, or creating a snapshot, fails with PAYMENT_METHOD_REQUIRED.

The project’s billing account can’t pay. For card-managed billing, no verified payment method is on file. Nothing was created or changed.

• Add a payment method. See Add a payment method.
• Retry the request.

A create, import, resize, or snapshot request fails with a message such as organisation quota exceeded: volume storage (GiB) usage is <n>, requesting <m> more would exceed the limit of <limit>.

The request would take your organization or project over its volume storage or snapshot quota. Volumes in CREATING, DELETING, and ERROR count too.

• Delete volumes or snapshots you no longer need, including ones in ERROR.
• Retry the request, or ask for a higher limit. See Limits.

A create, import, resize, or snapshot request fails with organisation is <status>, not active.

Your organization hasn’t been approved yet, or is no longer active.

• Check your organization’s status. See Organization review status.