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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
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
) -
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
-
- En Google Cloud Console, ve a la página 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.
- En Google Cloud Console, ve a la página 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.
PROJECT_ID
: nombre del proyectoREGION
: la región, por ejemplo,us-west1
PROJECT_ID
: nombre del proyectoREGION
: la región, por ejemplo,us-west1
- 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
- En Google Cloud Console, ve a la página 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.
- 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.
- 2:00 p.m. PST es
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 entre1
y23
. 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 elSTART_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.
- 2:00 p.m. PST es
Las marcas de frecuencia de la instantánea
hourly-schedule
,daily-schedule
,weekly-schedule
yweekly-schedule-from-file
son excluyentes entre sí. Solo puedes usar una para tu programación de instantáneas.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" } } }
- 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
y23
. 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
ySUNDAY
. Debes escribir los días de la semana, estos no distinguen entre mayúsculas y minúsculas. Puedes definir hasta 7 intervalos paradayOfWeeks
, 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.
- 2:00 p.m. PST es
- 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.
- En Google Cloud Console, ve 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.
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 conectadaSCHEDULE_NAME
: el nombre de la programación de instantáneas que quieres desconectar del discoREGION
: la región en la que reside la programación de instantáneasZONE
: 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áneasSCHEDULE_NAME
: el nombre de la programación de instantáneas que quieres agregar a este discoZONE
: la zona en la que reside tu disco
Para desconectar la programación de instantáneas actual de un disco, crea una solicitud
POST
adisks.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 proyectoZONE
: la zona en la que reside el discoDISK_NAME
: el nombre del disco con la programación de instantáneas asociadaREGION
: la ubicación de la programación de instantáneasSCHEDULE_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étododisks.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 proyectoZONE
: la ubicación del discoDISK_NAME
: Es el nombre del discoREGION
: la ubicación de la programación de instantáneasSCHEDULE_NAME
: el nombre de la programación de instantáneas que aplicas a este disco
- En Google Cloud Console, ve a la página 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.SCHEDULE_NAME
: el nombre de la programación de instantáneas.REGION
: la ubicación de la programación de instantáneasPROJECT_ID
: nombre del proyectoREGION
: la ubicación de la programación de instantáneasSCHEDULE_NAME
: el nombre de la programación de instantáneas.En la consola de Google Cloud, ve 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.
- 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.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.
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:
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:
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
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
aresourcePolicies.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
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:
REST
Realiza una solicitud
GET
al métodoresourcePolicies.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:
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:
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
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:
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étodoresourcePolicies
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 elname
y los campos que deseas actualizar.Reemplaza lo siguiente:
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
gcloud
REST
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
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:
REST
Para borrar una programación de instantáneas, realiza una solicitud
DELETE
al métodoresourcePolicies.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:
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
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-03 (UTC)
-