Establece la ubicación de almacenamiento predeterminada con la configuración de instantáneas

Cuando creas instantáneas, Google Cloud usa los valores predeterminados para las opciones de configuración, a menos que proporciones valores de manera explícita. La configuración de instantáneas es un parámetro de configuración centralizado a nivel de proyecto que te permite personalizar la ubicación predeterminada en la que Google Cloud almacena las instantáneas. La configuración de instantáneas para definir tu propio valor predeterminado elimina la necesidad de especificar una ubicación de forma manual durante cada creación de instantáneas.

En este documento, se proporciona información sobre la configuración de las instantáneas y cómo usarlas para personalizar la ubicación de almacenamiento predeterminada de las instantáneas de tu proyecto.

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 un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:
gcloud
1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
```
gcloud init
```
  Nota: Si ya instalaste la CLI de gcloud, asegúrate de que tienes la versión más reciente mediante la ejecución de gcloud components update.
2. Configura una región y una zona predeterminadas.
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.

Limitaciones

Solo puedes ver y actualizar la configuración de la instantánea a través de gcloud CLI o REST.
No se puede personalizar la ubicación de almacenamiento predeterminada de las Instant Snapshots. Solo puedes hacerlo para las instantáneas estándar y de archivo.
La modificación de la política de ubicación en la configuración de instantáneas de tu proyecto solo afecta a las instantáneas que se crean después de esa modificación. La actualización de la configuración de instantáneas de tu proyecto no cambia la ubicación de ninguna instantánea existente.
Si especificas una ubicación de forma manual durante la creación de la instantánea, Google Cloud anulará la configuración de la instantánea y creará la instantánea en esa ubicación recién especificada. Sin embargo, la política de ubicación de almacenamiento en la configuración de instantáneas no se modifica.

Cómo funciona la configuración de instantáneas

La política de ubicación de almacenamiento de la configuración de instantáneas de un proyecto define dónde Google Cloud almacena las instantáneas de ese proyecto de forma automática. Google Cloud mantiene un valor predefinido para esta política de ubicación de almacenamiento hasta que actualices la configuración de la instantánea y configures un valor predeterminado nuevo. Después de actualizar la configuración de la instantánea y establecer una ubicación de almacenamiento predeterminada nueva, Google Cloud usará esta ubicación para almacenar todas las instantáneas nuevas creadas en ese proyecto.

Puedes actualizar la configuración de la instantánea para modificar la política de ubicación de almacenamiento cualquier cantidad de veces. Sin embargo, modificar la configuración de las instantáneas de tu proyecto solo afecta las ubicaciones de las instantáneas que se crean después de esa modificación. La actualización de la configuración de instantáneas de tu proyecto no cambia la ubicación de ninguna instantánea existente.

Para asegurarte de que Google Cloud use la ubicación de almacenamiento definida en la configuración de la instantánea, no especifiques una ubicación de forma manual durante la creación de la instantánea. Si especificas una ubicación de forma manual durante la creación de la instantánea, Google Cloud anulará la configuración de la instantánea y creará la instantánea en esa ubicación recién especificada. Sin embargo, la política de ubicación de almacenamiento en la configuración de instantáneas no se modifica.

Puedes usar la configuración de instantáneas para personalizar la ubicación de almacenamiento predeterminada de las instantáneas estándar y de archivo. No se puede personalizar la ubicación de almacenamiento predeterminada de las Instant Snapshots.

Opciones de ubicación de almacenamiento

Cuando estableces la configuración de instantáneas de tu proyecto y especificas una ubicación de almacenamiento predeterminada nueva, puedes elegir regiones específicas o usar la configuración de ubicación basada en discos. Más específicamente, puedes elegir una de las siguientes opciones de ubicación para tu política de ubicación de almacenamiento:

La multirregión más cercana al disco de origen
La misma región local que el disco de origen
Regiones específicas que elijas

Política de ubicación de almacenamiento predefinida de Google Cloud

Hasta que actualices la configuración de la instantánea por primera vez, Google Cloud mantiene un valor predefinido para la política de ubicación de almacenamiento. Esta política predefinida proporciona la ubicación de almacenamiento predetermactualices para las instantáneas hasta que configures tu propia ubicación de almacenamiento de instantáneas de tu proyecto a fin de configurar tu propia ubicación de almacenamiento predeterminada. La política de ubicación de almacenamiento predefinida se establece en la multirregión más cercana a nivel geográfico de la ubicación del disco de origen.

Si el disco de origen está en una ubicación que forma parte de una multirregión, la política de ubicación de almacenamiento de configuración de instantáneas se establece en esa multirregión. Por ejemplo, si tu disco se encuentra en una ubicación como us-central1, la ubicación de almacenamiento predeterminada es la multirregión us.
En el caso de una ubicación que está fuera de una multirregión, la ubicación de almacenamiento predeterminada es la multirregión más cercana fuera de esa región. Para una ubicación como australia-southeast1, la ubicación predeterminada se convierte en la multirregión asia.

Implicaciones de precios

No es necesario que pagues ningún importe adicional para usar la configuración de instantáneas en tus proyectos. Sin embargo, los valores de ubicación que especificas con la configuración de instantáneas afectan a otras operaciones, lo que, a su vez, puede afectar esos costos operativos.

