Standardspeicherort mit Snapshot-Einstellungen festlegen

Beim Erstellen von Snapshots verwendet Google Cloud vordefinierte Standardwerte für Konfigurationsoptionen, es sei denn, Sie geben explizit andere Werte an. Snapshot-Einstellungen sind zentralisierte Konfigurationsparameter auf Projektebene, mit denen Sie den Standardspeicherort anpassen können, an dem Google Cloud Ihre Snapshots speichert. Wenn Sie mit den Snapshot-Einstellungen einen eigenen benutzerdefinierten Standard definieren, müssen Sie nicht mehr bei jeder Snapshot-Erstellung einen Speicherort manuell angeben.

Dieses Dokument enthält Informationen zu Snapshot-Einstellungen und dazu, wie Sie diese verwenden können, um den Standardspeicherort für die Snapshots Ihres Projekts anzupassen.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich wie folgt bei Compute Engine authentifizieren.

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

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Beschränkungen

  • Sie können die Snapshot-Einstellungen nur mit der gcloud CLI oder REST aufrufen und aktualisieren.
  • Sie können den Standardspeicherort für Instant Snapshot nicht anpassen. Dies ist nur für Standard- und Archiv-Snapshots möglich.
  • Wenn Sie die Standortrichtlinie in den Snapshot-Einstellungen Ihres Projekts ändern, wirkt sich das nur auf die Snapshots aus, die nach dieser Änderung erstellt werden. Durch das Aktualisieren der Snapshot-Einstellungen Ihres Projekts wird der Speicherort vorhandener Snapshots nicht geändert.
  • Wenn Sie während der Snapshot-Erstellung einen Speicherort manuell angeben, überschreibt Google Cloud die Snapshot-Einstellungen und erstellt den Snapshot an diesem neu angegebenen Speicherort. Die Richtlinie für den Speicherort in den Snapshot-Einstellungen bleibt jedoch unverändert.

Funktionsweise der Snapshot-Einstellungen

Die Richtlinie für den Speicherort in den Snapshot-Einstellungen eines Projekts definiert, wo Google Cloud die Snapshots dieses Projekts automatisch speichert. Google Cloud behält einen vordefinierten Wert für diese Richtlinie für Speicherorte bei, bis Sie die Snapshot-Einstellungen aktualisieren und einen neuen Standardwert konfigurieren. Nachdem Sie die Snapshot-Einstellungen aktualisiert und einen neuen Standardspeicherort festgelegt haben, verwendet Google Cloud diesen Speicherort, um jeden neu in diesem Projekt erstellten Snapshot zu speichern.

Sie können die Snapshot-Einstellungen aktualisieren, um die Richtlinie für den Speicherort beliebig oft zu ändern. Wenn Sie die Snapshot-Einstellungen Ihres Projekts ändern, wirkt sich das jedoch nur auf die Speicherorte von Snapshots aus, die nach dieser Änderung erstellt werden. Durch das Aktualisieren der Snapshot-Einstellungen Ihres Projekts wird der Speicherort vorhandener Snapshots nicht geändert.

Damit Google Cloud den von Ihren Snapshot-Einstellungen definierten Speicherort verwendet, geben Sie während der Snapshot-Erstellung keinen Speicherort an. Wenn Sie während der Snapshot-Erstellung einen Speicherort manuell angeben, überschreibt Google Cloud die Snapshot-Einstellungen und erstellt den Snapshot an diesem neu angegebenen Speicherort. Die Richtlinie für den Speicherort in den Snapshot-Einstellungen bleibt jedoch unverändert.

Sie können die Snapshot-Einstellungen verwenden, um den Standardspeicherort für Ihre Standard- und Archiv-Snapshots anzupassen. Sie können den Standardspeicherort für Instant Snapshots nicht anpassen.

Optionen für den Speicherort

