Instanzen erstellen

Auf dieser Seite finden Sie eine Anleitung zum Erstellen von Instanzen mit einer oder mehreren Zonen in Memorystore for Valkey.

Hinweis

Führen Sie die Schritte im Abschnitt „Vorbereitung“ aus:

  1. Wählen Sie in der Google Cloud -Console auf der Seite für die Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.


    Zur Projektauswahl
  2. Die Abrechnung für Ihr Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  3. Installieren und initialisieren Sie die Google Cloud CLI.

    Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen. Sie benötigen mindestens die gcloud CLI-Version 489.0.0, um auf die gcloud CLI-Befehle für Memorystore for Valkey zuzugreifen.

  4. Memorystore for Valkey API aktivieren
    Memorystore for Valkey
  5. Network Connectivity API aktivieren
    Network Connectivity API
  6. Aktivieren Sie die Service Consumer Management API.
    Service Consumer Management API

Weitere Voraussetzungen

  • Sie benötigen eine der folgenden IAM-Rollen im Projekt von Google Cloud , das Sie verwenden:
    • roles/memorystore.admin (die vordefinierte IAM-Rolle „Memorystore Admin“)
    • roles/owner (einfache IAM-Rolle „Inhaber“)
    • roles/editor (einfache IAM-Rolle „Bearbeiter“)

Netzwerk einrichten

Lesen Sie die Seite Netzwerk, um festzustellen, ob Sie eine Richtlinie für Dienstverbindungen einrichten müssen.

Wenn für das Netzwerk, mit dem Sie die Valkey-Instanz erstellen, noch keine Richtlinie für Dienstverbindungen erstellt wurde, folgen Sie der Anleitung unter Netzwerk, um eine zu erstellen.

Mehrzoneninstanz erstellen

