Snapshots
Una instantánea es una copia de un punto en el tiempo de un volumen:- Console
- API
- CLI
- Go
Vaya a Storage → Snapshots y elija Create Snapshot, luego elija el Volume y déle un Name. La página del propio volumen tiene un botón Create
Snapshot que abre el mismo formulario con ese volumen ya seleccionado; está deshabilitado a menos que el volumen esté
available o in_use.1
Tómalo
Permitido contra un volumen en
available o in_use — no tiene que desconectar a snapshot. La instantánea se crea de forma asincrónica (202, estado creating).2
Esperar por disponibilidad
Consulta
GET /v1/snapshots/{snapshot_id}. available significa que la instantánea está completa y se puede restaurar; error significa un error de error activo — lea faults.name devuelven un error de validación, incluyendo valores sin cambios, vacíos o null. Las instantáneas existentes conservan sus nombres actuales.
Un nombre de instantánea es único por volumen, por lo que nightly en dos volúmenes diferentes está bien. size_gb es el tamaño del volumen congelado en el momento en que se tomó la instantánea — el volumen puede haberse extendido desde entonces, así que no lo lea como el tamaño actual del volumen, y no lo lea como el espacio que ocupa la instantánea.
Restauración desde una instantánea
Restaurar significa crear un nuevo volumen a partir de la instantánea. No hay reversión in situ:- Console
- API
- CLI
- Go
En Create Volume, cambie Source a From snapshot y elija la Snapshot. Size (GB) debe ser al menos el tamaño de la instantánea, y el Tier es el que usted elija: una restauración no está vinculada al nivel en el que estaba el volumen de origen.Storage → Snapshots también tiene una acción de fila Create volume from snapshot que abre el mismo formulario con la instantánea rellenada.
available, y size_gb debe ser al menos el tamaño congelado de la instantánea — puede restaurar a un volumen más grande, nunca a uno más pequeño. El volumen restaurado registra source_snapshot_id, que es también lo que detiene la retención de cosechar una instantánea de la que algo todavía depende.
Políticas de snapshots
Una política es un programa adjunto a un volumen: tomar una instantánea cadainterval_minutes, luego mantener como máximo retention_count de las instantáneas que creó la política.
- Console
- API
- CLI
- Go
Abra la pestaña Snapshot schedules del volumen y elija Create schedule. Rellene Name, Every (minutes), Keep y opcionalmente Also delete after (days), luego elija Create schedule.Cada fila tiene acciones para editar, pausar o reanudar, y eliminar esa programación. Al editar se abre su configuración; Save aplica los cambios.
up to 16 policies per volume
requerido
Cada directiva tiene su propio intervalo, configuración de retención y estado habilitado. Los nombres deben ser únicos en toda la cuenta. Las programaciones superpuestas crean instantáneas separadas, cada una de las cuales cuenta para su cuota y cargos de instantáneas. Una decimoséptima política devuelve
409.1–43200
requerido
Un gap mínimo, no una cadencia exacta. Una instantánea aterriza en o después del intervalo y nunca antes, y puede aterrizar un minuto o dos tarde cuando el pase de programación está ocupado. El mínimo es de un minuto porque es la frecuencia con la que el pase evalúa los horarios; el máximo es de 30 días.
1–256
requerido
Cuántas instantáneas de esta política se deben conservar. Cuando una carrera lleva el conteo más allá de esto, el más antiguo va primero.
0–3650, default 0
Un límite de edad opcional aplicado encima del recuento: se obtiene una instantánea fuera de cualquiera de las ventanas.
0 significa que no hay edad limitada.La primera instantánea aterriza un intervalo de ahora. Adjuntar un programa no es en sí mismo una solicitud de instantánea — use
POST /v1/snapshots si desea una inmediatamente.name; si lo proporciona, incluso sin cambiar, vacío o null, devuelve un error de validación. Aún puede cambiar el intervalo, la configuración de retención, la descripción, las etiquetas y el estado habilitado. Las directivas existentes conservan sus nombres actuales.
Las instantáneas programadas se llaman <policy>-<UTC timestamp>, por ejemplo nightly-20260115T000000Z, y heredan las etiquetas de la política para que una lista le indique qué programa las produjo sin una segunda búsqueda.
Qué retención nunca se eliminará
Un programa también es un borrador automático, por lo que los límites de lo que puede eliminar importan más que los límites de lo que mantiene:Instantáneas que tomaste a mano
La retención solo coincide con las instantáneas que llevan el
snapshot_policy_id de esta política. Una instantánea creada por una persona no tiene ninguna y nunca es una candidata, independientemente de las etiquetas que tenga.Instantáneas de algo que depende
Una instantánea de la que se creó un volumen, incluida una restauración que todavía está en ejecución, se omite y se vuelve a examinar en una ejecución posterior. Se vuelve cosechable una vez que el volumen dependiente ha desaparecido.
La única instantánea más reciente
La instantánea más reciente está exenta del límite de edad. Un volumen que no se pudo capturar por más tiempo que la ventana nunca pierde todo su historial de esa manera.
Cualquier cosa, mientras está en pausa
enabled: false detiene las nuevas ejecuciones de instantáneas y las eliminaciones de retención de ser reclamadas. El trabajo ya reclamado antes de que la pausa pueda terminar. Otras políticas del mismo volumen se siguen ejecutando de forma independiente.Lectura del estado de una programación
GET /v1/snapshot-policies/{policy_id} devuelve donde la política está en su ciclo:
faults es el campo para comprobar en una programación que ha dejado de producir instantáneas — lleva razones como una cuota de snapshots agotada, o un volumen que estaba a mitad de extensión cuando la ventana apareció. El envío, la ejecución y la retención tienen su propio código y se recuperan de forma independiente.
La tabla Snapshot schedules muestra la ejecución siguiente y la última de cada política y cualquier error activo, de modo que se puede leer una programación detenida sin salir de la consola.
Una ventana perdida cuesta una instantánea, no una por ventana perdida.
next_run_at se vuelve a marcar como now + interval_minutes cada vez que se dispara la política, nunca como previous + interval, por lo que una programación que no se pudo ejecutar durante seis horas toma una sola instantánea cuando se reanuda en lugar de una ráfaga de recuperación. Cambiar interval_minutes re-bases la siguiente ejecución ahora también, por lo que acortar un horario diario a cada hora tiene efecto dentro de la hora.Referencias de recursos
Usevolume con un UUID, CRN o nombre exacto de volumen de propiedad de la cuenta al crear una instantánea o una directiva. Los CRN de instantáneas incluyen su elemento principal, por ejemplo, crn:storage:sa-saopaulo-1:my-account:volume/data/snapshot/nightly.
Los filtros de lista utilizan coincidencias exactas de name y crn. Un filtro name de instantánea requiere volume; snapshot_policy acepta un UUID de política, CRN o nombre de ámbito de cuenta. Las solicitudes de restauración usan source_snapshot con un UUID o CRN anidado, ya que no fijan un volumen de origen. Los CRN mal formados devuelven 400; los CRN válidos fuera de la cuenta, región o tipo de recurso solicitado devuelven una página vacía.
