使用全域資料存放區 (CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 從命令列控制多個 AWS 服務，並透過指令碼將其自動化。您可以使用 AWS CLI 進行臨機操作（一次性）。

下載和設定 AWS CLI

AWS CLI 會在 Windows、macOS 或 Linux 上執行。請使用下列程序來下載並進行設定。

若要下載、安裝和設定 CLI

在AWS 命令列界面網頁上下載 AWS CLI。
請遵循 AWS Command Line Interface 使用者指南CLI中的安裝 AWS CLI 和設定 AWS 的指示。

搭配全域資料存放區使用 AWS CLI

使用下列CLI操作來使用全域資料存放區：


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。每個 AWS 區域都有自己的字首。例如，在美國西部 (加利佛尼亞北部) 區域建立的全域資料儲存 ID 都以 "virxk" 開頭，加上您提供的尾碼名稱。尾碼與自動產生的字首結合，可保證跨多個區域的全域資料存放區名稱保持唯一性。

下表列出每個 AWS 區域及其全域資料存放區 ID 字首。

區域名稱/區域	字首
美國東部 (俄亥俄) 區域 `us-east-2`	`fpkhr`
美國東部 (維吉尼亞北部) 區域 `us-east-1`	`ldgnf`
美國西部 (加利佛尼亞北部) 區域 `us-west-1`	`virxk`
美國西部 (奧勒岡) 區域 `us-west-2`	`sgaui`
加拿大 (中部) 區域 `ca-central-1`	`bxodz`
亞太 (孟買) 區域 `ap-south-1`	`erpgt`
亞太區域 (東京) 區域 `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`
AWS 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

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

您可以使用主控台或，將現有的 Redis API OSS全域複寫群組升級至 ValkeyCLI。

如果您有現有的 Redis OSS全域複寫群組，您可以使用指定新的引擎和引擎版本 modify-global-replication-group，升級至 ValkeyAPI。

若為 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 OSS自訂參數群組具有相同的 Redis 靜態參數值。

若為 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 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-replication-group


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

使用說明列出 ElastiCache 適用於 Valkey 或 Redis 的所有可用命令OSS。


aws elasticache help

您還可以使用說明來描述特定命令，並了解更多關於它的用法：


aws elasticache create-global-replication-group help

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用全域資料存放區 (主控台)

使用複寫群組的高可用性