In diesem Abschnitt finden Sie eine Anleitung zum Erstellen einer Instanz mit mehreren Zonen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf Instanz erstellen.

  3. Geben Sie im Abschnitt Instanz benennen eine ID für die Instanz ein. Die Instanz-ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Er muss außerdem mit einem Buchstaben beginnen und in seiner Region eindeutig sein.

  4. Wählen Sie im Menü Region eine Region für die Instanz aus.

  5. Wählen Sie im Abschnitt Zonale Verfügbarkeit die Option Mehrere Zonen aus, da Sie eine multizonale Instanz erstellen möchten.

  6. Geben Sie im Abschnitt Clustermodus an, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus wünschen. Weitere Informationen zu diesen Instanztypen finden Sie unter Clustermodus aktivieren und deaktivieren.

  7. Wählen Sie im Abschnitt Knotentyp einen Knotentyp aus.

  8. Geben Sie im Abschnitt Instanzgröße die Anzahl der Shards für Ihre Instanz ein. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Weitere Informationen zu Instanzspezifikationen finden Sie unter Instanz- und Knotenspezifikation.

  9. Wenn Sie eine Instanz mit Replikaten erstellen möchten, wählen Sie im Abschnitt Replikate die Anzahl der Replikate (pro Shard) aus. Sie können 0–5 Replikate auswählen. Der Standardwert ist 1 Replikat.

  10. Wählen Sie im Abschnitt Verbindung einrichten das Netzwerk aus, über das Ihre Anwendungen eine Verbindung zu dieser Instanz herstellen können. Weitere Informationen zu privaten Netzwerken für Memorystore for Valkey finden Sie unter Netzwerke.

  11. Wenn Sie die Sicherheit Ihrer Instanz erhöhen möchten, führen Sie im Abschnitt Sicherheit einen der folgenden Schritte aus:

    • Wenn Sie die IAM-Authentifizierung aktivieren möchten, wählen Sie die Option IAM-Authentifizierung aus. Memorystore for Valkey verwendet die IAM-Authentifizierung, um den Zugriff auf die Instanz einzuschränken.

    • Wenn Sie die einfache tokenbasierte Authentifizierung aktivieren möchten, wählen Sie die Option Token Auth aus. Memorystore for Valkey schränkt den Zugriff auf die Instanz ein, indem Clients ihre Authentifizierungstokens verwenden, um ihre Identitäten in Ihren Anwendungen zu bestätigen.

    • Wenn Sie die IAM-Authentifizierung oder die einfache tokenbasierte Authentifizierung nicht aktivieren möchten, wählen Sie die Option Deaktiviert aus.

    Wenn Sie die Option IAM-Authentifizierung oder Token-Authentifizierung auswählen, aktiviert Memorystore for Valkey automatisch das Kästchen Verschlüsselung während der Übertragung (TLS) aktivieren und der Abschnitt Verwaltung der Zertifizierungsstelle wird angezeigt. Memorystore for Valkey verschlüsselt Ihre Anmeldedaten, damit sie bei der Übertragung von der Instanz zur Anwendung vertraulich bleiben.

  12. Wählen Sie im Abschnitt Verwaltung der Zertifizierungsstelle die Option Instanzspezifische Zertifizierungsstelle, Vom Kunden verwaltete Zertifizierungsstelle oder Gemeinsame Zertifizierungsstelle aus. Diese Optionen stellen die Zertifizierungsstellenmodi für Ihre Instanz dar. Der CA-Modus bestimmt, welche CA-Hierarchie zum Ausstellen der digitalen Zertifikate für die Instanz verwendet wird.

    Wenn Sie die Option Vom Kunden verwaltete Zertifizierungsstelle auswählen, müssen Sie einen CA-Pool hinzufügen. Ein CA-Pool ist eine Sammlung mehrerer Zertifizierungsstellen mit einer gemeinsamen Richtlinie für das Ausstellen von Zertifikaten sowie einer IAM-Richtlinie (Identity and Access Management). Ein CA-Pool vereinfacht die Verwaltung der CA-Rotation und ermöglicht es Ihnen, eine höhere Gesamtzahl effektiver Abfragen pro Sekunde (QPS) zu erreichen.

    Führen Sie einen der folgenden Schritte aus, um einen CA-Pool hinzuzufügen:

    1. Wenn Sie einen CA-Pool aus einem anderen Google Cloud -Projekt hinzufügen möchten, setzen Sie ein Häkchen bei Zertifizierungsstelle aus einem anderen Projekt hinzufügen und geben Sie dann die Ressourcen-ID für den Pool in das Textfeld ein.

    2. Wenn Sie einen CA-Pool hinzufügen möchten, der sich im selben Google Cloud -Projekt wie das Projekt befindet, das Sie zum Erstellen der Instanz verwenden, wählen Sie den Pool im Menü CA-Pool aus.

  13. Wählen Sie im Bereich Verschlüsselung eine der folgenden Optionen aus:

    • Von Google verwalteter Verschlüsselungsschlüssel: Google soll einen Schlüssel zum Verschlüsseln der Daten in der Instanz verwenden. Dies ist die Google-Standardverschlüsselung.

    • Cloud KMS-Schlüssel: Sie möchten die Verschlüsselung Ihrer Daten mit kundenverwalteten Verschlüsselungsschlüsseln (CMEKs) in Cloud Key Management Service (Cloud KMS) mit CMEK-integrierten Diensten wie Memorystore for Valkey verwalten.

      Wenn Sie diese Option auswählen, gehen Sie so vor:

      1. Wählen Sie im Menü Schlüsselverwaltungstyp die Option Cloud KMS aus.
      2. Wählen Sie im Menü Cloud KMS-Schlüssel auswählen einen CMEK aus.

  14. Wenn Sie der Instanz eine ACL-Richtlinie zuweisen möchten, wählen Sie im Abschnitt ACL-Richtlinie im Menü Richtlinie eine Richtlinie aus.

  15. Geben Sie im Abschnitt Datenpersistenzstrategie an, wie Memorystore for Valkey die Daten in Ihrer Instanz beibehalten soll. Zulässige Werte sind Keine Persistenz, Append Only File (AOF)-Persistenz und Memory Snapshot-Persistenz.

  16. Wenn Sie automatische Sicherungen für Ihre Instanz aktivieren möchten, gehen Sie so vor:

    1. Klicken Sie das Kästchen Automatische tägliche Sicherungen an.
    2. Geben Sie im Feld Tage, die Sicherungen aufbewahrt werden sollen die Anzahl der Tage ein, die Memorystore for Valkey Sicherungen aufbewahren soll, bevor sie automatisch gelöscht werden. Sie können zwischen 1 und 365 Tagen angeben. Der Standardwert ist 35 Tage.
    3. Wählen Sie im Menü Zeitfenster eine Uhrzeit für die tägliche Sicherung aus.

  17. Wählen Sie im Bereich Wartung eine der folgenden Optionen aus:

    • Standard: Memorystore for Valkey aktualisiert Ihre Instanz regelmäßig, um sicherzustellen, dass der Dienst zuverlässig, leistungsfähig, sicher und auf dem neuesten Stand ist.
    • Benutzerdefiniert: Sie möchten den Wartungszeitplan für Ihre Instanz an die Anforderungen Ihrer Anwendung anpassen und Unterbrechungen minimieren. Wenn Sie diese Option auswählen, geben Sie den Tag an, an dem die Wartung erfolgen soll, und die Stunde, zu der das Wartungsfenster beginnen soll.

  18. Wählen Sie im Abschnitt Version auswählen Ihre Valkey-Version aus. Verfügbare Versionen sind 7.2, 8.0, 9.0 und 9.1. Die Standardversion ist Version 9.1.

  19. Klicken Sie auf Instanz erstellen.

