本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用全局数据存储 (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-idsample-repl-group
\ --global-replication-group-descriptionan 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
亚太地区(东京)区域
ap-northeast-1
quwsw
亚太地区(首尔)区域
ap-northeast-2
lfqnh
亚太地区(大阪)区域
ap-northeast-3
nlapn
亚太地区(新加坡)区域
ap-southeast-1
vlqxn
亚太地区(悉尼)区域
ap-southeast-2
vbgxd
欧洲地区(法兰克福)区域
eu-central-1
iudkw
Europe (Ireland) Region
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-idglobal datastore name
当调用此操作并传入
--global-replication-group-id
值时,ElastiCache for Redis 会从全局复制组的主复制组中推断下列参数的值。请勿传入这些参数的值:"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-infoan 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-typenode type
\ --cache-parameter-group-nameparameter group name
\ --engine-versionengine version
\ -—apply-immediately \ --global-replication-group-descriptiondescription
-
delete-global-replication-group
aws elasticache delete-global-replication-group \ --global-replication-group-id
my global datastore
\ --retain-primary-replication-groupdefaults to true
-
disassociate-global-replication-group
aws elasticache disassociate-global-replication-group \ --global-replication-group-id
my global datastore
\ --replication-group-idmy secondary cluster
\ --replication-group-regionthe 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-regionThe Amazon Region of the primary cluster
\ --primary-replication-group-idThe 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-idglobal-replication-group-name
\ --node-group-count3
-
decrease-node-groups-in-global-replication-group
aws elasticache decrease-node-groups-in-global-replication-group \ --apply-immediately
yes
\ --global-replication-group-idglobal-replication-group-name
\ --node-group-count3
-
rebalance-shards-in-global-replication-group
aws elasticache rebalance-shards-in-global-replication-group \ --apply-immediately
yes
\ --global-replication-group-idglobal-replication-group-name
使用帮助列出 ElastiCache for Redis 的所有可用命令。
aws elasticache help
您还可以使用帮助来描述特定命令并了解有关其用法的详细信息:
aws elasticache create-global-replication-group help