Wenn Sie die Snapshot-Einstellungen Ihres Projekts konfigurieren und einen neuen Standardspeicherort angeben, können Sie entweder bestimmte Regionen auswählen oder laufwerksbasierte Standorteinstellungen verwenden. Genauer gesagt können Sie eine der folgenden Standortoptionen für Ihre Richtlinie für Speicherorte auswählen:

  • Der nächstgelegene multiregionale Speicherort für das Quelllaufwerk
  • Die gleiche lokale Region wie das Quelllaufwerk
  • Bestimmte Regionen Ihrer Wahl

Vordefinierte Google Cloud-Richtlinie für Speicherorte

Bis Sie die Snapshot-Einstellungen erstmalig aktualisieren, behält Google Cloud einen vordefinierten Wert für die Richtlinie für den Speicherort bei. Diese vordefinierte Richtlinie stellt den Standardspeicherort für Snapshots bereit, bis Sie Ihren eigenen Standardspeicherort konfigurieren, indem Sie die Snapshot-Einstellungen Ihres Projekts aktualisieren. Die vordefinierte Richtlinie für den Speicherort ist auf den multiregionalen Speicherort festgelegt, der dem Speicherort Ihres Quelllaufwerks geografisch am nächsten liegt.

  • Wenn sich Ihr Quelllaufwerk an einem Ort befindet, der Teil einer Multiregion ist, dann ist die Richtlinie für den Speicherort Ihrer Snapshot-Einstellungen auf diese Multiregion festgelegt. Wenn sich Ihr Laufwerk beispielsweise an einem Speicherort wie us-central1 befindet, ist der Standardspeicherort die Multiregion us.
  • Bei einem Standort, der sich außerhalb einer Multiregion befindet, ist der Standardspeicherort der geografisch nächstgelegene multiregionale Standort außerhalb dieser Region. Für einen Standort wie australia-southeast1 wird der Standardspeicherort zum multiregionalen Standort asia.

Auswirkungen auf den Preis

Sie müssen keine zusätzlichen Kosten bezahlen, um die Snapshot-Einstellungen für Ihre Projekte zu verwenden. Die Standortwerte, die Sie mit den Snapshot-Einstellungen angeben, wirken sich jedoch auf andere Vorgänge aus, die sich wiederum auf diese Betriebskosten auswirken können.

Standardspeicherort für ein Projekt mithilfe der Snapshot-Einstellungen festlegen

Sie können die Snapshot-Einstellungen Ihres Projekts aktualisieren und mit REST und der gcloud CLI einen neuen Standardspeicherort festlegen.

Wenn Sie in den Snapshot-Einstellungen keine Richtlinie für Speicherorte festlegen, werden die Snapshots mit der vordefinierten Google Cloud-Richtlinie für Speicherorte erstellt.

gcloud

Verwenden Sie den Befehl gcloud compute snapshot-settings update, um die Snapshot-Einstellungen hinzuzufügen oder die vorhandenen Snapshot-Einstellungen für Ihr Projekt zu aktualisieren:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID des Projekts

  • STORAGE_LOCATION: Die Richtlinie für den Snapshot-Speicherort für Ihr Projekt. Der Wert kann einer der folgenden sein:

    • nearest-multi-region: Gibt die Speicherortrichtlinie als nächstgelegene Cloud Storage-Multiregion für den Standort des Laufwerks an.
    • local-region: Legt als Standortrichtlinie die gleiche Cloud Storage-Region fest, in der sich Ihr Laufwerk befindet.
    • specific-locations: Gibt die Standortrichtlinie als benutzerdefinierte Cloud Storage-Region Ihrer Wahl an. Wenn Sie diese Option angeben, müssen Sie auch den gewünschten Speicherort mit dem Flag --storage-location-names angeben.

  • REGION_NAME: Optional: Wenn Sie das Flag --storage-location-policy mit dem Wert specific-locations angeben, müssen Sie eine Cloud Storage-Region angeben. Sie können nur eine Region angeben. Es darf sich nicht um eine Cloud Storage-Multiregion handeln. Legen Sie diesen Wert auf den Namen der Region fest, die Sie als Richtlinie für den Speicherort angeben möchten.

