Sicherungs-Instanz. Wenn zum ersten Mal eine Sicherung erstellt wird, wird im Backend eine Sicherungssammlung erstellt, zu der diese Sicherung gehört. Sowohl die Sammlung als auch die Sicherung haben einen Ressourcennamen. Die Sicherung wird für jeden Shard ausgeführt. Ein Replikat (primär, wenn nicht HA) wird für die Ausführung ausgewählt. Der Sicherungsaufruf wird abgelehnt, wenn ein Sicherungs- oder Updatevorgang in Bearbeitung ist. Wenn die interne Softwareversion der Instanz während der Vorschau zu alt ist, wird vor dem eigentlichen Sichern ein kritisches Update durchgeführt. Sobald die interne Softwareversion auf die Mindestversion aktualisiert wurde, die für die Sicherungsfunktion erforderlich ist, sind für nachfolgende Sicherungen keine kritischen Updates erforderlich. Nach der Vorabversion ist für die Sicherung kein wichtiges Update erforderlich.
HTTP-Anfrage
POST https://memorystore.googleapis.com/v1beta/{name=projects/*/locations/*/instances/*}:backup
Erforderlich. Ressourcenname der Instanz im Format projects/{projectId}/locations/{locationId}/instances/{instanceId}, wobei sich locationId auf eine Google Cloud-Region bezieht
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Optional. TTL für das Ablaufen der Sicherung. Der Wertebereich liegt zwischen 1 Tag und 100 Jahren. Wenn keine Angabe erfolgt, beträgt der Standardwert 100 Jahre.
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
backupId
string
Optional. Die ID der zu erstellenden Sicherung. Wenn Sie keinen Wert angeben, wird der Standardwert [YYYYMMDDHHMMSS]_[gekürzte Instanz-UID] verwendet.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-30 (UTC)."],[],[],null,["# Method: projects.locations.instances.backup\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nBackup Instance. If this is the first time a backup is being created, a backup collection will be created at the backend, and this backup belongs to this collection. Both collection and backup will have a resource name. Backup will be executed for each shard. A replica (primary if nonHA) will be selected to perform the execution. Backup call will be rejected if there is an ongoing backup or update operation. Be aware that during preview, if the instance's internal software version is too old, critical update will be performed before actual backup. Once the internal software version is updated to the minimum version required by the backup feature, subsequent backups will not require critical update. After preview, there will be no critical update needed for backup.\n\n### HTTP request\n\n`POST https://memorystore.googleapis.com/v1beta/{name=projects/*/locations/*/instances/*}:backup`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/memorystore/docs/valkey/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `memorystore.instances.backup`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]