Wenn Sie Snapshots erstellen, verwendet Google Cloud vordefinierte Standardwerte für Konfigurationsoptionen, sofern Sie nicht explizit andere Werte angeben. Snapshot-Einstellungen sind zentrale Konfigurationsparameter auf Projektebene, mit denen Sie den Standardspeicherort für Google Cloud -Snapshots anpassen können. Wenn Sie mit den Snapshot-Einstellungen einen benutzerdefinierten Standardspeicherort definieren, müssen Sie bei jeder Snapshot-Erstellung keinen Speicherort manuell angeben.
In diesem Dokument finden Sie Informationen zu Snapshot-Einstellungen und dazu, wie Sie damit den Standardspeicherort für die Snapshots Ihres Projekts anpassen.
Hinweis
-
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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:
Select the tab for how you plan to use the samples on this page:
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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. Das ist nur für Standard- und Archiv-Snapshots möglich.
- Wenn Sie die Speicherortrichtlinie 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. Google CloudDie Richtlinie für den Speicherort in den Snapshot-Einstellungen bleibt jedoch unverändert.
Funktionsweise der Snapshot-Einstellungen
Die Richtlinie für Speicherorte in den Snapshot-Einstellungen eines Projekts definiert, woGoogle Cloud die Snapshots dieses Projekts automatisch gespeichert werden. Google Cloudbehält einen vordefinierten Wert für diese Richtlinie für Speicherorte bei, bis Sie die Snapshot-Einstellungen aktualisieren und einen neuen Standard konfigurieren. Nachdem Sie die Snapshot-Einstellungen aktualisiert und einen neuen Standardspeicherort festgelegt haben, speichertGoogle Cloud an diesem Speicherort jeden neuen Snapshot, der in diesem Projekt erstellt wird.
Sie können Ihre Snapshot-Einstellungen jederzeit aktualisieren, um die Richtlinie für den Speicherort zu ändern. Die Änderung der Snapshot-Einstellungen Ihres Projekts wirkt sich 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 Clouddie 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.
Mit den Snapshot-Einstellungen können Sie den Standardspeicherort für Ihre Standard- und Archiv-Snapshots anpassen. 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 laufwerkbasierte Speicherorteinstellungen verwenden. Sie können eine der folgenden Standortoptionen für Ihre Richtlinie für Speicherorte auswählen:
- Der nächstgelegene multiregionale Speicherort für das Quelllaufwerk
- In derselben lokalen Region wie das Quelllaufwerk
- Bestimmte Regionen Ihrer Wahl
Google Cloud Vordefinierte Richtlinie für Speicherorte
Bis Sie die Snapshot-Einstellungen zum ersten Mal aktualisieren,behält Google Cloud einen vordefinierten Wert für die Richtlinie für den Speicherort bei. Google CloudDiese vordefinierte Richtlinie gilt als Standardspeicherort für Snapshots, bis Sie einen eigenen Standardspeicherort konfigurieren, indem Sie die Snapshot-Einstellungen Ihres Projekts aktualisieren. Die vordefinierte Speicherortrichtlinie ist auf die Multiregion festgelegt, die dem Speicherort Ihres Quelllaufwerks geografisch am nächsten ist.
- 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 Multiregionus
. - Bei einem Standort außerhalb eines multiregionalen Speicherorts ist der Standardspeicherort der multiregionale Speicherort, der diesem Standort geografisch am nächsten liegt.
Für einen Speicherort wie
australia-southeast1
ist der Standardspeicherort die Multi-Regionasia
.
Auswirkungen auf den Preis
Für die Verwendung von Snapshot-Einstellungen für Ihre Projekte fallen keine zusätzlichen Kosten an. Die Standortwerte, die Sie mithilfe der Snapshot-Einstellungen angeben, wirken sich jedoch auf andere Vorgänge aus, was sich wiederum auf diese Betriebskosten auswirken kann.
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 vordefiniertenGoogle Cloud -Richtlinie für Speicherorte erstellt.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:
compute.snapshotSettings.update
für das Projekt
Wenn Sie die Snapshot-Einstellungen hinzufügen oder vorhandene Snapshot-Einstellungen für Ihr Projekt aktualisieren möchten, verwenden Sie den Befehl gcloud compute snapshot-settings update
:
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 ProjektsSTORAGE_LOCATION
: Die Richtlinie für den Speicherort von Snapshots 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 Wertspecific-locations
angeben, müssen Sie eine Cloud Storage-Region angeben. Sie können nur eine Region angeben und es darf sich nicht um eine Cloud Storage-Multi-Region handeln. Legen Sie für diesen Wert den Namen der Region fest, die Sie als Speicherortrichtlinie 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
- Wenn Sie in demselben Beispielprojekt die Richtlinie für den Speicherort der Snapshot-Einstellungen Ihres Projekts als bestimmten Speicherort (z. B.
us-central1
) konfigurieren möchten, verwenden Sie das Flag--storage-location-names
und führen Sie den folgenden Befehl aus:
gcloud compute snapshot-settings update \ --project=my-project \ --storage-location-policy=specific-locations \ --storage-location-names=us-central1
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 ProjektsSTORAGE_LOCATION
: Die Richtlinie für den Speicherort von Snapshots 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 Parameterlocations
in Ihrer Anfrage angeben.
REGION_NAME
: Optional: Wenn Sie den Parameterpolicy
mit dem WertSPECIFIC_LOCATIONS
angeben, müssen Sie eine Cloud Storage-Region angeben. Sie können nur eine Region angeben und es darf sich nicht um eine Cloud Storage-Multi-Region handeln. Legen Sie für diesen Wert den Namen der Region fest, die Sie als Speicherortrichtlinie 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 Richtlinie für den Speicherort der Snapshot-Einstellungen Ihres Projekts als bestimmten Speicherort (z. B.
us-central1
) konfigurieren möchten, senden Sie die folgendePATCH
-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.
Erforderliche Berechtigungen für diese Aufgabe
Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:
compute.snapshotSettings.get
für das Projekt
Mit dem Befehl gcloud compute snapshot-settings describe
können Sie die Snapshot-Einstellungen für Ihr Projekt aufrufen:
gcloud compute snapshot-settings describe \ --project=PROJECT_ID
Ersetzen Sie PROJECT_ID
durch die ID des Projekts.
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
- Laufwerk-Snapshots ansehen, löschen und freigeben
- Geplante Snapshots für Laufwerke erstellen
- Laufwerk-Image aus einem Snapshot erstellen