Verwenden globaler Datenspeicher (CLI) - Amazon ElastiCache
Herunterladen und Konfigurieren der AWS CLIVerwenden der AWS CLI mit globalen Datenspeichern

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden globaler Datenspeicher (CLI)

Sie können die AWS Command Line Interface (AWS CLI) verwenden, um mehrere AWS Dienste von der Befehlszeile aus zu steuern und sie mithilfe von Skripten zu automatisieren. Sie können die AWS CLI für (einmalige) Ad-hoc-Operationen verwenden.

Herunterladen und Konfigurieren der AWS CLI

Das AWS CLI läuft unter Windows, MacOS oder Linux. Gehen Sie folgendermaßen vor, um sie herunterzuladen und zu konfigurieren.

So laden Sie den CLI herunter, installieren und konfigurieren ihn

  1. Laden Sie die AWS CLI von der Webseite mit der AWS Befehlszeilenschnittstelle herunter.

  2. Folgen Sie den Anweisungen zur Installation der AWS CLI und zur Konfiguration der AWS CLI im AWS Command Line Interface Benutzerhandbuch.

Verwenden der AWS CLI mit globalen Datenspeichern

Verwenden Sie die folgenden CLI-Operationen, um mit globalen Datenspeichern zu arbeiten:

  • create-global-replication-group

    aws elasticache create-global-replication-group \
   --global-replication-group-id-suffix my global datastore  \
   --primary-replication-group-id sample-repl-group  \
   --global-replication-group-description an optional description of the global datastore

    Amazon wendet ElastiCache automatisch ein Präfix auf die globale Datenspeicher-ID an, wenn sie erstellt wird. Jede AWS Region hat ihr eigenes Präfix. Beispielsweise beginnt eine globale Datenspeicher-ID, die in der Region USA West (Nordkalifornien) erstellt wurde, mit „virxk“ zusammen mit dem von Ihnen angegebenen Suffixnamen. Das Suffix in Kombination mit dem automatisch generierten Präfix garantiert die Eindeutigkeit des globalen Datenspeichernamens über mehrere Regionen hinweg.

    In der folgenden Tabelle sind jede AWS Region und ihr globales Datenspeicher-ID-Präfix aufgeführt.

    Regionsname/Region Präfix

    Region USA Ost (Ohio)

    us-east-2

    fpkhr

    Region USA Ost (Nord-Virginia)

    us-east-1

    ldgnf

    Region USA West (Nordkalifornien)

    us-west-1

    virxk

    Region USA West (Oregon)

    us-west-2

    sgaui

    Region Kanada (Zentral)

    ca-central-1

    bxodz

    Region Asien-Pazifik (Mumbai)

    ap-south-1

    erpgt

    Region Asien-Pazifik (Tokio)

    ap-northeast-1

    quwsw

    Region Asien-Pazifik (Seoul)

    ap-northeast-2

    lfqnh

    Region Asien-Pazifik (Osaka)

    ap-northeast-3

    nlapn

    Region Asien-Pazifik (Singapur)

    ap-southeast-1

    vlqxn

    Region Asien-Pazifik (Sydney)

    ap-southeast-2

    vbgxd

    Region Europa (Frankfurt)

    eu-central-1

    iudkw

    Region Europa (Irland)

    eu-west-1

    gxeiz

    Region Europa (London)

    eu-west-2

    okuqm

    Region Europa (Paris)

    eu-west-3

    fgjhi

    Region Südamerika (São Paulo)

    sa-east-1

    juxlw

    Region China (Peking)

    cn-north-1

    emvgo

    Region China (Ningxia)

    cn-northwest-1

    ckbem

    Region Asien-Pazifik (Hongkong)

    ap-east-1

    knjmp

    AWS GovCloud (USA West)

    us-gov-west-1

    		 sgwui

  • create-replication-group— Verwenden Sie diesen Vorgang, um sekundäre Cluster für einen globalen Datenspeicher zu erstellen, indem Sie den Namen des globalen Datenspeichers für den Parameter angeben. --global-replication-group-id

    aws elasticache create-replication-group \
  --replication-group-id secondary replication group name \
  --replication-group-description “Replication group description" \
  --global-replication-group-id global datastore name

    Wenn Sie diesen Vorgang aufrufen und einen --global-replication-group-id Wert übergeben, ElastiCache werden die Werte für die folgenden Parameter aus der primären Replikationsgruppe der globalen Replikationsgruppe abgeleitet. Übergeben Sie keine Werte für diese Parameter:

    "PrimaryClusterId",

    "AutomaticFailoverEnabled",

    "NumNodeGroups",

    "CacheParameterGroupName",

    "CacheNodeType",

    "Engine",

    "EngineVersion",

    "CacheSecurityGroupNames",

    "EnableTransitEncryption",

    "AtRestEncryptionEnabled",

    "SnapshotArns",

    "SnapshotName"

  • describe-global-replication-groups

    aws elasticache describe-global-replication-groups \
   --global-replication-group-id my global datastore  \
   --show-member-info an optional parameter that returns a list of the primary and secondary clusters that make up the global datastore

  • modify-global-replication-group

    aws elasticache modify-global-replication-group \
   --global-replication-group-id my global datastore  \
   --automatic-failover-enabled \
   --cache-node-type node type \
   --cache-parameter-group-name parameter group name \ 
   --engine-version engine version \
   -—apply-immediately \
   --global-replication-group-description description

    Engine-übergreifendes Upgrade von Redis auf OSS Valkey für ElastiCache GlobalDataStore

    Sie können eine bestehende globale Redis OSS-Replikationsgruppe mithilfe der Konsole, API oder CLI auf Valkey aktualisieren.

    Wenn Sie bereits über eine globale Redis OSS-Replikationsgruppe verfügen, können Sie ein Upgrade auf Valkey durchführen, indem Sie die neue Engine und die Engine-Version mit der API angeben. modify-global-replication-group

    Für Linux, macOS oder Unix:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --apply-immediately \
   --engine-version 8.0

    Für Windows:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --apply-immediately ^
   --engine-version 8.0

    Wenn Sie eine benutzerdefinierte Cache-Parametergruppe auf die bestehende globale Redis OSS-Replikationsgruppe angewendet haben, die Sie aktualisieren möchten, müssen Sie in der Anfrage auch eine benutzerdefinierte Valkey-Cache-Parametergruppe übergeben. Die benutzerdefinierte Valkey-Eingabeparametergruppe muss dieselben statischen Redis OSS-Parameterwerte haben wie die vorhandene benutzerdefinierte Redis OSS-Parametergruppe.

    Für Linux, macOS oder Unix:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 8.0 \
   --apply-immediately \
   --cache-parameter-group-name myParamGroup

    Für Windows:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 8.0 ^
   --apply-immediately ^
   --cache-parameter-group-name myParamGroup

  • delete-global-replication-group

    aws elasticache delete-global-replication-group \
   --global-replication-group-id my global datastore  \
   --retain-primary-replication-group defaults to true

  • disassociate-global-replication-group

    aws elasticache disassociate-global-replication-group \
   --global-replication-group-id my global datastore  \
   --replication-group-id my secondary cluster  \
   --replication-group-region the AWS Region in which the secondary cluster resides

  • failover-global-replication-group

    aws elasticache failover-replication-group \
   --global-replication-group-id my global datastore \
   --primary-region The AWS Region of the primary cluster \  
   --primary-replication-group-id  The name of the global datastore, including the suffix.

  • increase-node-groups-in-global-replication-group

    aws elasticache increase-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • decrease-node-groups-in-global-replication-group

    aws elasticache decrease-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • rebalance-shards-in-global-Replikationsgruppe

    aws elasticache rebalance-shards-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name

Verwenden Sie die Hilfe, um alle verfügbaren Befehle ElastiCache für Valkey oder Redis OSS aufzulisten.

aws elasticache help

Sie können die Hilfe auch verwenden, um einen bestimmten Befehl zu beschreiben und mehr über seine Verwendung zu erfahren: 

aws elasticache create-global-replication-group help