Crea una copia de seguridad de los datos y restablecelos con una instantánea

En esta página, se describe cómo usar una instantánea para crear una copia de seguridad de los datos de tu instancia de Gemini Enterprise Agent Platform Workbench y restablecerlos.

Crea una copia de seguridad de los datos

Para crear una copia de seguridad de los datos en una instancia de Agent Platform Workbench, puedes tomar una instantánea del disco de datos de la máquina virtual (VM) subyacente de Compute Engine.

Puedes crear una instantánea del disco de datos de tu instancia con la Cloud de Confiance consola, Google Cloud CLI o la API de REST:

Console

  1. En la consola de Cloud de Confiance , ve a la página Instancias.

    Ir a Instancias

  2. Haga clic en el nombre de la instancia.

  3. En la página Detalles de la instancia, haz clic en Ver en Compute Engine para abrir Detalles de la VM.

  4. En la sección Discos adicionales, haz clic en el nombre del disco de datos. El nombre del disco de datos tiene el siguiente formato: INSTANCE_NAME-data-workspace.

  5. Haz clic en Crear instantánea.

  6. En el cuadro de diálogo Crear una instantánea, haz clic en Crear.

Compute Engine crea una instantánea del disco de datos.

gcloud

Para crear una instantánea del disco de datos de tu instancia, usa el comando gcloud compute snapshots create.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • SNAPSHOT_NAME: Es un nombre para tu instantánea.
  • SOURCE_ZONE: La zona en la que se encuentra la instancia.
  • INSTANCE_NAME: el nombre de tu instancia
  • STORAGE_LOCATION: la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud compute snapshots create SNAPSHOT_NAME \
    --source-disk-zone=SOURCE_ZONE \
    --source-disk=INSTANCE_NAME-data-workspace \
    --storage-location=STORAGE_LOCATION

Windows (PowerShell)

gcloud compute snapshots create SNAPSHOT_NAME `
    --source-disk-zone=SOURCE_ZONE `
    --source-disk=INSTANCE_NAME-data-workspace `
    --storage-location=STORAGE_LOCATION

Windows (cmd.exe)

gcloud compute snapshots create SNAPSHOT_NAME ^
    --source-disk-zone=SOURCE_ZONE ^
    --source-disk=INSTANCE_NAME-data-workspace ^
    --storage-location=STORAGE_LOCATION

REST

Para crear una instantánea del disco de datos de tu instancia, realiza una solicitud POST al método snapshots.insert de Compute Engine.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • DESTINATION_PROJECT_ID: Es el ID del proyecto en el que deseas crear la instantánea.
  • SNAPSHOT_NAME: Es un nombre para tu instantánea.
  • SOURCE_PROJECT_ID: Es el ID del proyecto en el que se encuentra tu instancia.
  • SOURCE_ZONE: La zona en la que se encuentra la instancia.
  • INSTANCE_NAME: el nombre de tu instancia
  • STORAGE_LOCATION: la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.

Método HTTP y URL: 

POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots

Cuerpo JSON de la solicitud:

{
  "name": "SNAPSHOT_NAME",
  "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/INSTANCE_NAME-data-workspace",
  "storageLocations": [
      "STORAGE_LOCATION"
  ],
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots" | Select-Object -Expand Content

Programar copia de seguridad

Se pueden configurar uno o más programas de copias de seguridad para una instancia de la estación de trabajo adjuntando políticas de recursos al disco de datos. Puedes adjuntar varias políticas de recursos para tener varias programaciones de copias de seguridad activas al mismo tiempo.

Puedes crear una instancia con programaciones de instantáneas adjuntas con Google Cloud CLI o la API de REST:

gcloud

Para crear una instancia con una programación de instantáneas, usa el comando gcloud workbench instances create y especifica tus políticas de recursos con la marca --data-disk-resource-policies.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • INSTANCE_NAME: El nombre de tu instancia de Agent Platform Workbench. Debe comenzar con una letra seguida de un máximo de 62 letras minúsculas, números o guiones (-) y no puede terminar con un guion.
  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la zona en la que deseas que se ubique la instancia.
  • MACHINE_TYPE: El tipo de máquina de la VM de tu instancia, por ejemplo: n2d-standard-2
  • REGION: Es la región en la que se encuentra la política de recursos.
  • RESOURCE_POLICY: Es la política de recursos que se aplicará al disco de datos.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --machine-type=MACHINE_TYPE \
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

Windows (PowerShell)

gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --machine-type=MACHINE_TYPE `
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

Windows (cmd.exe)

gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --machine-type=MACHINE_TYPE ^
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

REST

Para crear una instancia con un programa de instantáneas, usa el método projects.locations.instances.create y configura resourcePolicies en tu DataDisk.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la zona en la que deseas que se ubique la instancia.
  • MACHINE_TYPE: El tipo de máquina de la VM de tu instancia, por ejemplo: n2d-standard-2
  • REGION: Es la región en la que se encuentra la política de recursos.
  • RESOURCE_POLICY: Es la política de recursos que se aplicará al disco de datos.

Método HTTP y URL: 

POST https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances

Cuerpo JSON de la solicitud:

