Administra programaciones de instantáneas para discos

Linux Windows

En este documento, se describe cómo administrar las programaciones de instantáneas para tu Persistent Disk zonal y regional y Google Cloud Hyperdisk.

Puedes administrar las programaciones de instantáneas de la siguiente manera:

Visualiza programaciones de instantáneas
Cambia programaciones de instantáneas
Borrar programaciones de instantáneas

También puedes configurar alertas para las instantáneas programadas.

Antes de comenzar

Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Roles y permisos requeridos

Para obtener los permisos que necesitas para crear una programación de instantáneas, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)
Para conectarte a una VM que puede ejecutarse como una cuenta de servicio: Usuario de cuenta de servicio (v1) (roles/iam.serviceAccountUser)

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

Estos roles predefinidos contienen los permisos necesarios para crear una programación de instantáneas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una programación de instantáneas:

Para ver programaciones de instantáneas: compute.resourcePolicies.list en el proyecto o la organización
Para actualizar una programación de instantáneas, haz lo siguiente:
- compute.resourcePolicies.update en la política de recursos
- compute.resourcePolicies.get en la política de recursos
Para reemplazar una programación de instantáneas, sigue estos pasos:
- compute.resourcePolicies.use en la política de recursos
- compute.disks.addResourcePolicies en el disco
- compute.disks.removeResourcePolicies en el disco
Para borrar una programación de instantáneas, haz lo siguiente:
- compute.resourcePolicies.delete en la política de recursos
- compute.disks.removeResourcePolicies en el disco

También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas

Visualiza programaciones de instantáneas

Si quieres obtener una lista de programación de instantáneas, usa la consola, el comando de gcloud o el método API de Compute Engine. Con esta solicitud, se muestran el nombre, la descripción y la región de todas las programaciones de instantáneas dentro de un proyecto.

Console

En Google Cloud Console, ve a la página Instantáneas.
Ir a la página de instantáneas
Selecciona la pestaña Programación de instantáneas.
Usa el campo Filtro para reducir la lista de programaciones de instantáneas.
Haz clic en el nombre de una programación de instantáneas para ver sus detalles.

gcloud

Si quieres ver una lista de las programaciones de instantáneas, usa el comando resource-policies list.

 gcloud compute resource-policies list

Si quieres ver la descripción de una programación de instantáneas específica, usa el comando resource-policies describe.

gcloud compute resource-policies describe SCHEDULE_NAME

Reemplaza SCHEDULE_NAME por el nombre de la programación de instantáneas.

REST

Realiza una solicitud GET a resourcePolicies.aggregatedList para mostrar una lista de las programaciones de instantáneas en un proyecto.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/resourcePolicies

Reemplaza PROJECT_ID por el nombre del proyecto.

Visualiza programaciones de instantáneas por región

Para ver las programaciones de instantáneas de un proyecto dentro de una región en particular, usa la consola de Google Cloud, gcloud CLI o REST.

Console

En Google Cloud Console, ve a la página Instantáneas.
Ir a la página de instantáneas
Selecciona la pestaña Programación de instantáneas.
Usa el campo Filtro para enumerar las programaciones de instantáneas de una región específica.

gcloud

Si quieres ver las programaciones de instantáneas de un proyecto dentro de una región específica, usa el comando resource-policies list.

gcloud compute resource-policies list PROJECT_ID --filter REGION

Reemplaza lo siguiente:

PROJECT_ID: nombre del proyecto
REGION: la región, por ejemplo, us-west1

REST

Realiza una solicitud GET al método resourcePolicies.list para recuperar las programaciones de instantáneas creadas dentro de una región.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

Reemplaza lo siguiente:

PROJECT_ID: nombre del proyecto
REGION: la región, por ejemplo, us-west1

Cambia una programación de instantáneas

Después de crear una programación de instantáneas, puedes modificar los siguientes campos de forma dinámica a través del procedimiento Actualiza una programación de instantáneas:

