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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 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.
- Der nächstgelegene multiregionale Speicherort für das Quelllaufwerk
- Die gleiche lokale Region wie das Quelllaufwerk
- Bestimmte Regionen Ihrer Wahl
- 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, 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 Standortasia
. PROJECT_ID
: ID des ProjektsSTORAGE_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 Wertspecific-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.- 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:
- 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:
- 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
): PROJECT_ID
: ID des ProjektsSTORAGE_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 Parameterlocations
.
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. 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.- 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: - 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: - 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 folgendePATCH
-Anfrage: - Laufwerk-Snapshots aufrufen, löschen und freigeben
- Geplante Snapshots für Laufwerke erstellen
- Laufwerk-Image aus einem Snapshot erstellen
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
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:
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.
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:
Beispiele zum Festlegen einer Richtlinie für Speicherorte mit Snapshot-Einstellungen
Nehmen Sie als Beispiel ein Projekt
my-project
in der Regionus-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
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 MethodesnapshotSettings.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:
Beispiele zum Festlegen einer Richtlinie für Speicherorte mit Snapshot-Einstellungen
Nehmen Sie als Beispiel ein Projekt
my-project
in der Regionus-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"} } } }
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 MethodesnapshotSettings.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
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-12-03 (UTC).
-