Establecer ubicaciones de almacenamiento predeterminadas para instantáneas de ámbito global


Cuando crea instantáneas, se crean como instantáneas de ámbito global de forma predeterminada. Para un proyecto determinado, puede personalizar la ubicación predeterminada dondeGoogle Cloud almacena las instantáneas de ámbito global configurando los ajustes de la instantánea. El uso de la configuración de instantáneas para definir su propio valor predeterminado personalizado elimina la necesidad de especificar manualmente una ubicación cada vez que crea una instantánea.

Este documento proporciona información sobre la configuración de instantáneas y cómo usarlas para personalizar la ubicación de almacenamiento predeterminada para las instantáneas de alcance global de su proyecto.

Para administrar la configuración de ubicación para instantáneas con ámbito regional, consulte Establecer ubicaciones de creación y restauración de instantáneas para instantáneas con ámbito regional ( Vista previa ).

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.
    3. 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.

        After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Limitaciones

  • Puedes ver y actualizar la configuración de la instantánea solo mediante la CLI de gcloud o REST.
  • No puede personalizar la ubicación de almacenamiento predeterminada de las instantáneas instantáneas. Sólo puede hacerlo para instantáneas estándar y de archivo.
  • Modificar la política de ubicación en la configuración de instantáneas de su proyecto solo afecta las instantáneas que se crean después de esa modificación. Actualizar la configuración de instantáneas de su proyecto no cambia la ubicación de ninguna instantánea existente.
  • Si especifica manualmente una ubicación durante la creación de la instantánea, entonces Google Cloudanula la configuración de la instantánea y crea su instantánea en esa ubicación recién especificada. Sin embargo, la política de ubicación de almacenamiento en la configuración de su instantánea permanece sin cambios.
  • Las ubicaciones de almacenamiento predeterminadas se aplican solo a instantáneas de ámbito global. Para controlar las ubicaciones de almacenamiento de instantáneas de ámbito regional, debe establecer ubicaciones permitidas para la creación de instantáneas .
  • Establecer una ubicación de almacenamiento predeterminada controla solo dónde se almacena la instantánea. Con las instantáneas de ámbito global, no puede establecer dónde se pueden restaurar los datos de la instantánea. Para establecer ubicaciones permitidas para la restauración de instantáneas, debe crear una instantánea regional y establecer ubicaciones de restauración permitidas .

Cómo funcionan las configuraciones de instantáneas

La política de ubicación de almacenamiento de la configuración de instantáneas de un proyecto define dóndeGoogle Cloud almacena automáticamente las instantáneas de ese proyecto. Google Cloudmantiene un valor predefinido para esta política de ubicación de almacenamiento hasta que actualice la configuración de la instantánea y configure un nuevo valor predeterminado. Después de actualizar la configuración de la instantánea y establecer una nueva ubicación de almacenamiento predeterminada,Google Cloud utiliza esta ubicación para almacenar cada nueva instantánea creada en ese proyecto.

Puede actualizar la configuración de su 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 su proyecto solo afecta las ubicaciones de las instantáneas que se crean después de esa modificación. Actualizar la configuración de instantáneas de su proyecto no cambia la ubicación de ninguna instantánea existente.

Para asegurar que Google Cloud utiliza la ubicación de almacenamiento definida por la configuración de la instantánea, no especifique manualmente una ubicación durante la creación de la instantánea. Si especifica manualmente una ubicación durante la creación de la instantánea, entonces Google Cloudanula la configuración de la instantánea y crea su instantánea en esa ubicación recién especificada. Sin embargo, la política de ubicación de almacenamiento en la configuración de su instantánea permanece sin cambios.

Puede utilizar la configuración de instantáneas para personalizar la ubicación de almacenamiento predeterminada de sus instantáneas estándar y de archivo. No puedes personalizar la ubicación de almacenamiento predeterminada de las instantáneas instantáneas .

Opciones de ubicación de almacenamiento

Cuando configura los ajustes de la instantánea de su proyecto y especifica una nueva ubicación de almacenamiento predeterminada, puede elegir regiones específicas o usar configuraciones de ubicación basadas en disco. Más específicamente, puede elegir una de las siguientes opciones de ubicación para su política de ubicación de almacenamiento:

  • La multiregión más cercana al disco de origen
  • La misma región local que el disco de origen.
  • Regiones específicas de su elección

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