{
  "gce_setup": {
    "machine_type": "MACHINE_TYPE",
    "data_disks": [
      {
        "resource_policies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY"
        ]
      }
    ]
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances" | Select-Object -Expand Content

Actualiza las programaciones de copias de seguridad

Puedes agregar, reemplazar o actualizar los programas de copias de seguridad en una instancia existente con Google Cloud CLI o la API de REST. Para establecer varios programas, incluye varias políticas de recursos en la lista resourcePolicies:

gcloud

Para actualizar los programas de copias de seguridad en una instancia existente, usa el comando gcloud workbench instances update y especifica tus políticas de recursos con la marca --data-disk-resource-policies. La lista proporcionada de políticas de recursos reemplaza por completo la lista existente.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • INSTANCE_NAME: El nombre de tu instancia de Agent Platform Workbench
  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: La zona en la que se encuentra la instancia.
  • INSTANCE_ID: El ID de tu instancia
  • REGION: Es la región en la que se encuentra la política de recursos.
  • RESOURCE_POLICY: Es la política de recursos que se aplicará al disco de datos.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud workbench instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

Windows (PowerShell)

gcloud workbench instances update INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

Windows (cmd.exe)

gcloud workbench instances update INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --data-disk-resource-policies=projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY

REST

Para actualizar los programas de copias de seguridad en una instancia existente, realiza una solicitud PATCH al método projects.locations.instances.patch con updateMask establecido en gceSetup.dataDisks.resourcePolicies. La lista proporcionada de políticas de recursos reemplaza por completo la lista existente.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: La zona en la que se encuentra la instancia.
  • INSTANCE_ID: El ID de tu instancia
  • REGION: Es la región en la que se encuentra la política de recursos.
  • RESOURCE_POLICY: Es la política de recursos que se aplicará al disco de datos.

Método HTTP y URL: 

PATCH https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies

Cuerpo JSON de la solicitud:

{
  "gce_setup": {
    "data_disks": [
      {
        "resource_policies": [
          "projects/PROJECT_ID/regions/REGION/resourcePolicies/RESOURCE_POLICY"
        ]
      }
    ]
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies" | Select-Object -Expand Content

Cómo quitar todas las programaciones de copias de seguridad

Puedes quitar todos los programas de copias de seguridad de una instancia existente configurando las políticas de recursos en una lista vacía con Google Cloud CLI o la API de REST:

gcloud

Para quitar todas las programaciones de copias de seguridad de una instancia existente, usa el comando gcloud workbench instances update y pasa un valor vacío para la marca --data-disk-resource-policies. Se quitarán todas las programaciones activas de la instancia.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • INSTANCE_NAME: El nombre de tu instancia de Agent Platform Workbench
  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: La zona en la que se encuentra la instancia.
  • INSTANCE_ID: El ID de tu instancia

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud workbench instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --data-disk-resource-policies=

Windows (PowerShell)

gcloud workbench instances update INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --data-disk-resource-policies=

Windows (cmd.exe)

gcloud workbench instances update INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --data-disk-resource-policies=

REST

Para quitar todos los programas de copias de seguridad de una instancia existente, realiza una solicitud PATCH al método projects.locations.instances.patch con updateMask establecido en gceSetup.dataDisks.resourcePolicies y una lista resourcePolicies vacía. Esto quitará todos los programas activos de la instancia.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: La zona en la que se encuentra la instancia.
  • INSTANCE_ID: El ID de tu instancia

Método HTTP y URL: 

PATCH https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies

Cuerpo JSON de la solicitud:

{
  "gce_setup": {
    "data_disks": [
      {
        "resource_policies": []
      }
    ]
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=gceSetup.dataDisks.resourcePolicies" | Select-Object -Expand Content

Restablece datos a partir de una instantánea

Puedes restablecer datos en una instancia con una instantánea. Cuando restableces datos en una instancia, Agent Platform Workbench borra el disco de datos existente que está conectado a la instancia, crea un disco de datos nuevo basado en la instantánea y lo conecta a la instancia.

Puedes restablecer datos en una instancia con gcloud CLI o la API de REST:

gcloud

Para restablecer datos en una instancia, usa el comando gcloud workbench instances restore.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • INSTANCE_NAME: el nombre de tu instancia
  • LOCATION: La zona en la que se encuentra la instancia.
  • SNAPSHOT_PROJECT_NAME: Es el nombre del proyecto en el que se encuentra la instantánea.
  • SNAPSHOT_NAME: Es el nombre de la instantánea que se restablecerá.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud workbench instances restore INSTANCE_NAME \
    --location=LOCATION \
    --snapshot-project=SNAPSHOT_PROJECT_NAME \
    --snapshot=SNAPSHOT_NAME

Windows (PowerShell)

gcloud workbench instances restore INSTANCE_NAME `
    --location=LOCATION `
    --snapshot-project=SNAPSHOT_PROJECT_NAME `
    --snapshot=SNAPSHOT_NAME

Windows (cmd.exe)

gcloud workbench instances restore INSTANCE_NAME ^
    --location=LOCATION ^
    --snapshot-project=SNAPSHOT_PROJECT_NAME ^
    --snapshot=SNAPSHOT_NAME

REST

Para restablecer datos en una instancia, haz una solicitud POST al método projects.locations.instances.restore.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: La zona en la que se encuentra la instancia.
  • INSTANCE_ID: El ID de tu instancia
  • SNAPSHOT_ID: Es el ID de la instantánea que se restablecerá. Para obtener el ID de una instantánea, usa el método snapshots.get de Compute Engine.
  • SNAPSHOT_PROJECT_ID: Es el ID del proyecto de la instantánea.

Método HTTP y URL: 

POST https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:restore

Cuerpo JSON de la solicitud:

{
  "snapshot": {
    {
      "snapshotId": SNAPSHOT_ID,
      "projectId": SNAPSHOT_PROJECT_ID
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:restore"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:restore" | Select-Object -Expand Content

¿Qué sigue?