

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á.

# Criação de um grupo de replicação do Valkey ou Redis OSS
<a name="Replication.CreatingRepGroup"></a>

Você tem as seguintes opções para criar um cluster com nós de réplica. Uma delas se aplica quando você já tem um cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível não associado a nenhum cluster que possua réplicas a serem usadas como o nó primário. A outra é aplicada quando você precisa criar um nó primário com o cluster e as réplicas de leitura. Atualmente, um cluster do Valkey ou Redis OSS (modo cluster habilitado) deve ser criado do zero.

**Opção 1 1: [Criação de um grupo de replicação usando um cluster existente](Replication.CreatingReplGroup.ExistingCluster.md)**  
Use essa opção para aproveitar um cluster de nó único já existente do Valkey ou Redis OSS (modo cluster desabilitado). Você especifica esse nó existente como o nó primário no novo cluster e, em seguida, adiciona individualmente de 1 a 5 réplicas de leitura ao cluster. Se o cluster existente estiver ativo, as réplicas de leitura serão sincronizadas com ele enquanto forem criadas. Consulte [Criação de um grupo de replicação usando um cluster existente](Replication.CreatingReplGroup.ExistingCluster.md).  
Não é possível criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) usando um cluster existente. Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupo de replicação) usando o console do ElastiCache, consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster).

**Opção 2 2: [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md)**  
Use essa opção se você ainda não tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível a ser usado como nó primário do cluster, ou se quiser criar um cluster do Valkey ou Redis OSS (modo cluster habilitado). Consulte [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md).

# Criação de um grupo de replicação usando um cluster existente
<a name="Replication.CreatingReplGroup.ExistingCluster"></a>

O procedimento a seguir adiciona um grupo de replicação ao cluster de nó único do Valkey ou Redis OSS (modo cluster desabilitado). Ele é necessário para atualizar seu cluster para a versão mais recente do Valkey. Esse é um procedimento local que envolve zero tempo de inatividade e zero perda de dados. Quando você cria um grupo de replicação para seu cluster de nó único, o nó do cluster se torna o nó primário no novo cluster. Se você não tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) que possa usar como primário do novo cluster, consulte [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md).

Um cluster disponível é um cluster do Valkey ou Redis OSS existente de um único nó. Atualmente, o Valkey ou o Redis OSS (modo cluster habilitado) não oferecem suporte para criar um cluster com réplicas usando um cluster de um único nó disponível. Se você quiser criar um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON).

## Criação de um grupo de replicação usando um cluster existente (console)
<a name="Replication.CreatingReplGroup.ExistingCluster.CON"></a>

