Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation des entrepôts de données globaux (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour contrôler plusieurs AWS services à partir de la ligne de commande et les automatiser par le biais de scripts. Vous pouvez utiliser la AWS CLI pour des opérations ad hoc (ponctuelles).
## Téléchargement et configuration du AWS CLI
Il AWS CLI fonctionne sous Windows, macOS ou Linux. Suivez la procédure suivante pour la télécharger et la configurer.
**Pour télécharger, installer et configurer la CLI**
1. Téléchargez la AWS CLI sur la page Web de l'[interface de ligne de AWS commande](https://aws.amazon.com/cli).
1. Suivez les instructions d'installation de la AWS CLI et de configuration de la AWS CLI dans le *guide de AWS Command Line Interface l'utilisateur*.
## Utilisation de la AWS CLI avec des banques de données globales
Utilisez les opérations de la CLI suivantes pour utiliser les magasins de données globaux :
+ [create-global-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-global-replication-group.html)
```
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 applique ElastiCache automatiquement un préfixe à l'identifiant global de la banque de données lors de sa création. Chaque AWS région possède son propre préfixe. Par exemple, un ID d'entrepôt de données global créé dans la région USA Ouest (Californie du Nord) commence par « virxk » avec le nom de suffixe que vous fournissez. Le suffixe, combiné au préfixe autogénéré, garantit l'unicité du nom de l'entrepôt de données global dans plusieurs régions.
Le tableau suivant répertorie chaque AWS région et son préfixe d'ID de banque de données global.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/Redis-Global-Datastores-CLI.html)
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)— Utilisez cette opération pour créer des clusters secondaires pour une banque de données globale en fournissant le nom de la banque de données globale au `--global-replication-group-id` paramètre.
```
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
```
Lorsque vous appelez cette opération et que vous `--global-replication-group-id` transmettez une valeur, les valeurs ElastiCache seront déduites du groupe de réplication principal du groupe de réplication global pour les paramètres suivants. Ne transmettez pas de valeurs pour ces paramètres :
`"PrimaryClusterId",`
`"AutomaticFailoverEnabled",`
` "NumNodeGroups",`
` "CacheParameterGroupName",`
` "CacheNodeType",`
` "Engine",`
` "EngineVersion",`
` "CacheSecurityGroupNames",`
` "EnableTransitEncryption",`
` "AtRestEncryptionEnabled",`
` "SnapshotArns",`
` "SnapshotName"`
+ [describe-global-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-global-replication-groups.html)
```
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](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-global-replication-group.html)
```
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
```
**Mise à niveau multimoteur de Redis vers OSS Valkey pour ElastiCache GlobalDataStore**
Vous pouvez mettre à niveau un groupe de réplication global Redis OSS existant vers Valkey à l'aide de la console, de l'API ou de la CLI.
Si vous disposez d'un groupe de réplication global Redis OSS existant, vous pouvez passer à Valkey en spécifiant le nouveau moteur et la nouvelle version du moteur avec modify-global-replication-group l'API.
Pour Linux, macOS ou Unix :
```
aws elasticache modify-global-replication-group \
--global-replication-group-id myGlobalReplGroup \
--engine valkey \
--apply-immediately \
--engine-version 8.0
```
Pour Windows :
```
aws elasticache modify-global-replication-group ^
--global-replication-group-id myGlobalReplGroup ^
--engine valkey ^
--apply-immediately ^
--engine-version 8.0
```
Si un groupe de paramètres de cache personnalisé est appliqué au groupe de réplication global Redis OSS existant que vous souhaitez mettre à niveau, vous devrez également transmettre un groupe de paramètres de cache Valkey personnalisé dans la demande. Le groupe de paramètres personnalisés Valkey en entrée doit avoir les mêmes valeurs de paramètres statiques Redis OSS que le groupe de paramètres personnalisés Redis OSS existant.
Pour Linux, macOS ou 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
```
Pour 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](https://docs.aws.amazon.com/cli/latest/reference/elasticache/delete-global-replication-group.html)
```
aws elasticache delete-global-replication-group \
--global-replication-group-id my global datastore \
--retain-primary-replication-group defaults to true
```
+ [disassociate-global-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/disassociate-global-replication-group.html)
```
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](https://docs.aws.amazon.com/cli/latest/reference/elasticache/failover-global-replication-group.html)
```
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](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-node-groups-in-global-replication-group.html)
```
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](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-node-groups-in-global-replication-group.html)
```
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-groupe de réplication](https://docs.aws.amazon.com/cli/latest/reference/elasticache/rebalance-slots-in-global-replication-group.html)
```
aws elasticache rebalance-shards-in-global-replication-group \
--apply-immediately yes \
--global-replication-group-id global-replication-group-name
```
Utilisez l'aide pour répertorier toutes les commandes disponibles ElastiCache pour Valkey ou Redis OSS.
```
aws elasticache help
```
Vous pouvez également utiliser l'aide pour décrire une commande spécifique et en savoir plus sur son utilisation :
```
aws elasticache create-global-replication-group help
```