gcloud

Führen Sie den Befehl create aus, um eine Memorystore for Valkey-Instanz zu erstellen:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Ersetzen Sie Folgendes:

  • INSTANCE ist die ID der Memorystore for Valkey-Instanz, die Sie erstellen. Die Instanz-ID muss 1 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.

  • REGION_ID ist die Region, in der die Instanz platziert werden soll.

  • PROJECT_ID ist die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • NETWORK_ID ist die ID des Netzwerks, das Sie zum Erstellen der Instanz verwenden möchten.

  • REPLICA_COUNT ist die Anzahl der Replikate (pro Shard). Zulässige Werte sind 0–5.

  • NODE_TYPE ist der Knotentyp, den Sie für die Instanz verwenden möchten.

  • ENGINE_VERSION ist die Version Ihrer Memorystore for Valkey-Instanz. Zulässige Werte für diesen Parameter sind VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 und VALKEY_9_1. Wenn Sie keinen Wert angeben, ist VALKEY_9_1 der Standardwert.

  • SHARD_COUNT bestimmt die Anzahl der Shards in Ihrer Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Instanzen mit deaktiviertem Clustermodus unterstützen nur einen Shard. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.

  • ACL_POLICY_NAME ist der Name der ACL-Richtlinie (Access Control List), die Sie der zu erstellenden Instanz zuweisen. Mit ACL-Richtlinien können Sie den Zugriff auf die Instanz sichern. Sie können eine detaillierte Sicherheit aktivieren, indem Sie den Nutzer- und Dienstzugriff auf bestimmte Schlüssel, Befehle und Pub/Sub-Kanäle beschränken. Weitere Informationen finden Sie unter Zugriff auf Instanzen mithilfe von ACL-Richtlinien sichern.

  • MODE bestimmt, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus erstellen. Wenn dieses Feld weggelassen wird, wird die Instanz standardmäßig auf „Clustermodus aktiviert“ gesetzt. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.

Beispiel:

Beispiel für aktivierten Clustermodus


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--acl-policy=my-acl-policy \
--mode=cluster

Beispiel für deaktivierten Clustermodus


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--acl-policy=my-acl-policy \
--mode=cluster-disabled

Standardmäßig ist die Verschlüsselung während der Übertragung deaktiviert und das autorisierte Netzwerk ist default.

REST

Verwenden Sie den folgenden REST API-Befehl, um eine Instanz mit mehreren Zonen zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • REGION_ID: die Region, in der sich die Instanz befinden soll.

    Sie können Instanzen nur in den unterstützten Regionen für Memorystore for Valkey erstellen.

  • INSTANCE_ID: die ID der Instanz, die Sie erstellen. Die Instanz-ID muss 1 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.
  • SHARD_COUNT: die Anzahl der Shards in der Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Instanzen mit deaktiviertem Clustermodus unterstützen nur einen Shard. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.
  • REPLICA_COUNT: die Anzahl der Replikate (pro Shard). Zulässige Werte sind 0 bis 5.

  • NODE_TYPE: der Knotentyp, den Sie für die Instanz verwenden möchten. Weitere Informationen finden Sie unter Knotentyp auswählen.

  • ENGINE_VERSION: die Version der Instanz. Zulässige Werte sind VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 und VALKEY_9_1. Wenn Sie keinen Wert angeben, ist VALKEY_9_1 der Standardwert.

  • MODE: der Modus der Instanz. Dieser Wert bestimmt, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus erstellen. Wenn Sie diesen Wert weglassen, wird für die Instanz standardmäßig der Clustermodus aktiviert. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.
  • ACL_POLICY_NAME: der Name der ACL-Richtlinie (Access Control List), die Sie der zu erstellenden Instanz zuweisen. Mit ACL-Richtlinien können Sie den Zugriff auf die Instanz sichern. Sie können eine detaillierte Sicherheit aktivieren, indem Sie den Nutzer- und Dienstzugriff auf bestimmte Schlüssel, Befehle und Pub/Sub-Kanäle beschränken. Weitere Informationen finden Sie unter Zugriff auf Instanzen mithilfe von ACL-Richtlinien sichern.
  • NETWORK_ID: die ID des Netzwerks für die Instanz.