Descripción
Programación de instantáneas
Etiquetas aplicadas a las instantáneas generadas
Política de eliminación del disco de origen para manejar instantáneas generadas de forma automática, en caso de que se borre el disco de origen
Política de retención para definir cuánto tiempo se deben conservar las instantáneas generadas a partir de la programación de instantáneas

Si deseas actualizar otros valores para una programación de instantáneas, debes borrar la programación de instantáneas y crear una nueva, como se describe en Reemplaza una programación de instantáneas.

Las actualizaciones de programación de instantáneas entrarán en vigor en la primera instantánea después de las actualizaciones. Si se ejecuta una instantánea mientras actualizas la programación de instantáneas, los cambios se aplicarán en la siguiente instantánea.

Actualizar una programación de instantáneas

Puedes usar Google Cloud CLI o la API de Compute Engine para cambiar algunas de las propiedades de tu programación de instantáneas, como se describe en Cambia una programación de instantáneas.

Si deseas cambiar otras propiedades de tu programación de instantáneas, usa el método descrito en Reemplaza una programación de instantáneas.

Console

En Google Cloud Console, ve a la página Instantáneas.
Ir a la página de instantáneas
Elige Programación de instantáneas para ver una lista de tus programaciones.
Haz clic en el nombre de la programación de instantáneas que deseas modificar.
En la página de detalles de la programación de instantáneas, haz clic en el botón Editar programación.

gcloud

Usa el comando compute resource-policies update para actualizar la descripción, la programación, una política de retención o las etiquetas de una programación de instantáneas.

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
   --region=REGION \
   --description="DESCRIPTION" \
   --snapshot-labels="KEY=VALUE" \
   --max-retention-days=DAYS \
   --on-source-disk-delete=DELETE_OPTION \
   --start-time=START_TIME \
   SCHEDULE_FLAG

Reemplaza lo siguiente:

SCHEDULE_NAME: el nombre de la programación de instantáneas.
REGION: la región en la que reside tu programación de instantáneas.
DESCRIPTION: una descripción de la programación de instantáneas. Coloca la descripción entre comillas.
KEY y VALUE: un par clave-valor que se puede usar para agrupar recursos relacionados o asociados.
DAYS: la cantidad máxima de días de instantánea se conserva antes de que se borre.
DELETE_OPTION: Comportamiento de retención de instantáneas automáticas después de que se borra el disco original. El valor debe ser uno de los siguientes:
- apply-retention-policy: Cuando se borre el disco de origen, continúa aplicando la ventana de retención para cualquier instantánea creada por la programación de instantáneas.
- keep-auto-snapshots: (Predeterminado) Si se borra el disco de origen, conserva las instantáneas creadas por la programación de instantáneas, sin importar el período de retención.
START_TIME: la hora de inicio en UTC. La hora debe ser en punto. Por ejemplo:
- 2:00 p.m. PST es 22:00.
- Si estableces la hora de inicio a las 22:13, recibirás un error.
SCHEDULE_FLAG: una de las marcas siguientes:
- --hourly-schedule=HOURLY_INTERVAL: la cantidad de horas entre cada instantánea. HOURLY_INTERVAL debe ser un número entero entre 1 y 23. Por ejemplo, si estableces --hourly-schedule en 12, la instantánea se generará cada 12 horas.
- --daily-schedule: hace una instantánea al día, en el START_TIME
- --weekly-schedule=WEEKLY_INTERVAL: define el día en el que deseas que ocurra la instantánea. Debes escribir el día de la semana. Los valores no distinguen mayúsculas de minúsculas.
  
  Nota: Si quieres especificar una programación semanal con diferentes días de la semana y con diferentes horas de inicio, usa la marca --weekly-schedule-from-file en lugar de la marca --weekly-schedule.
