Définir l'emplacement de stockage par défaut à l'aide des paramètres d'instantanés

Lorsque vous créez des instantanés, Google Cloud utilise des valeurs par défaut prédéfinies pour les options de configuration, sauf si vous fournissez explicitement des valeurs différentes. Les paramètres d'instantanés sont des paramètres de configuration centralisés au niveau du projet qui vous permettent de personnaliser l'emplacement par défaut où Google Cloud stocke vos instantanés. L'utilisation de paramètres d'instantanés pour définir votre propre valeur par défaut vous évite d'avoir à spécifier manuellement un emplacement lors de chaque création d'instantané.

Ce document fournit des informations sur les paramètres d'instantanés et sur leur utilisation pour personnaliser l'emplacement de stockage par défaut des instantanés de votre projet.

Avant de commencer

Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Limites

Vous ne pouvez afficher et mettre à jour les paramètres d'instantanés qu'à l'aide de la gcloud CLI ou de REST.
Vous ne pouvez pas personnaliser l'emplacement de stockage par défaut des instantanés immédiats. Vous ne pouvez le faire que pour les instantanés standards et d'archive.
La modification de la règle d'emplacement dans les paramètres d'instantanés de votre projet n'affecte que les instantanés créés après la modification. La mise à jour des paramètres d'instantanés de votre projet ne modifie pas l'emplacement des instantanés existants.
Si vous spécifiez manuellement un emplacement lors de la création de l'instantané, Google Cloud ignore les paramètres d'instantanés et crée votre instantané dans ce nouvel emplacement. Toutefois, la règle d'emplacement de stockage dans vos paramètres d'instantanés reste inchangée.

Fonctionnement des paramètres d'instantanés

La règle d'emplacement de stockage des paramètres d'instantanés d'un projet définit l'emplacement où Google Cloud stocke automatiquement les instantanés de ce projet. Google Cloud conserve une valeur prédéfinie pour cette règle d'emplacement de stockage jusqu'à ce que vous mettiez à jour les paramètres d'instantanés et configurez une nouvelle valeur par défaut. Une fois que vous avez mis à jour les paramètres d'instantanés et défini un nouvel emplacement de stockage par défaut, Google Cloud utilise cet emplacement pour stocker chaque nouvel instantané créé dans ce projet.

Vous pouvez mettre à jour vos paramètres d'instantanés pour modifier la règle d'emplacement de stockage autant de fois que nécessaire. Toutefois, la modification des paramètres d'instantanés de votre projet n'affecte que les emplacements des instantanés créés après la modification. La mise à jour des paramètres d'instantanés de votre projet ne modifie pas l'emplacement des instantanés existants.

Pour vous assurer que Google Cloud utilise l'emplacement de stockage défini par vos paramètres d'instantanés, ne spécifiez pas d'emplacement manuellement lors de la création de l'instantané. Si vous spécifiez manuellement un emplacement lors de la création de l'instantané, Google Cloud ignore les paramètres d'instantanés et crée votre instantané dans ce nouvel emplacement. Toutefois, la règle d'emplacement de stockage dans vos paramètres d'instantanés reste inchangée.

Vous pouvez utiliser les paramètres d'instantanés pour personnaliser l'emplacement de stockage par défaut de vos instantanés standards et d'archive. Vous ne pouvez pas personnaliser l'emplacement de stockage par défaut des instantanés immédiats.

Options d'emplacement de stockage

Lorsque vous configurez les paramètres d'instantanés de votre projet et spécifiez un nouvel emplacement de stockage par défaut, vous pouvez choisir des régions spécifiques ou utiliser des paramètres d'emplacement basés sur le disque. Plus précisément, vous pouvez choisir l'une des options d'emplacement suivantes pour votre règle d'emplacement de stockage :

Emplacement multirégional le plus proche du disque source
Même région locale que le disque source
Régions spécifiques de votre choix

Règles d'emplacement de stockage prédéfinies Google Cloud

Tant que vous n'avez pas mis à jour vos paramètres d'instantanés pour la première fois, Google Cloud conserve une valeur prédéfinie pour la règle d'emplacement de stockage. Cette règle prédéfinie fournit l'emplacement de stockage par défaut des instantanés jusqu'à ce que vous configuriez votre propre emplacement de stockage par défaut en mettant à jour les paramètres d'instantanés de votre projet. La règle d'emplacement de stockage prédéfinie est définie sur l'emplacement multirégional le plus proche géographiquement de l'emplacement de votre disque source.

Si votre disque source se trouve dans un emplacement faisant partie d'un emplacement multirégional, vos règles d'emplacement de stockage des paramètres d'instantanés sont définies sur cet emplacement multirégional. Par exemple, si votre disque se trouve dans un emplacement tel que us-central1, l'emplacement de stockage par défaut est l'emplacement multirégional us.
Pour un emplacement situé en dehors d'un emplacement multirégional, l'emplacement de stockage par défaut est l'emplacement multirégional le plus proche géographiquement en dehors de cette région. Pour un emplacement tel que australia-southeast1, l'emplacement par défaut devient l'emplacement multirégional asia.

Implications en termes de tarification

L'utilisation de paramètres d'instantanés pour vos projets n'entraîne pas de frais supplémentaires. Toutefois, les valeurs de localisation que vous spécifiez à l'aide des paramètres d'instantanés affectent d'autres opérations, qui peuvent à leur tour affecter ces coûts opérationnels.

