下载和配置 Amazon CLI 将 Amazon CLI 与全局数据存储结合使用

使用全局数据存储 (CLI)

您可以使用 Amazon Command Line Interface (Amazon CLI) 从命令行管理多个 Amazon 服务并通过脚本自动执行这些服务。您可以使用 Amazon CLI 执行临时（一次性）操作。

下载和配置 Amazon CLI

Amazon CLI 在 Windows、macOS 或 Linux 上运行。按照以下步骤下载和并对其进行配置。

下载、安装和配置 CLI

在 Amazon Command Line Interface 网页上下载 Amazon CLI。
按照 Amazon Command Line Interface 用户指南中的说明安装 Amazon CLI 和配置 Amazon CLI。

将 Amazon CLI 与全局数据存储结合使用

使用以下 CLI 操作来处理全局数据存储：

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 ElastiCache 会在全局数据存储 ID 被创建时自动对其应用前缀。每个 Amazon 区域有自己的前缀。例如，在美国西部（北加利福尼亚）区域创建的全局数据存储 ID 以“virxk”和您提供的后缀名称开头。后缀与自动生成的前缀相结合，保证了全局数据存储名称在多个区域中的唯一性。

下表列出了每个 Amazon 区域及其全局数据存储 ID 前缀。

区域名称/区域	Prefix
美国东部（俄亥俄州）区域 `us-east-2`	`fpkhr`
美国东部（弗吉尼亚州北部）区域 `us-east-1`	`ldgnf`
美国西部（北加利福尼亚）区域 `us-west-1`	`virxk`
美国西部（俄勒冈州）区域 `us-west-2`	`sgaui`
加拿大（中部）区域 `ca-central-1`	`bxodz`
亚太地区（孟买）区域 `ap-south-1`	`erpgt`
Asia Pacific（Tokyo）Region `ap-northeast-1`	`quwsw`
亚太地区（首尔）区域 `ap-northeast-2`	`lfqnh`
亚太地区（大阪）区域 `ap-northeast-3`	`nlapn`
亚太地区（新加坡）区域 `ap-southeast-1`	`vlqxn`
亚太地区（悉尼）区域 `ap-southeast-2`	`vbgxd`
欧洲地区（法兰克福）区域 `eu-central-1`	`iudkw`
欧洲地区（爱尔兰）区域 `eu-west-1`	`gxeiz`
欧洲地区（伦敦）区域 `eu-west-2`	`okuqm`
欧洲（巴黎）区域 `eu-west-3`	`fgjhi`
南美洲（圣保罗）区域 `sa-east-1`	`juxlw`
中国（北京）区域 `cn-north-1`	`emvgo`
中国（宁夏）区域 `cn-northwest-1`	`ckbem`
亚太地区（香港）区域 `ap-east-1`	`knjmp`
Amazon GovCloud（美国西部） `us-gov-west-1`	`sgwui`

create-replication-group – 使用此操作可通过向 --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 
```
当调用此操作并传入 --global-replication-group-id 值时，ElastiCache 会从全局复制组的主复制组中推断下列参数的值。请勿传入这些参数的值：

"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

ElastiCache GlobalDataStore 的 Redis 到 OSS Valkey 跨引擎升级

您可以使用控制台、API 或 CLI 将现有 Redis OSS 全局复制组升级到 Valkey。

如果您有现成的 Redis OSS 全局复制组，您可以使用 modify-global-replication-group API 指定新引擎和引擎版本，从而升级到 Valkey。

对于 Linux、macOS 或 Unix：


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

对于 Windows：


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

如果您对要升级的现有 Redis OSS 全局复制组应用了自定义缓存参数组，则还需要在请求中传递自定义 Valkey 缓存参数组。输入 Valkey 自定义参数组必须具有与现有 Redis OSS 自定义参数组相同的 Redis OSS 静态参数值。

对于 Linux、macOS 或 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

对于 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 Amazon 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 Amazon 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-replication-group


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

使用 help 列出 ElastiCache for Valkey 或 ElastiCache for Redis OSS 的所有可用命令。


aws elasticache help

您还可以使用帮助来描述特定命令并了解有关其用法的详细信息：


aws elasticache create-global-replication-group help

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

使用全局数据存储（控制台）

使用复制组时的高可用性