HTTP-Methode und URL: 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

JSON-Text anfordern:

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Einzelzoneninstanz erstellen

In diesem Abschnitt finden Sie eine Anleitung zum Erstellen einer Instanz mit einer einzelnen Zone.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf Instanz erstellen.

  3. Geben Sie im Abschnitt Instanz benennen eine ID für die Instanz ein. Die Instanz-ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Er muss außerdem mit einem Buchstaben beginnen und in seiner Region eindeutig sein.

  4. Wählen Sie im Menü Region eine Region für die Instanz aus.

  5. Führen Sie im Abschnitt Zonale Verfügbarkeit folgende Schritte aus:

    1. Wählen Sie die Option Einzelne Zone aus.

    2. Wählen Sie im Menü Zone die Zone aus, in der Memorystore for Valkey die Instanz erstellen soll.

  6. Geben Sie im Abschnitt Clustermodus an, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus wünschen. Weitere Informationen zu diesen Instanztypen finden Sie unter Clustermodus aktivieren und deaktivieren.

  7. Wählen Sie im Abschnitt Knotentyp einen Knotentyp aus.

  8. Geben Sie im Abschnitt Instanzgröße die Anzahl der Shards für Ihre Instanz ein. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Weitere Informationen zu Instanzspezifikationen finden Sie unter Instanz- und Knotenspezifikation.

  9. Wenn Sie eine Instanz mit Replikaten erstellen möchten, wählen Sie im Abschnitt Replikate die Anzahl der Replikate (pro Shard) aus. Sie können 0–5 Replikate auswählen. Der Standardwert ist 1 Replikat.

  10. Wählen Sie im Abschnitt Verbindung einrichten das Netzwerk aus, über das Ihre Anwendungen eine Verbindung zu dieser Instanz herstellen können. Weitere Informationen zu privaten Netzwerken für Memorystore for Valkey finden Sie unter Netzwerke.

  11. Wenn Sie die Sicherheit Ihrer Instanz erhöhen möchten, führen Sie im Abschnitt Sicherheit einen der folgenden Schritte aus:

    • Wenn Sie die IAM-Authentifizierung aktivieren möchten, wählen Sie die Option IAM-Authentifizierung aus. Memorystore for Valkey verwendet die IAM-Authentifizierung, um den Zugriff auf die Instanz einzuschränken.

    • Wenn Sie die einfache tokenbasierte Authentifizierung aktivieren möchten, wählen Sie die Option Token Auth aus. Memorystore for Valkey schränkt den Zugriff auf die Instanz ein, indem Clients ihre Authentifizierungstokens verwenden, um ihre Identitäten in Ihren Anwendungen zu bestätigen.

    • Wenn Sie die IAM-Authentifizierung oder die einfache tokenbasierte Authentifizierung nicht aktivieren möchten, wählen Sie die Option Deaktiviert aus.

    Wenn Sie die Option IAM-Authentifizierung oder Token-Authentifizierung auswählen, aktiviert Memorystore for Valkey automatisch das Kästchen Verschlüsselung während der Übertragung (TLS) aktivieren und der Abschnitt Verwaltung der Zertifizierungsstelle wird angezeigt. Memorystore for Valkey verschlüsselt Ihre Anmeldedaten, damit sie bei der Übertragung von der Instanz zur Anwendung vertraulich bleiben.

  12. Wählen Sie im Abschnitt Verwaltung der Zertifizierungsstelle die Option Instanzspezifische Zertifizierungsstelle, Vom Kunden verwaltete Zertifizierungsstelle oder Gemeinsame Zertifizierungsstelle aus. Diese Optionen stellen die Zertifizierungsstellenmodi für Ihre Instanz dar. Der CA-Modus bestimmt, welche CA-Hierarchie zum Ausstellen der digitalen Zertifikate für die Instanz verwendet wird.

    Wenn Sie die Option Vom Kunden verwaltete Zertifizierungsstelle auswählen, müssen Sie einen CA-Pool hinzufügen. Ein CA-Pool ist eine Sammlung mehrerer Zertifizierungsstellen mit einer gemeinsamen Richtlinie für das Ausstellen von Zertifikaten sowie einer IAM-Richtlinie (Identity and Access Management). Ein CA-Pool vereinfacht die Verwaltung der CA-Rotation und ermöglicht es Ihnen, eine höhere Gesamtzahl effektiver Abfragen pro Sekunde (QPS) zu erreichen.

    Führen Sie einen der folgenden Schritte aus, um einen CA-Pool hinzuzufügen:

    1. Wenn Sie einen CA-Pool aus einem anderen Google Cloud -Projekt hinzufügen möchten, aktivieren Sie das Kästchen Zertifizierungsstelle aus einem anderen Projekt hinzufügen und geben Sie dann die Ressourcen-ID für den Pool in das Textfeld ein.

    2. Wenn Sie einen CA-Pool hinzufügen möchten, der sich im selben Google Cloud -Projekt wie das Projekt befindet, das Sie zum Erstellen der Instanz verwenden, wählen Sie den Pool im Menü CA-Pool aus.

  13. Wählen Sie im Bereich Verschlüsselung eine der folgenden Optionen aus:

    • Von Google verwalteter Verschlüsselungsschlüssel: Google soll einen Schlüssel zum Verschlüsseln der Daten in der Instanz verwenden. Dies ist die Google-Standardverschlüsselung.

    • Cloud KMS-Schlüssel: Sie möchten die Verschlüsselung Ihrer Daten mit kundenverwalteten Verschlüsselungsschlüsseln (CMEKs) in Cloud Key Management Service (Cloud KMS) mit CMEK-integrierten Diensten wie Memorystore for Valkey verwalten.

      Wenn Sie diese Option auswählen, gehen Sie so vor:

      1. Wählen Sie im Menü Schlüsselverwaltungstyp die Option Cloud KMS aus.
      2. Wählen Sie im Menü Cloud KMS-Schlüssel auswählen einen CMEK aus.

  14. Wenn Sie der Instanz eine ACL-Richtlinie zuweisen möchten, wählen Sie im Abschnitt ACL-Richtlinie im Menü Richtlinie eine Richtlinie aus.

  15. Geben Sie im Abschnitt Datenpersistenzstrategie an, wie Memorystore for Valkey die Daten in Ihrer Instanz beibehalten soll. Zulässige Werte sind Keine Persistenz, Append Only File (AOF)-Persistenz und Memory Snapshot-Persistenz.

  16. Wenn Sie automatische Sicherungen für Ihre Instanz aktivieren möchten, gehen Sie so vor:

    1. Klicken Sie das Kästchen Automatische tägliche Sicherungen an.
    2. Geben Sie im Feld Tage, die Sicherungen aufbewahrt werden sollen die Anzahl der Tage ein, die Memorystore for Valkey Sicherungen aufbewahren soll, bevor sie automatisch gelöscht werden. Sie können zwischen 1 und 365 Tagen angeben. Der Standardwert ist 35 Tage.
    3. Wählen Sie im Menü Zeitfenster eine Uhrzeit für die tägliche Sicherung aus.

  17. Wählen Sie im Bereich Wartung eine der folgenden Optionen aus:

    • Standard: Memorystore for Valkey aktualisiert Ihre Instanz regelmäßig, um sicherzustellen, dass der Dienst zuverlässig, leistungsfähig, sicher und auf dem neuesten Stand ist.
    • Benutzerdefiniert: Sie möchten den Wartungszeitplan für Ihre Instanz an die Anforderungen Ihrer Anwendung anpassen und Unterbrechungen minimieren. Wenn Sie diese Option auswählen, geben Sie den Tag an, an dem die Wartung erfolgen soll, und die Stunde, zu der das Wartungsfenster beginnen soll.

  18. Wählen Sie im Abschnitt Version auswählen Ihre Valkey-Version aus. Verfügbare Versionen sind 7.2, 8.0, 9.0 und 9.1. Die Standardversion ist Version 9.1.

  19. Klicken Sie auf Instanz erstellen.