Configura la ubicación de almacenamiento predeterminada de un proyecto con la configuración de instantáneas

Puedes actualizar la configuración de las instantáneas de tu proyecto y establecer una ubicación de almacenamiento predeterminada nueva con REST y gcloud CLI.

Si no estableces una política de ubicación de almacenamiento en tu configuración de instantáneas, estas se crean con la política de ubicación de almacenamiento predefinida de Google Cloud.

Permisos necesarios para esta tarea

Para hacer esta tarea, debes tener los siguientes permisos:

compute.snapshotSettings.update en el proyecto

gcloud

Para agregar la configuración de la instantánea o actualizar la configuración de la instantánea existente en tu proyecto, usa el comando gcloud compute snapshot-settings update:

  gcloud compute snapshot-settings update \
      --project=PROJECT_ID \
      --storage-location-policy=STORAGE_LOCATION \
      --storage-location-names=REGION_NAME

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto.
STORAGE_LOCATION: Es la política de ubicación de almacenamiento de instantáneas para tu proyecto. El valor puede ser uno de los siguientes:
- nearest-multi-region: Especifica la política de ubicación como la multirregión de Cloud Storage más cercana a la ubicación de tu disco.
- local-region: Especifica la política de ubicación como la misma región de Cloud Storage en la que se encuentra el disco.
- specific-locations: especifica la política de ubicación como una ubicación de región de Cloud Storage personalizada que elijas. Si especificas esta opción, también debes especificar la ubicación que deseas mediante la marca --storage-location-names.
REGION_NAME: Si incluyes la marca --storage-location-policy con un valor de specific-locations, debes especificar una región de Cloud Storage (opcional). Solo puedes especificar una región. Establece este valor en el nombre de la región que deseas especificar como tu política de ubicación de almacenamiento.

Ejemplos para establecer la política de ubicación de almacenamiento mediante la configuración de instantáneas

Considera un proyecto de ejemplo my-project en la región us-central1.

Para configurar la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como la multirregión de Cloud Storage más cercana a tu disco, ejecuta el siguiente comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=nearest-multi-region

Para configurar la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como la misma región de Cloud Storage que tu disco, ejecuta el siguiente comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region

Para establecer la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como una ubicación específica de tu elección (como us-central1), usa la marca --storage-location-names y ejecuta el siguiente comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

REST

Para agregar la configuración de la instantánea o actualizar la configuración de la instantánea existente en tu proyecto, realiza una solicitud PATCH al método snapshotSettings.update:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "STORAGE_LOCATION",
      "locations": {
            "REGION_NAME": { "name": "REGION_NAME" }
      }
    }
  }

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto.
STORAGE_LOCATION: Es la política de ubicación de almacenamiento de instantáneas para tu proyecto. El valor puede ser uno de los siguientes:
- NEAREST_MULTI_REGION: Especifica la política de ubicación como la multirregión de Cloud Storage más cercana a la ubicación de tu disco.
- LOCAL_REGION: Especifica la política de ubicación como la misma región de Cloud Storage en la que se encuentra el disco.
- SPECIFIC_LOCATIONS: especifica la política de ubicación como una ubicación de región de Cloud Storage personalizada que elijas. Si especificas esta opción, también debes especificar la ubicación que deseas mediante el parámetro locations en tu solicitud.
REGION_NAME: Si incluyes el parámetro policy con un valor de SPECIFIC_LOCATIONS, debes especificar una región de Cloud Storage (opcional). Solo puedes especificar una región. Establece este valor en el nombre de la región que deseas especificar como tu política de ubicación de almacenamiento.

Ejemplos para establecer la política de ubicación de almacenamiento mediante la configuración de instantáneas

Considera un proyecto de ejemplo my-project en la región us-central1.

Para configurar la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como la multirregión de Cloud Storage más cercana a tu disco, haz la siguiente solicitud PATCH:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "NEAREST_MULTI_REGION"
      }
    }

Para configurar la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como la misma región de Cloud Storage que tu disco, haz la siguiente solicitud PATCH:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }

Para establecer la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como una ubicación específica (como us-central1), realiza la siguiente solicitud PATCH:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "SPECIFIC_LOCATIONS",
        "locations": {
          "us-central1": { "name": "us-central1"}
        }
      }
    }

Consulta la ubicación de almacenamiento predeterminada que define la configuración de instantáneas de un proyecto

Puedes ver la configuración de la instantánea de tu proyecto mediante la API de Compute Engine y gcloud CLI.

Permisos necesarios para esta tarea

Para hacer esta tarea, debes tener los siguientes permisos:

compute.snapshotSettings.get en el proyecto

gcloud

Para ver la configuración de la instantánea de tu proyecto, usa el comando gcloud compute snapshot-settings describe:

  gcloud compute snapshot-settings describe \
      --project=PROJECT_ID

Reemplaza PROJECT_ID por el ID del proyecto.

REST

Para ver la configuración de la instantánea de tu proyecto, realiza una solicitud GET al método snapshotSettings.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

Reemplaza PROJECT_ID por el ID del proyecto.

¿Qué sigue?

Obtén información sobre cómo ver, borrar y compartir instantáneas de discos.
Obtén información sobre cómo crear instantáneas programadas para discos.
Obtén más información sobre cómo crear una imagen de disco a partir de instantáneas.