Administra programaciones de instantáneas para discos

Consola

1. En la consola de Google Cloud, ve a la página Instantáneas.

   Ir a la página de instantáneas

2. Selecciona la pestaña Programación de instantáneas.
3. Usa el campo filter_list Filtro para reducir la lista de programaciones de instantáneas.
4. 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.

Console

1. En la consola de Google Cloud, ve a la página Instantáneas.

   Ir a la página de instantáneas

2. Selecciona la pestaña Programación de instantáneas.
3. Usa el campo filter_list 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

Console

1. En la consola de Google Cloud, ve a la página Instantáneas.

   Ir a la página de instantáneas

2. Elige Programación de instantáneas para ver una lista de tus programaciones.
3. Haz clic en el nombre de la programación de instantáneas que deseas modificar.
4. En la página de detalles de la programación de instantáneas, haz clic en el botón edit 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.

  • --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.

Console

1. En la consola de Google Cloud, ve a la página Discos.

   Ir a la página Discos

2. Elige el disco que tiene la programación que quieres desvincular.
3. En la página Administrar disco, haz clic en editEditar. Es posible que primero debas hacer clic en el menú more_vertMás acciones.
4. Abre el menú desplegable Programación de instantáneas.
5. Haz clic en Sin programación para desconectar la programación del disco.
6. Puedes crear una programación nueva o cambiar la programación mientras editas las opciones del disco.
7. Haz clic en Guardar para completar la tarea.

gcloud

1. 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

2. 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

1. 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

2. 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

Consola

1. En la consola de Google Cloud, ve a la página Instantáneas.

   Ir a la página de instantáneas

2. Elige Programación de instantáneas para ver una lista de tus programaciones.
3. Elige cualquier programación no asociada a un disco.

4. Haz clic en delete Borrar.

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.

Console

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

   Ir a la página Explorador de registros

2. En la lista desplegable Recurso auditado, elige Disco y, luego, All disk_id.

3. En la lista desplegable Todos los registros, elige cloudaudit.googleapis.com/system_event y haz clic en Aceptar.

4. En la lista desplegable Cualquier nivel de registro (Any log level), elige el tipo de registro.