Consulte o tópico [Usando o ElastiCache Console de gerenciamento da AWS](Clusters.AddNode.md#Clusters.AddNode.CON).

## Criação de um grupo de replicação usando um cluster do Valkey ou Redis OSS disponível (AWS CLI)
<a name="Replication.CreatingReplGroup.ExistingCluster.CLI"></a>

Existem duas etapas para criar um grupo de replicação com réplicas de leitura ao usar um cluster de cache do Valkey ou Redis OSS disponível para o primário ao usar a AWS CLI.

Ao usar o,AWS CLI você cria um grupo de replicação especificando o nó autônomo disponível como o nó principal do cluster `--primary-cluster-id` e o número de nós que você deseja no cluster usando o comando CLI,. `create-replication-group` Inclua os seguintes parâmetros.

**--replication-group-id**  
O nome do grupo de replicação que você está criando. O valor desse parâmetro é usado como a base para os nomes dos nós adicionados com um número sequencial de 3 dígitos acrescentados ao final de `--replication-group-id`. Por exemplo, .`sample-repl-group-001`  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**--replication-group-description**  
Descrição do grupo de replicação.

**--num-node-groups**  
O número de nós desejados neste cluster. Esse valor inclui o nó primário. Esse parâmetro tem um valor máximo de seis.

**--primary-cluster-id**  
O nome do cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível que você deseja que seja o nó primário nesse grupo de replicação.

O comando a seguir cria o grupo de replicação `sample-repl-group` usando o cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível `redis01` como o nó primário do grupo de replicação. Ele cria 2 novos nós que são réplicas de leitura. As configurações de `redis01` (ou seja, grupo de parâmetros, grupo de segurança, tipo de nó, versão do mecanismo, etc.) serão aplicadas a todos os nós no grupo de replicações.

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "demo cluster with replicas" \
   --num-cache-clusters 3 \
   --primary-cluster-id redis01
```

Para Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "demo cluster with replicas" ^
   --num-cache-clusters 3 ^
   --primary-cluster-id redis01
```

Para obter informações e parâmetros adicionais que você talvez queira usar, consulte o AWS CLI tópico[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

**Em seguida, adicione réplicas de leitura ao grupo de replicação**  
Após a criação do grupo de replicação, adicione de uma a cinco réplicas de leitura usando o comando `create-cache-cluster`, certificando-se de incluir os seguintes parâmetros. 

**--cache-cluster-id**  
O nome do cluster que você está adicionando ao grupo de replicação.  
As restrições de nomenclatura de cluster são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.


**--replication-group-id**  
O nome do grupo de replicação ao qual você está adicionando esse cluster.

Repita esse comando para cada réplica de leitura que você deseja adicionar ao grupo de replicação, alterando apenas o valor do parâmetro `--cache-cluster-id`.

**nota**  
Lembre-se de que um grupo de replicação não pode ter mais de cinco réplicas de leitura. Se você tentar adicionar uma réplica de leitura a um grupo de replicação que já possui cinco réplicas de leitura, a operação falhará.

O código a seguir adiciona a réplica de leitura `my-replica01` ao grupo de replicação `sample-repl-group`. As configurações do cluster primário (grupo de parâmetros, grupo de segurança, tipo de nó etc.) serão aplicadas aos nós como foram adicionadas ao grupo de replicação.

Para Linux, macOS ou Unix:

```
aws elasticache create-cache-cluster \
   --cache-cluster-id my-replica01 \
   --replication-group-id sample-repl-group
```

Para Windows:

```
aws elasticache create-cache-cluster ^
   --cache-cluster-id my-replica01 ^
   --replication-group-id sample-repl-group
```

A saída desse comando será semelhante a esta.

```
{
    "ReplicationGroup": {
        "Status": "creating",
        "Description": "demo cluster with replicas",
        "ClusterEnabled": false,
        "ReplicationGroupId": "sample-repl-group",
        "SnapshotRetentionLimit": 1,
        "AutomaticFailover": "disabled",
        "SnapshotWindow": "00:00-01:00",
        "SnapshottingClusterId": "redis01",
        "MemberClusters": [
            "sample-repl-group-001",
            "sample-repl-group-002",
            "redis01"
        ],
        "CacheNodeType": "cache.m4.large",
        "DataTiering": "disabled",
        "PendingModifiedValues": {}
    }
}
```

Para obter informações adicionais, consulte os AWS CLI tópicos:
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)

## Adicionar réplicas a um cluster (API) autônomo Valkey ou Redis OSS (modo de cluster desativado) ElastiCache
<a name="Replication.CreatingReplGroup.ExistingCluster.API"></a>

Ao usar a ElastiCache API, você cria um grupo de replicação especificando o nó autônomo disponível como o nó principal do cluster `PrimaryClusterId` e o número de nós que você deseja no cluster usando o comando CLI,. `CreateReplicationGroup` Inclua os seguintes parâmetros.

**ReplicationGroupId**  
O nome do grupo de replicação que você está criando. O valor desse parâmetro é usado como a base para os nomes dos nós adicionados com um número sequencial de 3 dígitos acrescentados ao final de `ReplicationGroupId`. Por exemplo, .`sample-repl-group-001`  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**ReplicationGroupDescription**  
Descrição do cluster com réplicas.

**NumCacheClusters**  
O número de nós desejados neste cluster. Esse valor inclui o nó primário. Esse parâmetro tem um valor máximo de seis.

**PrimaryClusterId**  
O nome do cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível que você deseja que seja o nó primário nesse cluster.

O comando a seguir cria o cluster com réplicas `sample-repl-group` usando o cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível `redis01` como o nó primário do grupo de replicação. Ele cria 2 novos nós que são réplicas de leitura. As configurações de `redis01` (ou seja, grupo de parâmetros, grupo de segurança, tipo de nó, versão do mecanismo, etc.) serão aplicadas a todos os nós no grupo de replicações.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &Engine=redis
   &EngineVersion=6.0
   &ReplicationGroupDescription=Demo%20cluster%20with%20replicas
   &ReplicationGroupId=sample-repl-group
   &PrimaryClusterId=redis01
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obter informações adicionais, consulte os tópicos do ElastiCache APL:
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)

**Em seguida, adicione réplicas de leitura ao grupo de replicação**  
Após a criação do grupo de replicação, adicione de uma a cinco réplicas de leitura usando a operação `CreateCacheCluster`, certificando-se de incluir os seguintes parâmetros. 