- --weekly-schedule-from-file=FILE_NAME: especifica un archivo que contiene la programación de instantáneas semanal. Puedes especificar programaciones semanales en diferentes días de la semana y diferentes horas con un archivo. Por ejemplo, tu archivo podría especificar una programación de instantáneas el lunes y el miércoles: none [{"day": "MONDAY", "startTime": "04:00"}, {"day": "WEDNESDAY", "startTime": "02:00"}]. Si incluyes una hora de inicio en el archivo, no necesitas establecer la marca --start-time. La programación usa el estándar de hora UTC. La hora debe ser en punto. Por ejemplo:
  - 2:00 p.m. PST es 22:00.
  - Si estableces la hora de inicio a las 22:13, recibirás un error.
Las marcas de frecuencia de la instantánea hourly-schedule, daily-schedule, weekly-schedule y weekly-schedule-from-file son excluyentes entre sí. Solo puedes usar una para tu programación de instantáneas.

Ejemplos:

Para cambiar una programación de instantáneas a una programación diaria, sigue estos pasos:

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --daily-schedule --start-time=START_TIME

Para cambiar una instantánea a una programación por hora y, también, actualizar la descripción y la etiqueta de la instantánea, haz lo siguiente:

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --description="DESCRIPTION" \
    --hourly-schedule=HOURLY_INTERVAL --start-time=START_TIME \
    --snapshot-labels="KEY=VALUE"

Si deseas cambiar las políticas de retención de instantáneas y eliminación de discos de origen para una programación de instantáneas, haz lo siguiente:

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --max-retention-days=DAYS \
    --on-source-disk-delete=DELETE_OPTION

REST

Crea una solicitud PATCH al método resourcePolicies para actualizar la descripción, el programa, la política de retención, la política de eliminación del disco de origen o las etiquetas de una programación de instantáneas. En el cuerpo de la solicitud, solo necesitas especificar el name y los campos que deseas actualizar.

Cambia la descripción y la etiqueta:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
{
    "name": "SCHEDULE_NAME",
    "description": "DESCRIPTION",
    "snapshotProperties": {
        "labels": {"KEY": "VALUE"}
    }
}

Cambia la programación de instantáneas a por hora:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
{
    "name": "SCHEDULE_NAME",
    "snapshotSchedulePolicy": {
        "schedule": {
          "hourlySchedule": {
              "hoursInCycle": HOURLY_INTERVAL,
              "startTime": START_TIME
           }
        }
    }
}

Cambia la programación de instantáneas a todos los días:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
{
    "name": "SCHEDULE_NAME",
    "snapshotSchedulePolicy": {
        "schedule": {
          "dailySchedule": {
              "daysInCycle": DAILY_INTERVAL,
              "startTime": START_TIME
           }
        }
    }
}

Cambia la programación de instantáneas a todas las semanas:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
{
    "name": "SCHEDULE_NAME",
    "snapshotSchedulePolicy": {
        "schedule": {
           "weeklySchedule": {
              "dayOfWeeks": [
                 {
                    "day": WEEKLY_INTERVAL,
                    "startTime": START_TIME
                 }
              ]
           }
        }
    }
}

Cambia la política de retención de instantáneas:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
{
    "name": "SCHEDULE_NAME",
    "snapshotSchedulePolicy": {
        "retentionPolicy": {
            "maxRetentionDays": DAYS,
            "onSourceDiskDelete":"DELETE_OPTION"
        }
   }
}

Reemplaza lo siguiente:

PROJECT_ID: Nombre del proyecto.
REGION: la región en la que se encuentra la programación de instantáneas.
SCHEDULE_NAME: el nombre de la programación de instantáneas.
DESCRIPTION: una descripción de la programación de instantáneas. Coloca la descripción entre comillas.
KEY y VALUE: un par clave-valor que se puede usar para agrupar recursos relacionados o asociados.
HOURLY_INTERVAL: define el intervalo en el que quieres que ocurra la captura de instantáneas. Establece la programación por hora con un número entero entre 1 y 23. Para que las instantáneas se creen a la misma hora todos los días, elige un número que se divida de manera equitativa en 24 (1, 2, 3, 4, 6, 8 o 12). Por ejemplo, si estableces --hourly-schedule en 12, la instantánea se generará cada 12 horas.
DAILY_INTERVAL: define la cantidad de días entre cada instantánea. Para crear una instantánea todos los días, usa el valor 1.
WEEKLY_INTERVAL: Define una programación que se ejecute en días específicos de la semana. Especifica uno o más días. Las siguientes opciones están disponibles: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY y SUNDAY. Debes escribir los días de la semana, estos no distinguen entre mayúsculas y minúsculas. Puedes definir hasta 7 intervalos para dayOfWeeks, uno para cada día de la semana.
START_TIME: la hora de inicio en UTC. La hora debe ser en punto. Por ejemplo:
- 2:00 p.m. PST es 22:00 UTC.
- Si estableces la hora de inicio a las 22:13, recibirás un error.
DAYS: la cantidad máxima de días de instantánea se conserva antes de que se borre.
DELETE_OPTION: Comportamiento de retención de instantáneas automáticas después de que se borra el disco original. El valor debe ser uno de los siguientes:
- APPLY_RETENTION_POLICY: Cuando se borre el disco de origen, continúa aplicando la ventana de retención para cualquier instantánea creada por la programación de instantáneas.
- KEEP_AUTO_SNAPSHOTS: (Predeterminado) Si se borra el disco de origen, conserva las instantáneas creadas por la programación de instantáneas, sin importar el período de retención.

Reemplaza una programación de instantáneas

Sigue estos pasos para borrar la programación de instantáneas y crear una nueva. Usa este método para modificar las propiedades de programación de instantáneas que no se pueden cambiar a través del procedimiento actualiza una programación de instantáneas.

Si reemplazas una programación de instantáneas que ya está conectada a un disco, primero debes desconectar la programación del disco y borrarla. Luego, puedes crear una programación nueva y conectarla al disco.

La política nueva no administrará las instantáneas que se generan a partir de la programación de instantáneas separadas. Esas instantáneas se conservarán de manera indefinida hasta que las borres.

Usa la consola de Google Cloud, gcloud CLI o REST para quitar y reemplazar la programación de instantáneas.

Console

En Google Cloud Console, ve a la página Discos.
Ir a la página Discos
Elige el disco que tiene la programación que quieres desvincular.
En la página Administrar disco, haz clic en Editar. Es posible que primero debas hacer clic en el menú Más acciones.
Abre el menú desplegable Programación de instantáneas.
Haz clic en Sin programación para desconectar la programación del disco.
Puedes crear una programación nueva o cambiar la programación mientras editas las opciones del disco.
Haz clic en Guardar para completar la tarea.

gcloud

Usa el comando gcloud disks remove-resource-policies para desconectar la programación de instantáneas del disco con la programación que quieres cambiar.
```
gcloud compute disks remove-resource-policies DISK_NAME \
    --resource-policies SCHEDULE_NAME \
    --region REGION \
    --zone ZONE
```
Reemplaza lo siguiente:
- DISK_NAME: el nombre del disco con la programación de instantáneas conectada
- SCHEDULE_NAME: el nombre de la programación de instantáneas que quieres desconectar del disco
- REGION: la región en la que reside la programación de instantáneas
- ZONE: la zona donde reside tu disco zonal
Usa el comando gcloud disks add-resource-policies para agregar la programación de instantáneas nueva al disco.
```
gcloud compute disks add-resource-policies DISK_NAME \
     --resource-policies SCHEDULE_NAME \
     --zone ZONE
```
Reemplaza lo siguiente:
- DISK_NAME: el nombre del disco con la política de recursos de la programación de instantáneas
- SCHEDULE_NAME: el nombre de la programación de instantáneas que quieres agregar a este disco
- ZONE: la zona en la que reside tu disco

REST

Para desconectar la programación de instantáneas actual de un disco, crea una solicitud POST a disks.removeResourcePolicies.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/removeResourcePolicies