Définir l'emplacement de stockage par défaut pour un projet à l'aide des paramètres d'instantanés

Vous pouvez mettre à jour les paramètres d'instantanés de votre projet et définir un nouvel emplacement de stockage par défaut à l'aide de REST et de la gcloud CLI.

Si vous ne définissez pas de règle d'emplacement de stockage dans vos paramètres d'instantanés, vos instantanés sont créés à l'aide de la règle d'emplacement de stockage prédéfinie Google Cloud.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.snapshotSettings.update sur le projet

gcloud

Pour ajouter des paramètres d'instantanés ou mettre à jour les paramètres existants d'instantanés de votre projet, utilisez la commande gcloud compute snapshot-settings update:

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet
STORAGE_LOCATION : règle d'emplacement de stockage des instantanés pour votre projet. Les valeurs possibles sont les suivantes :
- nearest-multi-region : spécifie la règle d'emplacement afin d'utiliser l'emplacement multirégional Cloud Storage le plus proche de l'emplacement de votre disque.
- local-region : spécifie la règle d'emplacement afin d'utiliser la région Cloud Storage où se trouve votre disque.
- specific-locations: spécifie la règle d'emplacement en tant qu'emplacement personnalisé de la région Cloud Storage de votre choix. Si vous spécifiez cette option, vous devez également spécifier l'emplacement souhaité à l'aide de l'option --storage-location-names.
REGION_NAME (facultatif) : si vous incluez l'option --storage-location-policy avec la valeur specific-locations, vous devez spécifier une région Cloud Storage. Vous ne pouvez spécifier qu'une seule région et il ne peut pas s'agir d'un emplacement multirégional Cloud Storage. Définissez cette valeur sur le nom de la région que vous souhaitez spécifier comme règle d'emplacement de stockage.

Exemples de définition d'une règle d'emplacement de stockage à l'aide des paramètres d'instantanés

Prenons un exemple de projet my-project dans la région us-central1.

Pour configurer la règle d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser l'emplacement multirégional Cloud Storage le plus proche de votre disque, exécutez la commande suivante :

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

Pour configurer la règle d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser la même région Cloud Storage que votre disque, exécutez la commande suivante:

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

Pour configurer la stratégie d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser l'emplacement spécifique de votre choix (tel que us-central1), utilisez l'option --storage-location-names et exécutez la commande suivante:

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

REST

Pour ajouter les paramètres d'instantanés ou mettre à jour les paramètres existants de votre projet, envoyez une requête PATCH à la méthode snapshotSettings.update :

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

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet
STORAGE_LOCATION : règle d'emplacement de stockage des instantanés pour votre projet. Les valeurs possibles sont les suivantes :
- NEAREST_MULTI_REGION : spécifie la règle d'emplacement afin d'utiliser l'emplacement multirégional Cloud Storage le plus proche de l'emplacement de votre disque.
- LOCAL_REGION : spécifie la règle d'emplacement afin d'utiliser la région Cloud Storage où se trouve votre disque.
- SPECIFIC_LOCATIONS: spécifie la règle d'emplacement en tant qu'emplacement personnalisé de la région Cloud Storage de votre choix. Si vous spécifiez cette option, vous devez également spécifier l'emplacement souhaité en utilisant le paramètre locations dans votre requête.
REGION_NAME Facultatif : si vous incluez le paramètre policy avec la valeur SPECIFIC_LOCATIONS, vous devez spécifier une région Cloud Storage. Vous ne pouvez spécifier qu'une seule région et il ne peut pas s'agir d'un emplacement multirégional Cloud Storage. Définissez cette valeur sur le nom de la région que vous souhaitez spécifier comme règle d'emplacement de stockage.

Exemples de définition d'une règle d'emplacement de stockage à l'aide des paramètres d'instantanés

Prenons un exemple de projet my-project dans la région us-central1.

Pour configurer la règle d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser l'emplacement multirégional Cloud Storage le plus proche de votre disque, envoyez la requête PATCH suivante :

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

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

Pour configurer la règle d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser la même région Cloud Storage que votre disque, envoyez la requête PATCH suivante:

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

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

Pour configurer la stratégie d'emplacement de stockage des paramètres d'instantanés de votre projet afin d'utiliser un emplacement spécifique (tel que us-central1), envoyez la requête PATCH suivante:

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

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

Afficher l'emplacement de stockage par défaut défini par les paramètres d'instantanés d'un projet

Vous pouvez afficher les paramètres d'instantanés de votre projet à l'aide de l'API Compute Engine et de gcloud CLI.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.snapshotSettings.get sur le projet

gcloud

Pour afficher les paramètres d'instantanés de votre projet, exécutez la commande gcloud compute snapshot-settings describe :

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

Remplacez PROJECT_ID par l'ID du projet.

REST

Pour afficher les paramètres d'instantanés de votre projet, envoyez une requête GET à la méthode snapshotSettings.get :

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

Remplacez PROJECT_ID par l'ID du projet.

Étapes suivantes

Découvrez comment afficher, supprimer et partager des instantanés de disque.
Découvrez comment créer des instantanés programmés pour des disques.
Apprenez à créer une image disque à partir de votre instantané.