gcloud

Führen Sie den Befehl create aus, um eine Instanz mit einer einzelnen Zone zu erstellen:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Ersetzen Sie Folgendes:

  • INSTANCE ist die ID der Memorystore for Valkey-Instanz, die Sie erstellen. Die Instanz-ID muss 1 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.

  • REGION_ID ist die Region, in der die Instanz platziert werden soll.

  • PROJECT_ID ist die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • NETWORK_ID ist die ID des Netzwerks, das Sie zum Erstellen der Instanz verwenden möchten.

  • REPLICA_COUNT ist die Anzahl der Replikate (pro Shard). Zulässige Werte sind 0–5.

  • NODE_TYPE ist der Knotentyp, den Sie für die Instanz verwenden möchten.

  • ENGINE_VERSION ist die Version Ihrer Memorystore for Valkey-Instanz. Zulässige Werte für diesen Parameter sind VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 und VALKEY_9_1. Wenn Sie keinen Wert angeben, ist VALKEY_9_1 der Standardwert.

  • SHARD_COUNT bestimmt die Anzahl der Shards in Ihrer Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Wenn Sie den Clustermodus deaktivieren, können Sie nur einen Shard für Ihre Instanz angeben. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.

  • ZONE_DISTRIBUTION_CONFIG_MODE ist der Modus, in dem Sie zwischen der Bereitstellung einer Instanz mit einer einzelnen Zone oder einer Instanz mit mehreren Zonen wählen können. Der Standardwert ist multi-zone. Zulässige Werte sind single-zone und multi-zone.

  • ZONE ist die Zone, in der Sie Ihre Knoten bereitstellen möchten. Dieses Flag ist nur anwendbar, wenn Sie --zone-distribution-config-mode auf single-zone festlegen.

  • ACL_POLICY_NAME ist der Name der ACL-Richtlinie (Access Control List), die Sie der zu erstellenden Instanz zuweisen. Mit ACL-Richtlinien können Sie den Zugriff auf die Instanz sichern. Sie können eine detaillierte Sicherheit aktivieren, indem Sie den Nutzer- und Dienstzugriff auf bestimmte Schlüssel, Befehle und Pub/Sub-Kanäle beschränken. Weitere Informationen finden Sie unter Zugriff auf Ihre Instanzen mithilfe von ACL-Richtlinien sichern.

  • MODE bestimmt, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus erstellen. Wenn Sie dieses Feld weglassen, wird standardmäßig der Clustermodus aktiviert. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.

