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.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 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.
- 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
- 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ónus
. - 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ónasia
. 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
: Opcional: Si incluyes la marca--storage-location-policy
con un valor despecific-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.- 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:
- 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:
- 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: 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ámetrolocations
en tu solicitud.
REGION_NAME
: Opcional: Si incluyes el parámetropolicy
con un valor deSPECIFIC_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.- 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
: - 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
: - 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 solicitudPATCH
: - 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.
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.
Limitaciones
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:
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.
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.
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:
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ónus-central1
.gcloud compute snapshot-settings update \ --project=my-project \ --storage-location-policy=nearest-multi-region
gcloud compute snapshot-settings update \ --project=my-project \ --storage-location-policy=local-region
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étodosnapshotSettings.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:
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ónus-central1
.PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings { "storageLocation": { "policy": "NEAREST_MULTI_REGION" } }
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings { "storageLocation": { "policy": "LOCAL_REGION" } }
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étodosnapshotSettings.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings
Reemplaza
PROJECT_ID
por el ID del proyecto.¿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)
-