Beispiele zum Festlegen einer Richtlinie für Speicherorte mit Snapshot-Einstellungen

Nehmen Sie als Beispiel ein Projekt my-project in der Region us-central1.

  • Führen Sie den folgenden Befehl aus, um die Richtlinie für den Speicherort der Snapshot-Einstellungen Ihres Projekts als Cloud Storage-Multiregion zu konfigurieren, die Ihrem Laufwerk am nächsten liegt:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=nearest-multi-region
  • Führen Sie den folgenden Befehl aus, um die Speicherortrichtlinie für die Snapshot-Einstellungen Ihres Projekts als dieselbe Cloud Storage-Region wie Ihr Laufwerk zu konfigurieren:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Verwenden Sie das Flag --storage-location-names und führen Sie den folgenden Befehl aus, um als Speicherortrichtlinie für die Snapshot-Einstellungen Ihres Projekts einen bestimmten Speicherort Ihrer Wahl zu konfigurieren (z. B. us-central1):
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

REST

Wenn Sie die Snapshot-Einstellungen hinzufügen oder vorhandene Snapshot-Einstellungen für Ihr Projekt aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode snapshotSettings.update:

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID des Projekts

  • STORAGE_LOCATION: Die Richtlinie für den Snapshot-Speicherort für Ihr Projekt. Der Wert kann einer der folgenden sein:

    • NEAREST_MULTI_REGION: Gibt die Speicherortrichtlinie als nächstgelegene Cloud Storage-Multiregion für den Standort des Laufwerks an.
    • LOCAL_REGION: Legt als Standortrichtlinie die gleiche Cloud Storage-Region fest, in der sich Ihr Laufwerk befindet.
    • SPECIFIC_LOCATIONS: Gibt die Standortrichtlinie als benutzerdefinierte Cloud Storage-Region Ihrer Wahl an. Wenn Sie diese Option angeben, müssen Sie auch den gewünschten Standort angeben. Verwenden Sie dazu in Ihrer Anfrage den Parameter locations.

  • REGION_NAME: Optional: Wenn Sie den Parameter policy mit dem Wert SPECIFIC_LOCATIONS angeben, müssen Sie eine Cloud Storage-Region angeben. Sie können nur eine Region angeben. Es darf sich nicht um eine Cloud Storage-Multiregion handeln. Legen Sie diesen Wert auf den Namen der Region fest, die Sie als Richtlinie für den Speicherort angeben möchten.

Beispiele zum Festlegen einer Richtlinie für Speicherorte mit Snapshot-Einstellungen

Nehmen Sie als Beispiel ein Projekt my-project in der Region us-central1.

  • Senden Sie die folgende PATCH-Anfrage, um die Speicherortrichtlinie für die Snapshot-Einstellungen Ihres Projekts als die Cloud Storage-Multiregion zu konfigurieren, die Ihrem Laufwerk am nächsten liegt:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "NEAREST_MULTI_REGION"
      }
    }
  • Senden Sie die folgende PATCH-Anfrage, um die Speicherortrichtlinie für die Snapshot-Einstellungen Ihres Projekts als dieselbe Cloud Storage-Region wie Ihr Laufwerk zu konfigurieren:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Wenn Sie die Speicherortrichtlinie für die Snapshot-Einstellungen Ihres Projekts als einen bestimmten Speicherort (z. B. us-central1) konfigurieren möchten, stellen Sie die folgende PATCH-Anfrage:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

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

Standardspeicherort ansehen, der durch die Snapshot-Einstellungen eines Projekts festgelegt wird

Sie können die Snapshot-Einstellungen Ihres Projekts mit der Compute Engine API und der gcloud CLI aufrufen.

gcloud

Verwenden Sie den Befehl gcloud compute snapshot-settings describe, um die Snapshot-Einstellungen für Ihr Projekt aufzurufen:

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

REST

Senden Sie eine GET-Anfrage an die Methode snapshotSettings.get, um die Snapshot-Einstellungen für Ihr Projekt aufzurufen:

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

Nächste Schritte