Verwendung globaler Datenspeicher () CLI - Amazon ElastiCache
Herunterladen und Konfigurieren der AWS CLIVerwenden von 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.

Verwendung 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 das 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.

Um das herunterzuladen, zu installieren und zu konfigurieren CLI

  1. Laden Sie die Webseite AWS CLI auf der AWS Befehlszeilenschnittstelle herunter.

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

Verwenden von 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 US West (N. California)

    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 Valkey für OSS ElastiCache GlobalDataStore

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

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

    Für Linux, macOS oder Unix:

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

    Für Windows:

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

    Wenn Sie eine benutzerdefinierte Cache-Parametergruppe auf die bestehende OSS globale Redis-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 OSS statischen Redis-Parameterwerte haben wie die vorhandene benutzerdefinierte OSS Redis-Parametergruppe.

    Für Linux, macOS oder Unix:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 7.2 \
   --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 7.2 ^
   --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 für ElastiCache Valkey oder Redis aufzulisten. OSS

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