**CacheClusterId**  
O nome do cluster que você está adicionando ao grupo de replicação.  
As restrições de nomenclatura de cluster são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.


**ReplicationGroupId**  
O nome do grupo de replicação ao qual você está adicionando esse cluster.

Repita essa operação para cada réplica de leitura que você deseja adicionar ao grupo de replicação, alterando apenas o valor do parâmetro `CacheClusterId`.

O código a seguir adiciona a réplica de leitura `myReplica01` ao grupo de replicação `myReplGroup`. As configurações do cluster primário (grupo de parâmetros, grupo de segurança, tipo de nó etc.) serão aplicadas a nós conforme eles forem adicionados ao grupo de replicação.

```
https://elasticache.us-west-2.amazonaws.com/
	?Action=CreateCacheCluster
	&CacheClusterId=myReplica01
	&ReplicationGroupId=myReplGroup
	&SignatureMethod=HmacSHA256
	&SignatureVersion=4
	&Version=2015-02-02
	&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
	&X-Amz-Credential=[your-access-key-id]/20150202/us-west-2/elasticache/aws4_request
	&X-Amz-Date=20150202T170651Z
	&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
	&X-Amz-Signature=[signature-value]
```

Para obter informações e parâmetros adicionais que você talvez queira usar, consulte o tópico ElastiCache da API[CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html).

# Criação de um grupo de replicação do Valkey ou Redis OSS do início
<a name="Replication.CreatingReplGroup.NoExistingCluster"></a>

Veja a seguir como criar um grupo de replicação do Valkey ou Redis OSS sem usar um cluster do Valkey ou Redis OSS existente como primário. Você pode criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado) do início usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.

Antes de continuar, decida se deseja criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado). Para obter orientação nessa decisão, consulte [Replicação: Modo de cluster Valkey e Redis OSS desativado versus ativado](Replication.Redis-RedisCluster.md).

**Topics**
+ [Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início](Replication.CreatingReplGroup.NoExistingCluster.Classic.md)
+ [Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md)

# Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic"></a>

Você pode criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) a partir do início usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache. Um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) sempre possui um grupo de nó, um cluster primário e até cinco réplicas de leitura. Os grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado) não são compatíveis com o particionamento dos seus dados.

**nota**  
O limite de nó/fragmento pode ser aumentado para um máximo de 500 por cluster. Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e inclua o tipo de instância na solicitação.

Para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, siga uma das seguintes abordagens:

## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início (AWS CLI)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic.CLI"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) usando a AWS CLI.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para o comando `create-replication-group` da AWS CLI. Inclua os seguintes parâmetros.

**--replication-group-id**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**--replication-group-description**  
Descrição do grupo de replicação.

**--num-cache-clusters**  
O número de nós que você deseja criar com esse grupo de replicação, com réplicas primárias e de leitura combinadas.  
Se você habilitar o Multi-AZ (`--automatic-failover-enabled`), o valor de `--num-cache-clusters` deverá ser pelo menos 2.

**--cache-node-type**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**--cache-parameter-group**  
Especifique um grupo de parâmetros que corresponda à versão do seu mecanismo. Se estiver executando o Redis OSS 3.2.4 ou posterior, especifique o grupo de parâmetros `default.redis3.2` ou um grupo de parâmetros de `default.redis3.2` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado). Para obter mais informações, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).

**--network-type**  
`ipv4`, `ipv6` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como`ipv4` ou `ipv6`.

**--engine**  
redis

**--engine-version**  
Para ter o conjunto mais amplo de recursos, escolha a versão mais recente do mecanismo.

Os nomes dos nós serão derivados do nome do grupo de replicação depois de adicionar `-00`*\$1* ao nome do grupo de replicação. Por exemplo, usando o nome do grupo de replicação `myReplGroup`, o nome para o primário será `myReplGroup-001` e as réplicas de leitura `myReplGroup-002` e `myReplGroup-006`.

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `--cache-subnet-group`.
+ Você também deve incluir o parâmetro `--auth-token` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

A seguinte operação cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) `sample-repl-group` com três nós, um primário e duas réplicas.

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "Demo cluster with replicas" \
   --num-cache-clusters 3 \
   --cache-node-type cache.m4.large \ 
   --engine redis
```

Para Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "Demo cluster with replicas" ^
   --num-cache-clusters 3 ^
   --cache-node-type cache.m4.large ^  
   --engine redis
```

A saída desse comando é semelhante a esta.

