Uso de almacenes de datos globales (CLI)

Puede usar AWS Command Line Interface (AWS CLI) para controlar varios AWS servicios desde la línea de comandos y automatizarlos mediante scripts. Puede usar la AWS CLI para operaciones ad hoc (únicas).

Descargar y configurar el AWS CLI

Se AWS CLI ejecuta en Windows, macOS o Linux. Utilice el siguiente procedimiento para descargarlo y configurarlo.

Para descargar, instalar y configurar la CLI

1. Descargue la AWS CLI en la página web de la interfaz de línea de AWS comandos.

2. Siga las instrucciones para instalar la AWS CLI y configurar la AWS CLI de la Guía del AWS Command Line Interface usuario.

Uso de la AWS CLI con almacenes de datos globales

Utilice las siguientes operaciones de la CLI para trabajar con almacenes de datos globales:

• 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 aplica ElastiCache automáticamente un prefijo al ID del almacén de datos global cuando se crea. Cada AWS región tiene su propio prefijo. Por ejemplo, un ID de almacén de datos global creado en la región de oeste de EE. UU. (Norte de California) comienza con “virxk” junto con el nombre del sufijo que proporcione. El sufijo, en conjunto con el prefijo autogenerado, garantiza la exclusividad del nombre del almacén de datos global en varias regiones.

  En la siguiente tabla se muestra cada AWS región y su prefijo de ID de almacén de datos global.

  Nombre de la región/Región	Prefix
  Región del Este de EE. UU. (Ohio) us-east-2	fpkhr
  Región del Este de EE. UU (Norte de Virginia) us-east-1	ldgnf
  Región del Oeste de EE. UU (Norte de California) us-west-1	virxk
  Región del Oeste de EE. UU (Oregón) us-west-2	sgaui
  Región de Canadá (centro) ca-central-1	bxodz
  Región de Asia-Pacífico (Bombay) ap-south-1	erpgt
  Asia Pacífico (Tokio) ap-northeast-1	quwsw
  Región de Asia-Pacífico (Seúl) ap-northeast-2	lfqnh
  Región Asia-Pacífico (Osaka) ap-northeast-3	nlapn
  Región de Asia-Pacífico (Singapur) ap-southeast-1	vlqxn
  Región de Asia-Pacífico (Sídney) ap-southeast-2	vbgxd
  Región de Europa (Fráncfort) eu-central-1	iudkw
  Región de Europa (Irlanda) eu-west-1	gxeiz
  Región de Europa (Londres) eu-west-2	okuqm
  Región EU (París) eu-west-3	fgjhi
  Región de América del Sur (São Paulo) sa-east-1	juxlw
  Región China (Pekín) cn-north-1	emvgo
  Región China (Ningxia) cn-northwest-1	ckbem
  Región de Asia-Pacífico (Hong Kong) ap-east-1	knjmp
  AWS GovCloud (EE. UU.-Oeste) us-gov-west-1	sgwui

• create-replication-group— Utilice esta operación para crear clústeres secundarios para un almacén de datos global proporcionando el nombre del almacén de datos global al parámetro. --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 
  
  

  Al llamar a esta operación y pasar un --global-replication-group-id valor, ElastiCache (Redis OSS) deducirá los valores del grupo de replicación principal del grupo de replicación global para los siguientes parámetros. No ingrese valores para estos parámetros:

  "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 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-grupo de replicación

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

Utilice la ayuda para enumerar todos los comandos disponibles ElastiCache (Redis OSS).

aws elasticache help

También puede utilizar la ayuda para describir un comando específico y obtener más información sobre su uso:

aws elasticache create-global-replication-group help