Hasta que actualices la configuración de tu instantánea por primera vez, Google Cloudmantiene un valor predefinido para la política de ubicación de almacenamiento. Esta política predefinida proporciona la ubicación de almacenamiento predeterminada para las instantáneas hasta que configure su propia ubicación de almacenamiento predeterminada actualizando la configuración de la instantánea de su proyecto. La política de ubicación de almacenamiento predefinida se establece en la multiregión geográficamente más cercana a la ubicación de su disco de origen.

  • Si su disco de origen se encuentra en una ubicación que forma parte de una región múltiple, entonces su política de ubicación de almacenamiento de configuración de instantáneas se establece en esa región múltiple. Por ejemplo, si su disco está en una ubicación como us-central1 , entonces la ubicación de almacenamiento predeterminada es multirregión us .
  • Para una ubicación que está fuera de una región múltiple, la ubicación de almacenamiento predeterminada es la región múltiple geográficamente más cercana fuera de esa región. Para una ubicación como australia-southeast1 , la ubicación predeterminada pasa a ser la región múltiple asia .

Implicaciones de precios

No tiene que pagar ninguna cantidad adicional para usar la configuración de instantáneas para sus proyectos. Sin embargo, los valores de ubicación que especifique mediante la configuración de instantáneas afectan otras operaciones, lo que a su vez puede afectar esos costos operativos.

Establecer la ubicación de almacenamiento predeterminada para un proyecto usando la configuración de instantánea

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

Si no establece una política de ubicación de almacenamiento en la configuración de sus instantáneas, sus instantáneas se crean usando el Google Cloud Política de ubicación de almacenamiento predefinida .

nube de gcloud

Para agregar la configuración de la instantánea o actualizar la configuración de la instantánea existente para 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

Reemplace lo siguiente:

  • PROJECT_ID : El ID del proyecto.
  • STORAGE_LOCATION : la política de ubicación de almacenamiento de instantáneas para su proyecto. El valor puede ser uno de los siguientes:

    • nearest-multi-region : especifica la política de ubicación como la multiregión de Cloud Storage más cercana a la ubicación de su disco.
    • local-region : especifica la política de ubicación como la misma región de Cloud Storage donde se encuentra su disco.
    • specific-locations : especifica la política de ubicación como una ubicación de región personalizada de Cloud Storage de su elección. Si especifica esta opción, también debe especificar la ubicación que desea mediante el indicador --storage-location-names .
  • REGION_NAME : Opcional: si incluye la marca --storage-location-policy con un valor de specific-locations , debe especificar una región de Cloud Storage . Puedes especificar solo una región y no puede ser una región múltiple de Cloud Storage. Establezca este valor en el nombre de la región que desea especificar como 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

Considere 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 región múltiple 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 la política de ubicación de almacenamiento de la configuración de instantáneas de su proyecto como una ubicación específica de su elección (como us-central1 ), use la marca --storage-location-names y ejecute el siguiente comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

DESCANSAR

Para agregar la configuración de la instantánea o actualizar la configuración de la instantánea existente para su proyecto, realice 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" }
      }
    }
  }

Reemplace lo siguiente:

  • PROJECT_ID : El ID del proyecto.
  • STORAGE_LOCATION : la política de ubicación de almacenamiento de instantáneas para su 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 su disco.
    • LOCAL_REGION : especifica la política de ubicación como la misma región de Cloud Storage donde se encuentra su disco.
    • SPECIFIC_LOCATIONS : especifica la política de ubicación como una ubicación de región personalizada de Cloud Storage de su elección. Si especifica esta opción, también debe especificar la ubicación que desea utilizando el parámetro de locations en su solicitud.
  • REGION_NAME : Opcional: si incluye el parámetro policy con un valor de SPECIFIC_LOCATIONS , debe especificar una región de Cloud Storage . Puedes especificar solo una región y no puede ser una región múltiple de Cloud Storage. Establezca este valor en el nombre de la región que desea especificar como 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

Considere 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 región múltiple de Cloud Storage más cercana a tu disco, realiza 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, realiza la siguiente solicitud PATCH :
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Para configurar como política de ubicación de almacenamiento de la configuración de instantáneas de su proyecto como una ubicación específica (como us-central1 ), realice 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"}
        }
      }
    }

Ver la ubicación de almacenamiento predeterminada definida por la configuración de instantánea de un proyecto

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

nube de gcloud

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

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

Reemplace PROJECT_ID con el ID del proyecto.

DESCANSAR

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

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

Reemplace PROJECT_ID con el ID del proyecto.

¿Qué sigue?