```
{
    "ReplicationGroup": {
        "Status": "creating",
        "Description": "Demo cluster with replicas",
        "ClusterEnabled": false,
        "ReplicationGroupId": "sample-repl-group",
        "SnapshotRetentionLimit": 0,
        "AutomaticFailover": "disabled",
        "SnapshotWindow": "01:30-02:30",
        "MemberClusters": [
            "sample-repl-group-001",
            "sample-repl-group-002",
            "sample-repl-group-003"
        ],
        "CacheNodeType": "cache.m4.large",
        "DataTiering": "disabled",
        "PendingModifiedValues": {}
    }
}
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico da AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início (API do ElastiCache)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic.API"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) usando a API do ElastiCache.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para a operação `CreateReplicationGroup` da API do ElastiCache. Inclua os seguintes parâmetros.

**ReplicationGroupId**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**ReplicationGroupDescription**  
Sua descrição do grupo de replicação.

**NumCacheClusters**  
O número total de nós que você deseja criar com esse grupo de replicação, com réplicas primárias e de leitura combinadas.  
Se você habilitar o Multi-AZ (`AutomaticFailoverEnabled=true`), o valor de `NumCacheClusters` deverá ser pelo menos 2.

**CacheNodeType**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**CacheParameterGroup**  
Especifique um grupo de parâmetros que corresponda à versão do seu mecanismo. Se estiver executando o Redis OSS 3.2.4 ou posterior, especifique o grupo de parâmetros `default.redis3.2` ou um grupo de parâmetros de `default.redis3.2` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado). Para obter mais informações, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).

**--network-type**  
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.

**Mecanismo**  
redis

**EngineVersion**  
6.0

Os nomes dos nós serão derivados do nome do grupo de replicação depois de adicionar `-00`*\$1* ao nome do grupo de replicação. Por exemplo, usando o nome do grupo de replicação `myReplGroup`, o nome para o primário será `myReplGroup-001` e as réplicas de leitura `myReplGroup-002` e `myReplGroup-006`.

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `CacheSubnetGroup`.
+ Você também deve incluir o parâmetro `AuthToken` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

A seguinte operação cria o grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) `myReplGroup` com três nós, um primário e duas réplicas.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &CacheNodeType=cache.m4.large
   &CacheParameterGroup=default.redis6.x
   &Engine=redis
   &EngineVersion=6.0
   &NumCacheClusters=3
   &ReplicationGroupDescription=test%20group
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a API do ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).

# Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster"></a>

Você pode criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: *grupo de replicação*) usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache. Um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) tem de 1 a 500 fragmentos (API/CLI: grupos de nós), um nó primário em cada fragmento e até 5 réplicas de leitura em cada fragmento. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 90 nós por cluster. Essa configuração do cluster pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.

O limite de nó ou fragmento pode ser aumentado para um máximo de 500 por cluster se a versão do mecanismo Valkey ou Redis OSS for 5.0.6 ou posterior. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).

 Para versões abaixo de 5.0.6, o limite é 250 por cluster.

Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância). 

**Topics**
+ [Uso do console do ElastiCache](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
+ [Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)
+ [Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)

## Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON"></a>

Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster). Certifique-se de habilitar o modo de cluster, **Cluster Mode enabled (Scale Out)**, e especifique pelo menos dois fragmentos e um nó de réplica em cada.

## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a AWS CLI.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para o comando `create-replication-group` da AWS CLI. Inclua os seguintes parâmetros.

**--replication-group-id**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**--replication-group-description**  
Descrição do grupo de replicação.

**--cache-node-type**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**--cache-parameter-group**  
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--engine**  
redis

**--engine-version**  
3.2.4

**--num-node-groups**  
O número de grupos de nós neste grupo de replicação. Os valores válidos são 1 a 500.  
O limite de nó/fragmento pode ser aumentado para um máximo de 500 por cluster. Para solicitar um aumento do limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite "Nodes per cluster per instance type" (Nós por cluster por tipo de instância). 

**--replicas-per-node-group**  
O número de nós de réplica em cada grupo de nós. Os valores válidos são 0 a 5.

**--network-type**  
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `--cache-subnet-group`.
+ Você também deve incluir o parâmetro `--auth-token` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

A seguinte operação cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `sample-repl-group` com três grupos de nós/fragmentos (--num-node-groups), cada um com três nós, uma réplica primária e duas réplicas de leitura (--replicas-per-node-group).

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "Demo cluster with replicas" \
   --num-node-groups 3 \
   --replicas-per-node-group 2 \
   --cache-node-type cache.m4.large \ 
   --engine redis \   
   --security-group-ids SECURITY_GROUP_ID \    
   --cache-subnet-group-name SUBNET_GROUP_NAME>
```

