使用全局数据存储 (CLI) - Amazon ElastiCache for Redis
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

使用全局数据存储 (CLI)

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

下载和配置 Amazon CLI

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

下载、安装和配置 CLI

  1. Amazon Command Line Interface 网页上下载 Amazon CLI。

  2. 按照 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 以“dsdfu”和您提供的后缀名称开头。后缀与自动生成的前缀相结合,保证了全局数据存储名称在多个区域中的唯一性。

    下表列出了每个 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-id global 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-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
  • 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

使用帮助列出 ElastiCache for Redis 的所有可用命令。

aws elasticache help

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

aws elasticache create-global-replication-group help