{
  "resourcePolicies": [
     "regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}
```
Reemplaza lo siguiente:
- PROJECT_ID: nombre del proyecto
- ZONE: la zona en la que reside el disco
- DISK_NAME: el nombre del disco con la programación de instantáneas asociada
- REGION: la ubicación de la programación de instantáneas
- SCHEDULE_NAME: el nombre de la programación de instantáneas que quitas de este disco
Para adjuntar la programación de instantáneas nueva al disco, crea una solicitud POST para el método disks.addResourcePolicies.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/addResourcePolicies

{
  "resourcePolicies": [
    "regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}
```
Reemplaza lo siguiente:
- PROJECT_ID: nombre del proyecto
- ZONE: la ubicación del disco
- DISK_NAME: Es el nombre del disco
- REGION: la ubicación de la programación de instantáneas
- SCHEDULE_NAME: el nombre de la programación de instantáneas que aplicas a este disco

Borrar una programación de instantáneas

Si borras una programación de instantáneas, todas las instantáneas generadas de forma automática que estaban asociadas a esta programación se conservan de forma permanente. Sin embargo, una vez que se borra la programación, ya no se generarán instantáneas.

Tu política de retención es parte de la programación de instantáneas. Una vez que se borra la programación, tu política de retención ya no se aplica. Las instantáneas generadas se conservan de forma permanente hasta que las borres de forma manual.

Para borrar una programación de instantáneas existente, usa la consola de Google Cloud, Google Cloud CLI o el método de la API de Compute Engine. Si la programación ya está adjunta a un disco, primero deberás desvincular la programación del disco y, luego, borrar la programación. No puedes borrar una programación de instantáneas adjunta a un disco.

Console

En Google Cloud Console, ve a la página Instantáneas.
Ir a la página de instantáneas
Elige Programación de instantáneas para ver una lista de tus programaciones.
Elige cualquier programación no asociada a un disco.
Haz clic en Borrar.
Nota: Si la programación ya está asociada al disco, primero debes desvincularla del disco y, luego, podrás borrarla.

gcloud

Para borrar una programación de instantáneas, usa el comando resource-policies delete.

gcloud compute resource-policies delete SCHEDULE_NAME \
    --region REGION

Reemplaza lo siguiente:

SCHEDULE_NAME: el nombre de la programación de instantáneas.
REGION: la ubicación de la programación de instantáneas

REST

Para borrar una programación de instantáneas, realiza una solicitud DELETE al método resourcePolicies.delete. Si la programación de instantáneas ya está conectada a un disco, recibirás un error.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME

Reemplaza lo siguiente:

PROJECT_ID: nombre del proyecto
REGION: la ubicación de la programación de instantáneas
SCHEDULE_NAME: el nombre de la programación de instantáneas.

Registro y supervisión

Cada instantánea programada asociada a un disco crea de manera continua un evento del sistema, que se supervisa y registra en todo momento. Los registros de auditoría de eventos del sistema siempre están habilitados.

Estos registros proporcionan información del comportamiento sobre las instantáneas programadas para cada disco asociado. Puedes ver tus registros desde el menú de Logging en la consola de Google Cloud.

Para obtener más información sobre el uso del Explorador de registros, consulta Visualiza registros con el Explorador de registros.

Console

En la consola de Google Cloud, ve a la página Explorador de registros.

Ir a la página Explorador de registros
En la lista desplegable Recurso auditado, elige Disco y, luego, All disk_id.
En la lista desplegable Todos los registros, elige cloudaudit.googleapis.com/system_event y haz clic en Aceptar.
En la lista desplegable Cualquier nivel de registro (Any log level), elige el tipo de registro.

¿Qué sigue?

Obtén más información sobre las frecuencias de programación de instantáneas, las políticas de retención y las reglas de nombres en Información sobre las programaciones de instantáneas para discos.
Visualiza y borra las instantáneas generadas, como se describe en Administra instantáneas de disco.
Obtén más información acerca de cómo ver registros.