Para Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "Demo cluster with replicas" ^
   --num-node-groups 3 ^
   --replicas-per-node-group 2 ^
   --cache-node-type cache.m4.large ^ 
   --engine redis ^   
   --security-group-ids SECURITY_GROUP_ID ^      
   --cache-subnet-group-name SUBNET_GROUP_NAME>
```

O comando anterior gera a seguinte saída.

```
{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Demo cluster with replicas", 
        "ReplicationGroupId": "sample-repl-group", 
        "SnapshotRetentionLimit": 0, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "05:30-06:30", 
        "MemberClusters": [
            "sample-repl-group-0001-001", 
            "sample-repl-group-0001-002", 
            "sample-repl-group-0001-003", 
            "sample-repl-group-0002-001", 
            "sample-repl-group-0002-002", 
            "sample-repl-group-0002-003", 
            "sample-repl-group-0003-001", 
            "sample-repl-group-0003-002", 
            "sample-repl-group-0003-003"
        ], 
        "PendingModifiedValues": {}
    }
}
```

Quando você cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você pode configurar cada fragmento do cluster usando o parâmetro `--node-group-configuration`, como mostra o exemplo a seguir, que configura dois grupos de nós (console: fragmentos). O primeiro fragmento tem dois nós: um primário e uma réplica de leitura. O segundo fragmento tem três nós: um primário e duas réplicas de leitura.

**--node-group-configuration**  
A configuração para cada grupo de nós. O parâmetro `--node-group-configuration` consiste nos seguintes campos.  
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.

  **Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista separada por vírgulas de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.

  **Exemplo:** "us-west-2a,us-west-2b,us-west-2c"
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.

  **Exemplo:** "0-4999"

   

A operação a seguir cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `new-group` com dois grupos de nós/fragmentos (`--num-node-groups`). Ao contrário do exemplo anterior, cada grupo de nós está configurado de forma diferente do outro grupo de nós (`--node-group-configuration`).

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
  --replication-group-id new-group \
  --replication-group-description "Sharded replication group" \
  --engine redis \    
  --snapshot-retention-limit 8 \
  --cache-node-type cache.m4.medium \
  --num-node-groups 2 \
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```

Para Windows:

```
aws elasticache create-replication-group ^
  --replication-group-id new-group ^
  --replication-group-description "Sharded replication group" ^
  --engine redis ^    
  --snapshot-retention-limit 8 ^
  --cache-node-type cache.m4.medium ^
  --num-node-groups 2 ^
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```

A operação anterior gera a seguinte saída.

```
{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Sharded replication group", 
        "ReplicationGroupId": "rc-rg", 
        "SnapshotRetentionLimit": 8, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "10:00-11:00", 
        "MemberClusters": [
            "rc-rg-0001-001", 
            "rc-rg-0001-002", 
            "rc-rg-0002-001", 
            "rc-rg-0002-002", 
            "rc-rg-0002-003"
        ], 
        "PendingModifiedValues": {}
    }
}
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

## Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.API"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a API do ElastiCache.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para a operação `CreateReplicationGroup` da API do ElastiCache. Inclua os seguintes parâmetros.

**ReplicationGroupId**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**ReplicationGroupDescription**  
Descrição do grupo de replicação.

**NumNodeGroups**  
O número de grupos de nós que você deseja criar com esse grupo de replicação. Os valores válidos são 1 a 500.

**ReplicasPerNodeGroup**  
O número de nós de réplica em cada grupo de nós. Os valores válidos são 1 a 5.

**NodeGroupConfiguration**  
A configuração para cada grupo de nós. O parâmetro `NodeGroupConfiguration` consiste nos seguintes campos.  
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.

  **Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.

  **Exemplo:** "0-4999"

   

**CacheNodeType**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**CacheParameterGroup**  
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--network-type**  
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.

**Mecanismo**  
redis

**EngineVersion**  
6.0

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `CacheSubnetGroup`.
+ Você também deve incluir o parâmetro `AuthToken` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

As quebras de linha foram adicionadas para legibilidade.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &CacheNodeType=cache.m4.large
   &CacheParemeterGroup=default.redis6.xcluster.on
   &Engine=redis
   &EngineVersion=6.0
   &NumNodeGroups=3
   &ReplicasPerNodeGroup=2
   &ReplicationGroupDescription=test%20group
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a API do ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).