REST

Verwenden Sie den folgenden REST API-Befehl, um eine Instanz mit einer einzelnen Zone zu erstellen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • REGION_ID: die Region, in der sich die Instanz befinden soll.

    Sie können Instanzen nur in den unterstützten Regionen für Memorystore for Valkey erstellen.

  • INSTANCE_ID: die ID der Instanz, die Sie erstellen. Die Instanz-ID muss 1 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.
  • SHARD_COUNT: die Anzahl der Shards in der Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Instanzen mit deaktiviertem Clustermodus unterstützen nur einen Shard. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.
  • REPLICA_COUNT: die Anzahl der Replikate (pro Shard). Zulässige Werte sind 0 bis 5.

  • NODE_TYPE: der Knotentyp, den Sie für die Instanz verwenden möchten. Weitere Informationen finden Sie unter Knotentyp auswählen.

  • ENGINE_VERSION: die Version der Instanz. Zulässige Werte sind VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 und VALKEY_9_1. Wenn Sie keinen Wert angeben, ist VALKEY_9_1 der Standardwert.

  • MODE: der Modus der Instanz. Dieser Wert bestimmt, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Clustermodus erstellen. Wenn Sie diesen Wert weglassen, wird für die Instanz standardmäßig der Clustermodus aktiviert. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.
  • ACL_POLICY_NAME: der Name der ACL-Richtlinie (Access Control List), die Sie der zu erstellenden Instanz zuweisen. Mit ACL-Richtlinien können Sie den Zugriff auf die Instanz sichern. Sie können eine detaillierte Sicherheit aktivieren, indem Sie den Nutzer- und Dienstzugriff auf bestimmte Schlüssel, Befehle und Pub/Sub-Kanäle beschränken. Weitere Informationen finden Sie unter Zugriff auf Instanzen mithilfe von ACL-Richtlinien sichern.
  • ZONE: die Zone, in der Sie die Instanz erstellen möchten.
  • NETWORK_ID: die ID des Netzwerks für die Instanz.

HTTP-Methode und URL: 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

JSON-Text anfordern:

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "zoneDistributionConfig": {
    "mode": "SINGLE_ZONE",
    "zone": "ZONE"
  },
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}