Establece ubicaciones de almacenamiento predeterminadas para instantáneas de alcance global

Cuando creas instantáneas, se crean como instantáneas de alcance global de forma predeterminada. Para un proyecto determinado, puedes personalizar la ubicación predeterminada en la que Google Cloud almacena las instantáneas de alcance global configurando la configuración de 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 cada vez que creas una instantánea.

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 alcance global de tu proyecto.

Para administrar la configuración de ubicación de las instantáneas de alcance regional, consulta Establece ubicaciones de creación y restablecimiento de instantáneas para instantáneas de alcance regional (vista previa).

Antes de comenzar

  • Configura la autenticación si aún no lo hiciste. La autenticación verifica tu identidad para acceder a los Google Cloud servicios y las APIs. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña según cómo planeas usar las muestras en esta página:

    gcloud

    1. Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

    • REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala la Google Cloud CLI.

      Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de. Google Cloud

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, entonces 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.
  • Las ubicaciones de almacenamiento predeterminadas solo se aplican a las instantáneas de alcance global. Para controlar las ubicaciones de almacenamiento de las instantáneas de alcance regional, debes establecer ubicaciones de creación de instantáneas permitidas.
  • Establecer una ubicación de almacenamiento predeterminada solo controla dónde se almacena la instantánea. Con las instantáneas de alcance global, no puedes establecer dónde se pueden restablecer los datos de la instantánea. Para establecer ubicaciones permitidas para el restablecimiento de instantáneas, debes crear una instantánea regional y establecer ubicaciones de restablecimiento permitidas.

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, anulará la configuración de la instantánea y creará la instantánea en esa ubicación recién especificada. Google CloudSin 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

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

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 predeterminactualices 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 Google Cloud política de ubicación de almacenamiento predefinida.

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 gcloud compute snapshot-settings update comando:

  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:

  • REGION_NAME: Opcional: Si incluyes la marca --storage-location-policy con un valor de specific-locations, debes especificar una región de Cloud Storage. Solo puedes especificar una región y no puede ser una multirregión de Cloud Storage. Establece este valor con 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 configurar como la política de ubicación de almacenamiento de la configuración de instantáneas de tu proyecto como una ubicación específica que elijas (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:

  • REGION_NAME: Opcional: Si incluyes el parámetro policy con un valor de SPECIFIC_LOCATIONS, debes especificar una región de Cloud Storage. Solo puedes especificar una región y no puede ser una multirregión de Cloud Storage. Establece este valor con 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 el mismo proyecto de ejemplo, a fin de 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.

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?