As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Uso de datastores globais (CLI)
<a name="Redis-Global-Datastores-CLI"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para controlar vários AWS serviços na linha de comando e automatizá-los por meio de scripts. Você pode usar a AWS CLI para operações ad hoc (únicas). 

## Baixando e configurando o AWS CLI
<a name="Redis-Global-Datastores-Downloading-CLI"></a>

 AWS CLI É executado em Windows, macOS ou Linux. Use o procedimento a seguir para fazer download e configurá-la.

**Como fazer download, instalar e configurar a CLI**

1. Faça o download da AWS CLI na página da [interface da linha de AWS comando](https://aws.amazon.com/cli).

1. *Siga as instruções para instalar a AWS CLI e configurar a AWS CLI no Guia do usuário.AWS Command Line Interface *

## Usar o AWS CLI com datastores globais
<a name="Redis-Global-Datastores-Using-CLI"></a>

Use as seguintes operações da CLI para trabalhar com datastores globais: 
+ [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 }}
  ```

  A Amazon aplica ElastiCache automaticamente um prefixo ao ID global do armazenamento de dados quando ele é criado. Cada AWS região tem seu próprio prefixo. Por exemplo, um ID de datastore global criado na região Oeste dos EUA (Norte da Califórnia) começa com "virxk" junto com o nome do sufixo fornecido. O sufixo, combinado com o prefixo gerado automaticamente, garante a exclusividade do nome do datastore global em várias regiões. 

  A tabela a seguir lista cada AWS região e seu prefixo de ID de armazenamento de dados global.

    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/Redis-Global-Datastores-CLI.html)
+  [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html): use esta operação para criar clusters secundários para um datastore global fornecendo o nome do datastore global ao 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}}
  ```

  Ao chamar essa operação e passar um `--global-replication-group-id` valor, ElastiCache inferirá os valores do grupo de replicação principal do grupo de replicação global para os seguintes parâmetros. Não passe valores para estes parâmetros:

  `"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}}
  ```

  **Atualização de vários mecanismos do Redis para o OSS Valkey para ElastiCache GlobalDataStore**

  Você pode atualizar um grupo de replicação global do Redis OSS existente para o Valkey usando o Console, a API ou a CLI. 

  Se você tiver um grupo de replicação global do Redis OSS existente, poderá fazer a atualização para o Valkey especificando o novo mecanismo e a versão do mecanismo com a API modify-global-replication-group.

  Para Linux, macOS ou Unix:

  ```
  aws elasticache modify-global-replication-group \
     --global-replication-group-id myGlobalReplGroup \
     --engine valkey \
     --apply-immediately \
     --engine-version 8.0
  ```

  Para Windows:

  ```
  aws elasticache modify-global-replication-group ^
     --global-replication-group-id myGlobalReplGroup ^
     --engine valkey ^
     --apply-immediately ^
     --engine-version 8.0
  ```

  Se você tiver um grupo de parâmetros de cache personalizado aplicado ao grupo de replicação global do Redis OSS existente que deseja atualizar, também será necessário passar um grupo de parâmetros de cache personalizado do Valkey na solicitação. O grupo de parâmetros personalizados Valkey de entrada deve ter os mesmos valores de parâmetros estáticos do Redis OSS que o grupo de parâmetros personalizados do Redis OSS existente.

  Para 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
  ```

  Para 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-replication-group](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}}
  ```

Use a ajuda para listar todos os comandos disponíveis ElastiCache para Valkey ou Redis OSS.

```
aws elasticache help
```

Você também pode usar a ajuda para descrever um comando específico e saber mais sobre seu uso: 

```
aws elasticache create-global-replication-group help
```