RErender
Disks

Restore snapshot

Changed on

Restore a persistent disk to an available snapshot.

This operation is irreversible. It will overwrite the current disk data. It might also trigger a service deploy.

Snapshot keys returned from the List snapshots endpoint expire after 24 hours. If a snapshot key has expired, query the endpoint again for a new key.

post/disks/{diskId}/snapshots/restore

Request

  • Base URL
    https://api.render.com/v1
  • Auth
    HTTP bearer

Request body

snapshotKeystring required
instanceIdstring

When a service with a disk is scaled, the instanceId is used to identify the instance that the disk is attached to. Each instance's disks get their own snapshots, and can be restored separately.

Response

Restored

Schema required(unresolved $ref)

Changes

  • 6ac5d3d47362Revision changes
    • breaking

      the response's property type changed from no type to string for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response's property pattern ^dsk-[0-9a-z]{20}$ was added for the status