

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Alta disponibilità utilizzando gruppi di replica
<a name="Replication"></a>

I cluster Amazon ElastiCache Valkey e Redis OSS a nodo singolo sono entità in memoria con servizi di protezione dei dati (AOF) limitati. Se il cluster non viene eseguito per qualsiasi motivo, tutti i dati del cluster vengono persi. Tuttavia, se utilizzi un motore Valkey o Redis OSS, puoi raggruppare da 2 a 6 nodi in un cluster con repliche in cui da 1 a 5 nodi di sola lettura contengono dati replicati del singolo nodo primario del gruppo. read/write In questo scenario, se un nodo non viene eseguito per qualsiasi motivo, non tutti i dati vengono persi poiché vengono replicati in uno o più nodi. A causa della latenza di replica, alcuni dati potrebbero andare persi se è il nodo primario a fallire. read/write 

Come illustrato nell'immagine seguente, la struttura di replica è contenuta all'interno di uno shard (chiamato *gruppo di nodi* nell'API/CLI) contenuto all'interno di un cluster Valkey o Redis OSS. I cluster Valkey o Redis OSS (modalità cluster disabilitata) hanno sempre uno shard. I cluster Valkey o Redis OSS (modalità cluster abilitata) possono avere fino a 500 shard con i dati del cluster partizionati tra gli shard. Puoi creare un cluster con un numero più alto dle partizioni e un numero più basso di repliche per un totale di 90 nodi per cluster. Questa configurazione del cluster può andare da 90 partizioni e 0 repliche a 15 partizioni e 5 repliche che è il numero massimo consentito di repliche. 

Il limite di nodi o shard può essere aumentato fino a un massimo di 500 per cluster con Valkey e con la versione 5.0.6 o ElastiCache successiva per Redis OSS. ElastiCache Ad esempio, è possibile scegliere di configurare un cluster a 500 nodi che varia tra 83 partizioni (un primario e 5 repliche per partizione) e 500 partizioni (un singolo primario e nessuna replica). Assicurati che esistano abbastanza indirizzi IP disponibili per soddisfare l'aumento. Le problematiche comuni sono che le le sottoreti nel gruppo di sottoreti hanno un intervallo CIDR troppo piccolo o che le sottoreti sono condivise e utilizzate pesantemente da altri cluster. Per ulteriori informazioni, consulta [Creazione di un gruppo di sottoreti](SubnetGroups.Creating.md).

 Per le versioni inferiori alla 5.0.6, il limite è 250 per cluster.

Per richiedere un aumento dei limiti, consulta [Limiti dei servizi AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e seleziona il tipo di limite **Nodi per cluster per tipo di istanza**. 

![\[Immagine: il cluster Valkey o Redis OSS (modalità cluster disabilitata) ha uno shard e da 0 a 5 nodi di replica\]](http://docs.aws.amazon.com/it_it/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)


*Il cluster Valkey o Redis OSS (modalità cluster disabilitata) ha uno shard e da 0 a 5 nodi di replica*

Se nel cluster con repliche è abilitata la funzione Multi-AZ e il nodo primario non viene eseguito, il nodo primario esegue il failover in una replica di lettura. Poiché i dati sui nodi di replica vengono aggiornati in maniera asincrona, è possibile che alcuni dati vengano persi a causa della latenza di aggiornamento dei nodi di replica. Per ulteriori informazioni, consulta [Mitigazione degli errori durante l'esecuzione di Valkey o Redis OSS](disaster-recovery-resiliency.md#FaultTolerance.Redis).

**Topics**
+ [Comprendere la replica di Valkey e Redis OSS](Replication.Redis.Groups.md)
+ [Replica: modalità cluster Valkey e Redis OSS disabilitata o abilitata](Replication.Redis-RedisCluster.md)
+ [Riduzione al minimo dei tempi di inattività ElastiCache utilizzando Multi-AZ con Valkey e Redis OSS](AutoFailover.md)
+ [Modalità di implementazione di sincronizzazione e backup](Replication.Redis.Versions.md)
+ [Creazione di un gruppo di replica Valkey o Redis OSS](Replication.CreatingRepGroup.md)
+ [Visualizzazione dei dettagli del gruppo di replica](Replication.ViewDetails.md)
+ [Individuazione di endpoint del gruppo di replica](Replication.Endpoints.md)
+ [Modifica di un gruppo di replica](Replication.Modify.md)
+ [Eliminazione di un gruppo di replica](Replication.DeletingRepGroup.md)
+ [Modifica del numero di repliche](increase-decrease-replica-count.md)
+ [Promozione di una replica di lettura a quella primaria, per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata)](Replication.PromoteReplica.md)

# Comprendere la replica di Valkey e Redis OSS
<a name="Replication.Redis.Groups"></a>

Redis OSS implementa la replica in due modi: 
+ Con un singolo shard che contiene tutti i dati del cluster in ogni nodo: Valkey o Redis OSS (modalità cluster disabilitata)
+ Con dati partizionati su un massimo di 500 shard: Valkey o Redis OSS (modalità cluster abilitata)

Ogni shard in un gruppo di replica ha un singolo nodo read/write primario e fino a 5 nodi di replica di sola lettura. Puoi creare un cluster con un numero più alto dle partizioni e un numero più basso di repliche per un totale di 90 nodi per cluster. Questa configurazione del cluster può andare da 90 partizioni e 0 repliche a 15 partizioni e 5 repliche che è il numero massimo consentito di repliche.

Il limite di nodi o shard può essere aumentato fino a un massimo di 500 per cluster se la versione del motore Redis OSS è 5.0.6 o successiva. Ad esempio, è possibile scegliere di configurare un cluster a 500 nodi che varia tra 83 partizioni (un primario e 5 repliche per partizione) e 500 partizioni (un singolo primario e nessuna replica). Assicurati che esistano abbastanza indirizzi IP disponibili per soddisfare l'aumento. Le problematiche comuni sono che le le sottoreti nel gruppo di sottoreti hanno un intervallo CIDR troppo piccolo o che le sottoreti sono condivise e utilizzate pesantemente da altri cluster. Per ulteriori informazioni, consulta [Creazione di un gruppo di sottoreti](SubnetGroups.Creating.md).

 Per le versioni inferiori alla 5.0.6, il limite è 250 per cluster.

Per richiedere un aumento dei limiti, consulta [Limiti dei servizi AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e seleziona il tipo di limite **Nodi per cluster per tipo di istanza**. 

**Topics**
+ [Valkey o Redis OSS (modalità cluster disabilitata)](#Replication.Redis.Groups.Classic)
+ [Valkey o Redis OSS (modalità cluster abilitata)](#Replication.Redis.Groups.Cluster)

## Valkey o Redis OSS (modalità cluster disabilitata)
<a name="Replication.Redis.Groups.Classic"></a>

Un cluster Valkey o Redis OSS (modalità cluster disabilitata) ha un singolo shard, all'interno del quale è presente una raccolta di nodi, un read/write nodo primario e fino a cinque nodi di replica secondari di sola lettura. Ogni replica di lettura conserva una copia dei dati del nodo primario del cluster. Meccanismi di replica asincrona vengono utilizzati per mantenere le repliche di lettura sincronizzate con il nodo primario. Le applicazioni possono leggere da qualsiasi nodo nel cluster. Le applicazioni possono scrivere solo nel nodo primario. Le repliche di lettura migliorano il throughput di lettura e proteggono dalla perdita di dati nei casi di mancata esecuzione del nodo.

![\[Immagine: cluster Valkey o Redis OSS (modalità cluster disabilitata) con un singolo shard e nodi di replica\]](http://docs.aws.amazon.com/it_it/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)


*Cluster Valkey o Redis OSS (modalità cluster disabilitata) con un singolo shard e nodi di replica*

È possibile utilizzare i cluster Valkey o Redis OSS (modalità cluster disabilitata) con nodi di replica per scalare la soluzione in modo da gestire applicazioni che richiedono un uso intensivo di lettura o ElastiCache per supportare un gran numero di client che leggono contemporaneamente dallo stesso cluster.

Tutti i nodi di un cluster Valkey o Redis OSS (modalità cluster disabilitata) devono risiedere nella stessa regione. 

Quando aggiungi una replica di lettura a un cluster, tutti i dati del nodo primario vengono copiati nel nuovo nodo. Da quel punto in poi, ogni volta che vengono scritti dati nel nodo primario, le modifiche vengono propagate in modo asincrono a tutte le repliche di lettura.

Per migliorare la tolleranza agli errori e ridurre i tempi di inattività in scrittura, abilita Multi-AZ con failover automatico per il cluster Valkey o Redis OSS (modalità cluster disabilitata) con repliche. Per ulteriori informazioni, consulta [Riduzione al minimo dei tempi di inattività ElastiCache utilizzando Multi-AZ con Valkey e Redis OSS](AutoFailover.md).

È possibile modificare i ruoli dei nodi all'interno del cluster Valkey o Redis OSS (modalità cluster disabilitata), scambiando i ruoli della replica principale e di quella delle repliche. Ciò può essere fatto per motivi di tuning delle prestazioni. Ad esempio, in un'applicazione Web con attività di scrittura elevata, puoi scegliere il nodo che presenta la latenza di rete più bassa. Per ulteriori informazioni, consulta [Promozione di una replica di lettura a quella primaria, per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata)](Replication.PromoteReplica.md).

## Valkey o Redis OSS (modalità cluster abilitata)
<a name="Replication.Redis.Groups.Cluster"></a>

Un cluster Valkey o Redis OSS (modalità cluster abilitata) è composto da 1 a 500 shard (API/CLI: gruppi di nodi). Ogni partizione dispone di un nodo primario e un massimo di cinque nodi di replica di sola lettura. La configurazione può variare da 90 partizioni e 0 repliche a 15 partizioni e 5 repliche che è il numero massimo consentito di repliche. 

Il limite di nodi o shard può essere aumentato fino a un massimo di 500 per cluster se la versione del motore è Valkey 7.2 e successiva o Redis OSS 5.0.6 e successiva. Ad esempio, è possibile scegliere di configurare un cluster a 500 nodi che varia tra 83 partizioni (un primario e 5 repliche per partizione) e 500 partizioni (un singolo primario e nessuna replica). Assicurati che esistano abbastanza indirizzi IP disponibili per soddisfare l'aumento. Le problematiche comuni sono che le le sottoreti nel gruppo di sottoreti hanno un intervallo CIDR troppo piccolo o che le sottoreti sono condivise e utilizzate pesantemente da altri cluster. Per ulteriori informazioni, consulta [Creazione di un gruppo di sottoreti](SubnetGroups.Creating.md).

 Per le versioni inferiori alla 5.0.6, il limite è 250 per cluster.

Per richiedere un aumento dei limiti, consulta [AWS Limiti del servizio](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e scegliere il tipo di limite **Nodi per cluster per tipo di istanza**. 

 Ogni replica di lettura in uno shard conserva una copia dei dati del nodo primario dello shard. Meccanismi di replica asincrona vengono utilizzati per mantenere le repliche di lettura sincronizzate con il nodo primario. Le applicazioni possono leggere da qualsiasi nodo nel cluster. Le applicazioni possono scrivere solo nei nodi primari. Le repliche di lettura migliorano la scalabilità in lettura e proteggono dalla perdita di dati. I dati vengono partizionati tra gli shard in un cluster Valkey o Redis OSS (modalità cluster abilitata).

Le applicazioni utilizzano l'*endpoint di configurazione* del cluster Valkey o Redis OSS (modalità cluster abilitata) per connettersi con i nodi del cluster. Per ulteriori informazioni, consulta [Ricerca degli endpoint di connessione in ElastiCache](Endpoints.md).

![\[Immagine: cluster Valkey o Redis OSS (modalità cluster abilitata) con più shard e nodi di replica\]](http://docs.aws.amazon.com/it_it/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-RedisClusters.png)


*Cluster Valkey o Redis OSS (modalità cluster abilitata) con più shard e nodi di replica*

Tutti i nodi di un cluster Valkey o Redis OSS (modalità cluster abilitata) devono risiedere nella stessa regione. Per migliorare la tolleranza ai guasti, puoi eseguire il provisioning dei nodi primari e delle repliche di lettura in più zone di disponibilità all'interno di tale regione.

Attualmente, le funzionalità di Valkey o Redis OSS (modalità cluster abilitata) presentano alcune limitazioni.
+ Non puoi promuovere manualmente nodi di replica al nodo primario.

# Replica: modalità cluster Valkey e Redis OSS disabilitata o abilitata
<a name="Replication.Redis-RedisCluster"></a>

A partire da Valkey 7.2 e Redis OSS versione 3.2, è possibile creare uno dei due tipi distinti di cluster (API/CLI: replication groups). A Valkey or Redis OSS (cluster mode disabled) cluster always has a single shard (API/CLI: gruppo di nodi) con un massimo di 5 nodi di replica in lettura. Un cluster Valkey o Redis OSS (modalità cluster abilitata) ha fino a 500 shard con da 1 a 5 nodi di replica di lettura ciascuno.

![\[Immagine: cluster Valkey o Redis OSS (modalità cluster disabilitata) e cluster Valkey o Redis OSS (modalità cluster abilitata)\]](http://docs.aws.amazon.com/it_it/AmazonElastiCache/latest/dg/images/ElastiCache-NodeGroups.png)


*Cluster Valkey o Redis OSS (modalità cluster disabilitata) e Valkey o Redis OSS (modalità cluster abilitata)*

La tabella seguente riassume le differenze importanti tra i cluster Valkey o Redis OSS (modalità cluster disabilitata) e i cluster Valkey o Redis OSS (modalità cluster abilitata).


**Confronto tra i cluster Valkey o Redis OSS (modalità cluster disabilitata) e Valkey o Redis OSS (modalità cluster abilitata)**  

| Funzionalità | Valkey o Redis OSS (modalità cluster disabilitata) | Valkey o Redis OSS (modalità cluster abilitata) | 
| --- | --- | --- | 
| Modificabile | Sì. Supporta l'aggiunta e l'eliminazione di nodi di replica e il dimensionamento orizzontale del tipo di nodo. | Limitato. Per ulteriori informazioni, consultare [Gestione delle versioni per ElastiCache](VersionManagement.md) e [Scalabilità dei cluster Valkey o Redis OSS (Cluster Mode Enabled)](scaling-redis-cluster-mode-enabled.md). | 
| Partizionamento dei dati | No | Sì | 
| Shard | 1 | Da 1 a 500  | 
| Repliche di lettura | Da 0 a 5 Se non esistono repliche e il nodo non viene eseguito, tutti i dati vengono persi. | Da 0 a 5 per partizione. Se non esistono repliche e il nodo non viene eseguito, tutti i dati in tale shard vengono persi. | 
| Multi-AZ  | Sì, con almeno 1 replica. Facoltativo. Attivata per impostazione predefinita. | SìFacoltativo. Attivata per impostazione predefinita. | 
| Snapshot (Backup) | Sì, creando un singolo file .rdb. | Sì, creando un file .rdb univoco per ogni shard. | 
| Ripristino | Sì, utilizzando un singolo file.rdb da un cluster Valkey o Redis OSS (modalità cluster disabilitata). | Sì, utilizzando file.rdb da un cluster Valkey o Redis OSS (modalità cluster disabilitata) o da un cluster Valkey o Redis OSS (modalità cluster abilitata). | 
| Supportato da | Tutte le versioni di Valkey e Redis OSS | Tutte le versioni di Valkey e Redis OSS 3.2 e successive | 
| Motore aggiornabile | Sì, con alcuni limiti. Per ulteriori informazioni, consulta [Gestione delle versioni per ElastiCache](VersionManagement.md). | Sì, con alcuni limiti. Per ulteriori informazioni, consulta [Gestione delle versioni per ElastiCache](VersionManagement.md). | 
| Crittografia | Versioni 3.2.6 (pianificata per EOL, consulta la [pianificazione di fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | Versioni 3.2.6 (pianificata per EOL, consulta la pianificazione di [fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | 
| Conforme a HIPAA | Versioni 3.2.6 (pianificata per EOL, consulta la pianificazione di [fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | Versioni 3.2.6 (pianificata per EOL, consulta la pianificazione di [fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | 
| Conforme a DSS PCI | Versioni 3.2.6 (pianificata per EOL, consulta la pianificazione di [fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | Versioni 3.2.6 (pianificata per EOL, consulta la pianificazione di [fine del ciclo di vita delle versioni Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e successive. | 
| Resharding online | N/D | Versione 3.2.10 (pianificata per EOL, consulta la pianificazione della fine del ciclo di vita delle versioni [Redis OSS](engine-versions.md#deprecated-engine-versions)) e successive. | 

## scegliere il servizio più adatto.
<a name="Replication.Redis-RedisCluster.Choose"></a>

Quando scegli tra Valkey o Redis OSS (modalità cluster disabilitata) o Valkey o Redis OSS (modalità cluster abilitata), considera i seguenti fattori:
+ **Dimensionamento e partizionamento ** - Le esigenze aziendali cambiano. Occorre fornire il provisioning per picchi di richiesta o ridimensionare quando la richiesta cambia. Valkey o Redis OSS (modalità cluster disabilitata) supporta la scalabilità. Puoi ridimensionare la capacità di lettura aggiungendo o eliminando nodi di replica, oppure può ridimensionare la capacità passando a un tipo di nodo più grande. Entrambe queste operazioni richiedono tempo. Per ulteriori informazioni, consultare [Scalabilità dei nodi di replica per Valkey o Redis OSS (modalità cluster disabilitata)](Scaling.RedisReplGrps.md).

   

  Valkey o Redis OSS (modalità cluster abilitata) supporta il partizionamento dei dati su un massimo di 500 gruppi di nodi. Puoi modificare dinamicamente il numero di shard quando le esigenze aziendali cambiano. Un vantaggio del partizionamento è la possibilità di distribuire il carico su un numero maggiore di endpoint, riducendo i colli di bottiglia di accesso durante i picchi di richiesta. Inoltre, puoi ospitare un set di dati più grande poiché i dati possono essere distribuiti su più server. Per informazioni sul ridimensionamento delle partizioni, consulta. [Scalabilità dei cluster Valkey o Redis OSS (Cluster Mode Enabled)](scaling-redis-cluster-mode-enabled.md)

   
+ **Dimensione del nodo rispetto al numero di nodi**: poiché un cluster Valkey o Redis OSS (modalità cluster disabilitata) ha un solo shard, il tipo di nodo deve essere sufficientemente grande da contenere tutti i dati del cluster più il sovraccarico necessario. D'altra parte, poiché è possibile partizionare i dati su più shard quando si utilizza un cluster Valkey o Redis OSS (modalità cluster abilitata), i tipi di nodi possono essere più piccoli, ma sono necessari più nodi. Per ulteriori informazioni, consulta [Scelta delle dimensioni dei nodi](CacheNodes.SelectSize.md).

   
+ **Letture o scritture**: se il carico principale sul cluster è costituito da applicazioni che leggono dati, è possibile scalare un cluster Valkey o Redis OSS (modalità cluster disabilitata) aggiungendo ed eliminando repliche di lettura. Tuttavia, esiste un numero massimo di 5 repliche di lettura. Se il carico sul cluster è elevato in termini di scrittura, puoi trarre vantaggio dagli endpoint di scrittura aggiuntivi di un cluster Valkey o Redis OSS (modalità cluster abilitata) con più shard.

A prescindere dal tipo di cluster che scegliere di implementare, assicurati di scegliere un tipo di nodo adeguato per le esigenze correnti e future.

# Riduzione al minimo dei tempi di inattività ElastiCache utilizzando Multi-AZ con Valkey e Redis OSS
<a name="AutoFailover"></a>

Esistono diversi casi in cui ElastiCache per Valkey e Redis OSS potrebbe essere necessario sostituire un nodo primario, tra cui alcuni tipi di manutenzione pianificata e l'improbabile eventualità di un guasto del nodo primario o della zona di disponibilità. 

Questa sostituzione comporta alcuni tempi di inattività per il cluster, ma se la funzione Multi-AZ è abilitata, il tempo di inattività viene ridotto al minimo. Il ruolo del nodo primario eseguirà automaticamente il failover su una delle repliche di lettura. Non è necessario creare ed effettuare il provisioning di un nuovo nodo primario, in quanto ElastiCache gestirà la situazione in modo trasparente. Questo failover e la promozione delle repliche garantiscono la possibilità di ricominciare a scrivere nel nuovo nodo primario non appena la promozione è terminata. 

ElastiCache propaga anche il nome DNS (Domain Name Service) della replica promossa. Questo perché se l'applicazione scrive nell'endpoint primario, allora non è richiesta alcuna modifica dell'endpoint nell'applicazione. Tuttavia, poiché la lettura viene eseguita da singoli endpoint, occorre assicurarsi di modificare l'endpoint di lettura della replica promossa al nodo primario nel nuovo endpoint della replica.

In caso di sostituzioni dei nodi pianificati, iniziati a causa di aggiornamenti di manutenzione o aggiornamenti self-service, fare attenzione a quanto segue:
+ Per i cluster Valkey e Redis OSS, le sostituzioni pianificate dei nodi vengono completate mentre il cluster gestisce le richieste di scrittura in entrata. 
+ Per i cluster Valkey e Redis OSS disabilitati in modalità cluster con Multi-AZ abilitato che funzionano sul motore 5.0.6 o successivo, le sostituzioni pianificate dei nodi vengono completate mentre il cluster gestisce le richieste di scrittura in entrata. 
+ Per i cluster disabilitati in modalità cluster Valkey e Redis OSS con Multi-AZ abilitato che funzionano sul motore 4.0.10 o precedente, potresti notare una breve interruzione di scrittura associata agli aggiornamenti DNS. Questa interruzione potrebbe richiedere fino a pochi secondi. Questo processo è molto più veloce rispetto a dover ricreare e rieseguire il provisioning di un nuovo primario, come accade nel caso in cui la funzione Multi-AZ non viene abilitata. 

È possibile abilitare Multi-AZ utilizzando la console di gestione, o l'API ElastiCache . AWS CLI ElastiCache 

L'abilitazione di ElastiCache Multi-AZ sul cluster Valkey o Redis OSS (nell'API e nella CLI, gruppo di replica) migliora la tolleranza agli errori. Ciò è vero in particolare nei casi in cui il cluster read/write primario del cluster diventa irraggiungibile o si guasta per qualsiasi motivo. Multi-AZ è supportato solo sui cluster Valkey e Redis OSS con più di un nodo in ogni shard.

**Topics**
+ [Abilitazione della funzione Multi-AZ](#AutoFailover.Enable)
+ [Risposte per scenari di errore relativi alla funzione Multi-AZ](#AutoFailover.Scenarios)
+ [Test del failover automatico](#auto-failover-test)
+ [Limitazioni su Multi-AZ](#AutoFailover.Limitations)

## Abilitazione della funzione Multi-AZ
<a name="AutoFailover.Enable"></a>

È possibile abilitare Multi-AZ quando si crea o si modifica un cluster (API o CLI, gruppo di replica) utilizzando ElastiCache la console AWS CLI o l'API. ElastiCache

È possibile abilitare Multi-AZ solo su cluster Valkey o Redis OSS (modalità cluster disabilitata) che dispongono di almeno una replica di lettura disponibile. I cluster senza repliche di lettura non forniscono alta disponibilità o tolleranza ai guasti. Per informazioni sulla creazione di un cluster con replica, consulta [Creazione di un gruppo di replica Valkey o Redis OSS](Replication.CreatingRepGroup.md). Per informazioni sull'aggiunta di una replica di lettura a un cluster con replica, consulta [Aggiungere una replica di lettura per Valkey o Redis OSS (modalità cluster disabilitata)](Replication.AddReadReplica.md).

**Topics**
+ [Abilitazione del Multi-AZ (console)](#AutoFailover.Enable.Console)
+ [Abilitazione di Multi-AZ (AWS CLI)](#AutoFailover.Enable.CLI)
+ [Abilitazione di Multi-AZ (ElastiCache API)](#AutoFailover.Enable.API)

### Abilitazione del Multi-AZ (console)
<a name="AutoFailover.Enable.Console"></a>

È possibile abilitare Multi-AZ utilizzando la ElastiCache console quando si crea un nuovo cluster Valkey o Redis OSS o modificando un cluster esistente con la replica.

Multi-AZ è abilitato per impostazione predefinita sui cluster Valkey o Redis OSS (modalità cluster abilitata).

**Importante**  
ElastiCache abiliterà automaticamente Multi-AZ solo se il cluster contiene almeno una replica in una zona di disponibilità diversa da quella principale in tutti gli shard.

#### Abilitazione di Multi-AZ durante la creazione di un cluster utilizzando la console ElastiCache
<a name="AutoFailover.Enable.Console.NewCacheCluster"></a>

Per ulteriori informazioni su questo processo, consulta [Creazione di un cluster Valkey (modalità cluster disabilitata) (console)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs). Assicurati di disporre di una o più repliche e di abilitare la funzione Multi-AZ.

#### Abilitazione della funzione Multi-AZ in un cluster esistente (console)
<a name="AutoFailover.Enable.Console.ReplGrp"></a>

Per ulteriori informazioni su questo processo, consulta [Usando il ElastiCache Console di gestione AWS](Clusters.Modify.md#Clusters.Modify.CON) nella sezione relativa alla modifica di un cluster.

### Abilitazione di Multi-AZ (AWS CLI)
<a name="AutoFailover.Enable.CLI"></a>

Il seguente esempio di codice utilizza AWS CLI per abilitare Multi-AZ per il gruppo di replica. `redis12`

**Importante**  
Il gruppo di replica `redis12` deve esistere già e disporre di almeno una replica di lettura.

Per Linux, macOS o Unix:

```
aws elasticache modify-replication-group \
    --replication-group-id redis12 \
    --automatic-failover-enabled \
    --multi-az-enabled \
    --apply-immediately
```

Per Windows:

```
aws elasticache modify-replication-group ^
    --replication-group-id redis12 ^
    --automatic-failover-enabled ^
    --multi-az-enabled ^
    --apply-immediately
```

L'output JSON di questo comando dovrebbe essere simile a quanto segue:

```
{
    "ReplicationGroup": {
        "Status": "modifying", 
        "Description": "One shard, two nodes", 
        "NodeGroups": [
            {
                "Status": "modifying", 
                "NodeGroupMembers": [
                    {
                        "CurrentRole": "primary", 
                        "PreferredAvailabilityZone": "us-west-2b", 
                        "CacheNodeId": "0001", 
                        "ReadEndpoint": {
                            "Port": 6379, 
                            "Address": "redis12-001.v5r9dc.0001.usw2.cache.amazonaws.com"
                        }, 
                        "CacheClusterId": "redis12-001"
                    }, 
                    {
                        "CurrentRole": "replica", 
                        "PreferredAvailabilityZone": "us-west-2a", 
                        "CacheNodeId": "0001", 
                        "ReadEndpoint": {
                            "Port": 6379, 
                            "Address": "redis12-002.v5r9dc.0001.usw2.cache.amazonaws.com"
                        }, 
                        "CacheClusterId": "redis12-002"
                    }
                ], 
                "NodeGroupId": "0001", 
                "PrimaryEndpoint": {
                    "Port": 6379, 
                    "Address": "redis12.v5r9dc.ng.0001.usw2.cache.amazonaws.com"
                }
            }
        ], 
        "ReplicationGroupId": "redis12", 
        "SnapshotRetentionLimit": 1, 
        "AutomaticFailover": "enabling", 
        "MultiAZ": "enabled", 
        "SnapshotWindow": "07:00-08:00", 
        "SnapshottingClusterId": "redis12-002", 
        "MemberClusters": [
            "redis12-001", 
            "redis12-002"
        ], 
        "PendingModifiedValues": {}
    }
}
```

Per ulteriori informazioni, consulta questi argomenti nel *Riferimento ai comandi AWS CLI *:
+ [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html)
+ [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)nel *AWS CLI Command Reference*.

### Abilitazione di Multi-AZ (ElastiCache API)
<a name="AutoFailover.Enable.API"></a>

Il seguente esempio di codice utilizza l' ElastiCache API per abilitare Multi-AZ per il gruppo di replica. `redis12`

**Nota**  
Per utilizzare questo esempio, il gruppo di replica `redis12` deve esistere già e disporre di almeno una replica di lettura.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyReplicationGroup
    &ApplyImmediately=true
    &AutoFailover=true
    &MultiAZEnabled=true
    &ReplicationGroupId=redis12
    &Version=2015-02-02
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20140401T192317Z
    &X-Amz-Credential=<credential>
```

Per ulteriori informazioni, consulta questi argomenti nella *Documentazione di riferimento dell'API ElastiCache *:
+ [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html)
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)

## Risposte per scenari di errore relativi alla funzione Multi-AZ
<a name="AutoFailover.Scenarios"></a>

Prima dell'introduzione di Multi-AZ, ElastiCache rilevava e sostituiva i nodi guasti di un cluster ricreando e rifornendo il nodo guasto. Abilitando la funzione Multi-AZ, un nodo primario non riuscito esegue il failover nella replica con il ritardo di replica minimo. La replica selezionata viene promossa automaticamente al nodo primario. Questa è un'operazione molto più rapida rispetto alla creazione e al provisioning di un nuovo nodo primario. Questo processo richiede in genere pochi secondi prima che sia possibile scrivere nuovamente nel cluster.

Quando Multi-AZ è abilitato, monitora ElastiCache continuamente lo stato del nodo primario. Se il nodo primario non riesce, viene eseguita una delle seguenti operazioni a seconda del tipo di errore.

**Topics**
+ [Scenari di errore quando solo il nodo primario non riesce](#AutoFailover.Scenarios.PrimaryOnly)
+ [Scenari di errore quando il nodo primario e alcune repliche di lettura non riescono](#AutoFailover.Scenarios.PrimaryAndReplicas)
+ [Scenari di fallimento quando l'intero cluster non riesce](#AutoFailover.Scenarios.AllFail)

### Scenari di errore quando solo il nodo primario non riesce
<a name="AutoFailover.Scenarios.PrimaryOnly"></a>

Se il nodo primario non riesce, la replica di lettura con il tempo di replica minimo viene promossa al cluster primario. Viene quindi creata una replica di lettura sostitutiva e viene eseguito il provisioning nella stessa zona di disponibilità del nodo primario non riuscito.

Quando si verifica un errore solo nel nodo primario, ElastiCache Multi-AZ esegue le seguenti operazioni:

1. Il nodo primario non riuscito viene portato offline.

1. La replica di lettura con il tempo di replica minimo viene promossa al nodo primario.

   Le scritture possono riprendere non appena il processo di promozione viene completato, in genere pochi secondi. Se l'applicazione sta scrivendo nell'endpoint primario, non occorre modificare l'endpoint delle scritture poiché ElastiCache propaga il nome DNS della replica promossa.

1. Una replica di lettura sostitutiva viene avviata e sottoposta a provisioning.

   La replica di lettura sostitutiva viene avviata nella zona di disponibilità in cui si trovava il nodo primario non riuscito, in modo da mantenere la distribuzione dei nodi.

1. Le repliche si sincronizzano con il nuovo nodo primario.

Dopo che la nuova replica è disponibile, tieni presente questi effetti:
+ **Endpoint primario** - Non è necessario apportare modifiche alla tua applicazione, poiché il nome DNS del nuovo nodo primario viene propagato all'endpoint primario.
+ **Endpoint di lettura** - L'endpoint di lettura viene aggiornato automaticamente per puntare ai nuovi nodi di replica.

Per informazioni sull'individuazione degli endpoint di un cluster, consulta i seguenti argomenti:
+ [Ricerca degli endpoint (console) del cluster Valkey o Redis OSS (modalità cluster disabilitata)](Endpoints.md#Endpoints.Find.Redis)
+ [Individuazione degli endpoint per i gruppi di replica Valkey o Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Ricerca di endpoint per Valkey o Redis OSS Replication Groups (API) ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)

 

### Scenari di errore quando il nodo primario e alcune repliche di lettura non riescono
<a name="AutoFailover.Scenarios.PrimaryAndReplicas"></a>

Se il nodo primario e almeno una replica di lettura non riescono, la replica disponibile con il ritardo di replica minimo viene promossa al cluster primario. Nuove repliche di lettura vengono inoltre create e sottoposte a provisioning nelle stesse zone di disponibilità dei nodi non riusciti e della replica che è stata promossa al nodo primario.

Quando il nodo primario e alcune repliche di lettura falliscono, ElastiCache Multi-AZ esegue le seguenti operazioni:

1. Il nodo primario non riuscito e le repliche di lettura non riuscite vengono portate offline.

1. La replica disponibile con il tempo di replica minimo viene promossa al nodo primario.

   Le scritture possono riprendere non appena il processo di promozione viene completato, in genere pochi secondi. Se l'applicazione sta scrivendo sull'endpoint primario, non è necessario modificare l'endpoint per le scritture. ElastiCache propaga il nome DNS della replica promossa.

1. Repliche sostitutive vengono create e sottoposte a provisioning.

   Le repliche sostitutive vengono create nelle zone di disponibilità dei nodi non riusciti, in modo da mantenere la distribuzione dei nodi.

1. Tutti i cluster si sincronizzano con il nuovo nodo primario.

Dopo che i nuovi nodi sono disponibili, occorre apportare le seguenti modifiche all'applicazione:
+ **Endpoint primario** - Non apportare modifiche all'applicazione. Il nome DNS del nuovo nodo primario viene propagato all'endpoint primario.
+ **Endpoint di lettura** - L'endpoint di lettura viene aggiornato automaticamente per puntare ai nuovi nodi di replica.

Per informazioni sull'individuazione degli endpoint di un gruppo di replica, consulta i seguenti argomenti:
+ [Ricerca degli endpoint (console) del cluster Valkey o Redis OSS (modalità cluster disabilitata)](Endpoints.md#Endpoints.Find.Redis)
+ [Individuazione degli endpoint per i gruppi di replica Valkey o Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Ricerca di endpoint per Valkey o Redis OSS Replication Groups (API) ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)

 

### Scenari di fallimento quando l'intero cluster non riesce
<a name="AutoFailover.Scenarios.AllFail"></a>

In caso di errore generale, tutti i nodi vengono ricreati e sottoposti a provisioning nelle stesse zone di disponibilità dei nodi originali. 

In questo scenario, tutti i dati nel cluster vengono persi a causa del guasto di ogni nodo nel cluster. Questa eventualità è rara.

In caso di guasto dell'intero cluster, ElastiCache Multi-AZ esegue le seguenti operazioni:

1. Il nodo primario e le repliche di lettura non riusciti vengono portati offline.

1. Un nodo primario sostitutivo viene creato e sottoposto a provisioning.

1. Repliche sostitutive vengono create e sottoposte a provisioning.

   Le sostituzioni vengono create nelle zone di disponibilità dei nodi non riusciti, in modo da mantenere la distribuzione dei nodi.

   Poiché l'intero cluster non è riuscito, i dati vengono persi e tutti i nuovi nodi vengono avviati come inattivi.

Poiché ciascuno dei nodi sostitutivi ha lo stesso endpoint del nodo che sta sostituendo, non occorre apportare modifiche all'endpoint nell'applicazione.

Per informazioni sull'individuazione degli endpoint di un gruppo di replica, consulta i seguenti argomenti:
+ [Ricerca degli endpoint (console) del cluster Valkey o Redis OSS (modalità cluster disabilitata)](Endpoints.md#Endpoints.Find.Redis)
+ [Individuazione degli endpoint per i gruppi di replica Valkey o Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Ricerca di endpoint per Valkey o Redis OSS Replication Groups (API) ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)

Ti consigliamo di creare il nodo primario e le repliche di lettura in zone di disponibilità diverse per aumentare il livello di tolleranza ai guasti.

## Test del failover automatico
<a name="auto-failover-test"></a>

Dopo aver abilitato il failover automatico, è possibile testarlo utilizzando la ElastiCache console AWS CLI, l'e l' ElastiCache API.

Durante il test, tieni presente quanto segue:
+ È possibile utilizzare questa operazione per testare il failover automatico su un massimo di 15 shard (chiamati gruppi di nodi nell' ElastiCache API e AWS CLI) in un periodo di 24 ore continuative.
+ Se chiami questa operazione su partizioni in cluster diversi (chiamati gruppi di replica nell'API e in CLI), puoi eseguire le chiamate contemporaneamente.
+ In alcuni casi, è possibile richiamare questa operazione più volte su shard diversi nello stesso gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). In questi casi, la sostituzione del primo nodo deve essere completata prima di effettuare una chiamata successiva.
+ Per determinare se la sostituzione del nodo è completa, controlla gli eventi utilizzando la ElastiCache console Amazon AWS CLI, l'o l' ElastiCache API. Cerca i seguenti eventi correlati al failover automatico, elencati qui in ordine di occorrenza:

  1. Messaggio del gruppo di replica: `Test Failover API called for node group <node-group-id>`

  1. Messaggio del cluster di cache: `Failover from primary node <primary-node-id> to replica node <node-id> completed`

  1. Messaggio del gruppo di replica: `Failover from primary node <primary-node-id> to replica node <node-id> completed`

  1. Messaggio del cluster di cache: `Recovering cache nodes <node-id>`

  1. Messaggio del cluster di cache: `Finished recovery for cache nodes <node-id>`

  Per ulteriori informazioni, consulta gli argomenti seguenti:
  + [Visualizzazione ElastiCache degli eventi](ECEvents.Viewing.md) nella *Guida per l'utente di ElastiCache *
  + [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html) nel *Documentazione di riferimento API di ElastiCache *
  + [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) nel *Riferimento ai comandi AWS CLI .*
+ Questa API è progettata per testare il comportamento dell'applicazione in caso di ElastiCache failover. Non è progettato per essere uno strumento operativo per l'avvio di un failover per risolvere un problema con il cluster. Inoltre, in determinate condizioni, come eventi operativi su larga scala, AWS può bloccare questa API.

**Topics**
+ [Test del failover automatico utilizzando Console di gestione AWS](#auto-failover-test-con)
+ [Test del failover automatico utilizzando AWS CLI](#auto-failover-test-cli)
+ [Test del failover automatico utilizzando l'API ElastiCache](#auto-failover-test-api)

### Test del failover automatico utilizzando Console di gestione AWS
<a name="auto-failover-test-con"></a>

Utilizza la procedura seguente per testare il failover automatico con la console.

**Per testare il failover automatico**

1. Accedi a Console di gestione AWS e apri la ElastiCache console all'indirizzo [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Nel pannello di navigazione, scegli **Valkey** o **Redis** OSS.

1. Dall'elenco dei cluster, scegli la casella a sinistra del cluster che desideri testare. Questo cluster deve disporre almeno di un nodo di replica di lettura.

1. Nell'area **Dettagli**, conferma che questo cluster è abilitato per Multi-AZ. Se il cluster non è abilitato per la funzione Multi-AZ, scegliere un cluster diverso o modificare questo cluster per abilitare la funzione Multi-AZ. Per ulteriori informazioni, consulta [Usando il ElastiCache Console di gestione AWS](Clusters.Modify.md#Clusters.Modify.CON).  
![\[Immagine: area dei dettagli di un cluster abilitato per Multi-AZ\]](http://docs.aws.amazon.com/it_it/AmazonElastiCache/latest/dg/images/ElastiCache-AutoFailover-MultiAZ-Enabled.png)

1. Per Valkey o Redis OSS (modalità cluster disabilitata), scegli il nome del cluster.

   Per Valkey o Redis OSS (modalità cluster abilitata), procedi come segue:

   1. Seleziona il nome del cluster. 

   1. Nella pagina **Shards (Partizioni)**, per la partizione (chiamato gruppo di nodi nell'API e in CLI) su cui desideri testare il failover, scegliere il nome della partizione. 

1. Nella pagina dei nodi, scegli **Failover Primary (Failover primario)**.

1. Scegli **Continua** per eseguire il failover nel nodo primario o **Annulla** per annullare l'operazione e non eseguire il failover nel nodo primario.

   Durante il processo di failover, la console continua a visualizzare lo stato del nodo come *disponibile*. Per monitorare l'avanzamento del test di failover, scegli **Eventi** dal riquadro di navigazione della console. Nella scheda **Eventi**, cerca gli eventi che indicano che il failover è stato avviato (`Test Failover API called`) e completato (`Recovery completed`).

 

### Test del failover automatico utilizzando AWS CLI
<a name="auto-failover-test-cli"></a>

È possibile testare il failover automatico su qualsiasi cluster dotato di Multi-AZ utilizzando l' AWS CLI operazione. `test-failover`

**Parametri**
+ `--replication-group-id` – Obbligatorio. Il gruppo di replica (sulla console, cluster) da testare.
+ `--node-group-id` – Obbligatorio. Il nome del gruppo di nodi sui cui testare il failover automatico. È possibile testare un massimo di 15 gruppi di nodi in un periodo continuativo di 24 ore.

L'esempio seguente lo utilizza AWS CLI per testare il failover automatico sul gruppo di nodi `redis00-0003` nel cluster Valkey o Redis OSS (modalità cluster abilitata). `redis00`

**Example Test del failover automatico**  
Per Linux, macOS o Unix:  

```
aws elasticache test-failover \
   --replication-group-id redis00 \
   --node-group-id redis00-0003
```
Per Windows:  

```
aws elasticache test-failover ^
   --replication-group-id redis00 ^
   --node-group-id redis00-0003
```

L'aspetto dell'output del comando precedente è simile al seguente.

```
{
    "ReplicationGroup": {
        "Status": "available", 
        "Description": "1 shard, 3 nodes (1 + 2 replicas)", 
        "NodeGroups": [
            {
                "Status": "available", 
                "NodeGroupMembers": [
                    {
                        "CurrentRole": "primary", 
                        "PreferredAvailabilityZone": "us-west-2c", 
                        "CacheNodeId": "0001", 
                        "ReadEndpoint": {
                            "Port": 6379, 
                            "Address": "redis1x3-001.7ekv3t.0001.usw2.cache.amazonaws.com"
                        }, 
                        "CacheClusterId": "redis1x3-001"
                    }, 
                    {
                        "CurrentRole": "replica", 
                        "PreferredAvailabilityZone": "us-west-2a", 
                        "CacheNodeId": "0001", 
                        "ReadEndpoint": {
                            "Port": 6379, 
                            "Address": "redis1x3-002.7ekv3t.0001.usw2.cache.amazonaws.com"
                        }, 
                        "CacheClusterId": "redis1x3-002"
                    }, 
                    {
                        "CurrentRole": "replica", 
                        "PreferredAvailabilityZone": "us-west-2b", 
                        "CacheNodeId": "0001", 
                        "ReadEndpoint": {
                            "Port": 6379, 
                            "Address": "redis1x3-003.7ekv3t.0001.usw2.cache.amazonaws.com"
                        }, 
                        "CacheClusterId": "redis1x3-003"
                    }
                ], 
                "NodeGroupId": "0001", 
                "PrimaryEndpoint": {
                    "Port": 6379, 
                    "Address": "redis1x3.7ekv3t.ng.0001.usw2.cache.amazonaws.com"
                }
            }
        ], 
        "ClusterEnabled": false, 
        "ReplicationGroupId": "redis1x3", 
        "SnapshotRetentionLimit": 1, 
        "AutomaticFailover": "enabled", 
        "MultiAZ": "enabled",
        "SnapshotWindow": "11:30-12:30", 
        "SnapshottingClusterId": "redis1x3-002", 
        "MemberClusters": [
            "redis1x3-001", 
            "redis1x3-002", 
            "redis1x3-003"
        ], 
        "CacheNodeType": "cache.m3.medium", 
        "DataTiering": "disabled",
        "PendingModifiedValues": {}
    }
}
```

Per tenere traccia dell'avanzamento del failover, utilizzare l'operazione. AWS CLI `describe-events`

Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [test-failover](https://docs.aws.amazon.com/cli/latest/reference/elasticache/test-failover.html) nel *Riferimento ai comandi AWS CLI .*
+ [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) nel *Riferimento ai comandi AWS CLI .*

 

### Test del failover automatico utilizzando l'API ElastiCache
<a name="auto-failover-test-api"></a>

È possibile testare il failover automatico su qualsiasi cluster abilitato con Multi-AZ utilizzando l'operazione ElastiCache API. `TestFailover`

**Parametri**
+ `ReplicationGroupId` – Obbligatorio. Il gruppo di replica (sulla console, cluster) da testare.
+ `NodeGroupId` – Obbligatorio. Il nome del gruppo di nodi sui cui testare il failover automatico. È possibile testare un massimo di 15 gruppi di nodi in un periodo continuativo di 24 ore.

L'esempio seguente esegue il test del failover automatico sul gruppo di nodi `redis00-0003` nel gruppo di replica (sulla console, cluster) `redis00`.

**Example Test del failover automatico**  

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=TestFailover
    &NodeGroupId=redis00-0003
    &ReplicationGroupId=redis00
    &Version=2015-02-02
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20140401T192317Z
    &X-Amz-Credential=<credential>
```

Per tenere traccia dell'avanzamento del failover, utilizzate l'operazione ElastiCache `DescribeEvents` API.

Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [TestFailover](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_TestFailover.html)nell'*ElastiCache API Reference* 
+ [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html)nell'*ElastiCache API Reference* 

 

## Limitazioni su Multi-AZ
<a name="AutoFailover.Limitations"></a>

Tieni presente le seguenti limitazioni per Multi-AZ:
+ Multi-AZ è supportato su Valkey e sulla versione 2.8.6 e successive di Redis OSS.
+ Multi-AZ non è supportato sui tipi di nodi T1.
+ La replica di Valkey e Redis OSS è asincrona. Pertanto, quando un nodo primario esegue il failover in una replica, si può verificare una piccola perdita di dati a causa del ritardo di replica.

  Quando si sceglie la replica da promuovere a principale, ElastiCache sceglie la replica con il minor ritardo di replica. ovvero quella più attuale. Ciò consente di ridurre al minimo la quantità di dati persi. La replica con il ritardo di replica minimo si può trovare nella stessa zona di disponibilità del nodo primario con errore o in una zona diversa.
+ Quando promuovi manualmente le repliche di lettura a primarie su cluster Valkey o Redis OSS con la modalità cluster disabilitata, puoi farlo solo quando Multi-AZ e il failover automatico sono disabilitati. Per promuovere una replica di lettura a nodo primario, procedi come indicato di seguito:

  1. Disabilitare la funzione Multi-AZ nel cluster.

  1. Disabilitare il failover automatico nel cluster. È possibile eseguire questa operazione tramite la console deselezionando la casella di controllo **Auto failover** per il gruppo di replica. È inoltre possibile eseguire questa operazione AWS CLI impostando la `AutomaticFailoverEnabled` proprietà su `false` quando si chiama l'operazione. `ModifyReplicationGroup`

  1. Promuovere la replica di lettura al nodo primario.

  1. Riattivare la funzione Multi-AZ.
+ ElastiCache per Redis OSS Multi-AZ e append-only file (AOF) si escludono a vicenda. Se si abilita una, non si può abilitare l'altra.
+ Un guasto del nodo può essere causato dal raro evento di errore di un'intera zona di disponibilità. In questo caso, la replica che sostituisce il nodo primario in errore viene creata solo quando la zona di disponibilità viene ripristinata. Ad esempio, considerare un gruppo di replica con il nodo primario in AZ e le repliche in AZ-b e AZ-c. Se il nodo primario non riesce, la replica con il tempo di replica minimo viene promossa al cluster primario. Quindi, ElastiCache crea una nuova replica in az-A (dove si trovava il file primario guasto) solo quando Az-a è di nuovo attivo e disponibile.
+ Un riavvio di un nodo primario iniziato dal cliente non attiva il failover automatico. Altri riavvi ed guasti attivano il failover automatico.
+ Ogni volta che il nodo primario viene riavviato, i dati vengono cancellati quando ritorna online. Quando le repliche di lettura rilevano il cluster primario cancellato, cancellano la loro copia dei dati causando perdita dei dati.
+ Dopo che una replica di lettura è stata promossa, le altre repliche si sincronizzano con il nuovo nodo primario. Dopo la sincronizzazione iniziale, il contenuto delle repliche viene eliminato e vengono sincronizzati i dati dal nuovo nodo primario. Questo processo di sincronizzazione causa una breve interruzione, durante la quale le repliche non sono accessibili. Il processo di sincronizzazione causa anche un incremento di carico temporaneo sul nodo primario durante la sincronizzazione con le repliche. Questo comportamento è nativo di Valkey e Redis OSS e non è esclusivo di Multi-AZ. ElastiCache Per i dettagli su questo comportamento, consulta [Replication](http://valkey.io/topics/replication) sul sito Web di Valkey.

**Importante**  
Per Valkey 7.2.6 e versioni successive o Redis OSS versione 2.8.22 e successive, non è possibile creare repliche esterne.  
Per le versioni Redis OSS precedenti alla 2.8.22, si consiglia di non connettere una replica esterna a un cluster con funzionalità Multi-AZ. ElastiCache Questa configurazione non supportata può creare problemi che impediscono la corretta esecuzione del failover e del ElastiCache ripristino. Per connettere una replica esterna a un ElastiCache cluster, assicurati che Multi-AZ non sia abilitato prima di effettuare la connessione.

# Modalità di implementazione di sincronizzazione e backup
<a name="Replication.Redis.Versions"></a>

Tutte le versioni supportate di Valkey e Redis OSS supportano il backup e la sincronizzazione tra i nodi primari e di replica. Tuttavia, il modo in cui vengono implementati il backup e la sincronizzazione varia a seconda della versione.

## Redis OSS versione 2.8.22 e successive
<a name="Replication.Redis.Version2-8-22"></a>

La replica Redis OSS, nelle versioni 2.8.22 e successive, è possibile scegliere tra due metodi. Per ulteriori informazioni, consultare [Versioni Redis OSS precedenti alla 2.8.22](#Replication.Redis.Earlier2-8-22) e [Snapshot e ripristino](backups.md).

Durante il processo senza fork, se i carichi di scrittura sono intensi, le scritture nel cluster vengono ritardate per garantire che non vengano accumulate troppe modifiche che impediscono la riuscita di una snapshot. 

## Versioni Redis OSS precedenti alla 2.8.22
<a name="Replication.Redis.Earlier2-8-22"></a>

Il backup e la sincronizzazione di Redis OSS nelle versioni precedenti alla 2.8.22 sono un processo in tre fasi.

1. Fork e il processo in background serializzano i dati del cluster su disco. Questo crea un'istantanea. point-in-time

1. In primo piano, accumulare un change log nel *buffer di output client*.
**Importante**  
Se il change log supera le dimensioni del *buffer di output del client*, l'operazione di backup o sincronizzazione non riesce. Per ulteriori informazioni, consulta [Garantire la disponibilità di memoria sufficiente per creare un'istantanea Valkey o Redis OSS](BestPractices.BGSAVE.md).

1. Infine, trasmettere i dati di cache e il change log al nodo di replica.

# Creazione di un gruppo di replica Valkey o Redis OSS
<a name="Replication.CreatingRepGroup"></a>

Per creare un cluster con nodi di replica sono disponibili le seguenti opzioni. Uno si applica quando è già disponibile un cluster Valkey o Redis OSS (modalità cluster disabilitata) non associato a nessun cluster che dispone di repliche da utilizzare come nodo principale. L'altra si applica quando desideri creare un nodo primario con il cluster e le repliche di lettura. Attualmente, un cluster Valkey o Redis OSS (modalità cluster abilitata) deve essere creato da zero.

**Opzione 1:[Creazione di un gruppo di replica utilizzando un cluster esistente](Replication.CreatingReplGroup.ExistingCluster.md)**  
Utilizzate questa opzione per sfruttare un cluster Valkey o Redis OSS (modalità cluster disabilitata) esistente a nodo singolo. Specifica questo nodo esistente come il nodo primario nel nuovo cluster e quindi aggiungi individualmente da 1 a 5 repliche di lettura al cluster. Se il cluster esistente è attivo, le repliche di lettura si sincronizzano con il cluster mentre vengono create. Consultare [Creazione di un gruppo di replica utilizzando un cluster esistente](Replication.CreatingReplGroup.ExistingCluster.md).  
Non è possibile creare un cluster Valkey o Redis OSS (modalità cluster abilitata) utilizzando un cluster esistente. Per creare un cluster Valkey o Redis OSS (modalità cluster abilitata) (API/CLI: gruppo di replica) utilizzando la console, vedere. ElastiCache [Creazione di un cluster Valkey o Redis OSS (modalità cluster abilitata) (Console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster)

**Opzione 2:[Creazione da zero di un gruppo di replica Valkey o Redis OSS](Replication.CreatingReplGroup.NoExistingCluster.md)**  
Utilizza questa opzione se non disponi già di un cluster Valkey o Redis OSS (modalità cluster disabilitata) da utilizzare come nodo primario del cluster o se desideri creare un cluster Valkey o Redis OSS (modalità cluster abilitata). Consultare [Creazione da zero di un gruppo di replica Valkey o Redis OSS](Replication.CreatingReplGroup.NoExistingCluster.md).

# Creazione di un gruppo di replica utilizzando un cluster esistente
<a name="Replication.CreatingReplGroup.ExistingCluster"></a>

La procedura seguente aggiunge un gruppo di replica al cluster a nodo singolo Valkey o Redis OSS (modalità cluster disabilitata), necessario per aggiornare il cluster all'ultima versione di Valkey. Si tratta di una procedura in loco che comporta zero tempi di inattività e zero perdite di dati. Quando si crea un gruppo di replica per un cluster a nodo singolo, il nodo del cluster diventa il nodo principale del nuovo cluster. Se non disponi di un cluster Valkey o Redis OSS (modalità cluster disabilitata) che puoi utilizzare come principale del nuovo cluster, vedi. [Creazione da zero di un gruppo di replica Valkey o Redis OSS](Replication.CreatingReplGroup.NoExistingCluster.md)

Un cluster disponibile è un cluster Valkey o Redis OSS esistente a nodo singolo. Attualmente, Valkey o Redis OSS (modalità cluster abilitata) non supportano la creazione di un cluster con repliche utilizzando un cluster a nodo singolo disponibile. Se desideri creare un cluster Valkey o Redis OSS (modalità cluster abilitata), consulta. [Creazione di un cluster Valkey o Redis OSS (modalità cluster abilitata) (console)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)

## Creazione di un gruppo di replica utilizzando un cluster esistente (Console)
<a name="Replication.CreatingReplGroup.ExistingCluster.CON"></a>

Consulta l'argomento [Utilizzando il ElastiCache Console di gestione AWS](Clusters.AddNode.md#Clusters.AddNode.CON)

## Creazione di un gruppo di replica utilizzando un cluster Valkey o Redis OSS disponibile ()AWS CLI
<a name="Replication.CreatingReplGroup.ExistingCluster.CLI"></a>

Esistono due passaggi per creare un gruppo di replica con repliche di lettura quando si utilizza un Valkey o Redis OSS Cache Cluster disponibile come primario quando si utilizza il.AWS CLI

Quando si utilizza il,AWS CLI si crea un gruppo di replica specificando il nodo standalone disponibile come nodo principale del cluster `--primary-cluster-id` e il numero di nodi che si desidera inserire nel cluster utilizzando il comando CLI,. `create-replication-group` Includi i seguenti parametri.

**--replication-group-id**  
Il nome del gruppo di replica che stai creando. Il valore di questo parametro viene utilizzato come la base per i nomi dei nodi aggiunti con un numero di tre cifre sequenziale aggiunto alla fine di `--replication-group-id`. Ad esempio, `sample-repl-group-001`.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**--replication-group-description**  
Descrizione del gruppo di replica.

**--num-node-groups**  
Numero di nodi desiderati in questo cluster. Questo valore include il nodo primario. Il valore massimo di questo parametro è sei.

**--primary-cluster-id**  
Il nome del nodo del cluster Valkey o Redis OSS (modalità cluster disabilitata) disponibile che si desidera utilizzare come nodo principale in questo gruppo di replica.

Il comando seguente crea il gruppo di replica `sample-repl-group` utilizzando il cluster Valkey o Redis OSS (modalità cluster disabilitata) disponibile `redis01` come nodo primario del gruppo di replica. Vengono creati due nuovi nodi che sono repliche di lettura. Le impostazioni di `redis01` (ovvero, gruppo di parametri, gruppo di sicurezza, tipo di nodo, versione motore e così via) verranno applicate a tutti i nodi nel gruppo di replica.

Per Linux, macOS o 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
```

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento.AWS CLI[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)

**Aggiunta di repliche di lettura al gruppo di replica**  
Dopo che il gruppo di replica è stato creato, aggiungi da una a cinque repliche di lettura utilizzando il comando `create-cache-cluster`, assicurandoti di includere i seguenti parametri. 

**--cache-cluster-id**  
Il nome del cluster che stai aggiungendo al gruppo di replica.  
I vincoli di denominazione dei cluster sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.


**--replication-group-id**  
Il nome del gruppo di replica a cui si sta aggiungendo questo cluster.

Ripeti questo comando per ogni replica di lettura che desideri aggiungere al gruppo di replica, modificando solo il valore del parametro `--cache-cluster-id`.

**Nota**  
Ricorda che un gruppo di replica non può contenere più di cinque repliche di lettura. Se tenti di aggiungere una replica di lettura a un gruppo di replica che contiene già cinque repliche di lettura, l'operazione non riesce.

Il codice seguente consente di aggiungere la replica di lettura `my-replica01` al gruppo di replica `sample-repl-group`. Le impostazioni del cluster primario, ovvero gruppo di parametri, gruppo di sicurezza, tipo di nodo e così via - verranno applicati ai nodi quando vengono aggiunti al gruppo di replica.

Per Linux, macOS o Unix:

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

Per Windows:

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

L'aspetto dell'output di questo comando sarà simile al seguente.

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

Per ulteriori informazioni, vedere gli AWS CLI argomenti:
+ [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)

## Aggiungere repliche a un cluster (API) Valkey o Redis OSS (Cluster Mode Disabled) autonomo ElastiCache
<a name="Replication.CreatingReplGroup.ExistingCluster.API"></a>

Quando si utilizza l' ElastiCache API, si crea un gruppo di replica specificando il nodo standalone disponibile come nodo primario del cluster `PrimaryClusterId` e il numero di nodi che si desidera inserire nel cluster utilizzando il comando CLI,. `CreateReplicationGroup` Includi i seguenti parametri.

**ReplicationGroupId**  
Il nome del gruppo di replica che stai creando. Il valore di questo parametro viene utilizzato come la base per i nomi dei nodi aggiunti con un numero di tre cifre sequenziale aggiunto alla fine di `ReplicationGroupId`. Ad esempio, `sample-repl-group-001`.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**ReplicationGroupDescription**  
Descrizione del cluster con repliche.

**NumCacheClusters**  
Numero di nodi desiderati in questo cluster. Questo valore include il nodo primario. Il valore massimo di questo parametro è sei.

**PrimaryClusterId**  
Il nome del cluster Valkey o Redis OSS (modalità cluster disabilitata) disponibile che si desidera utilizzare come nodo principale di questo cluster.

Il comando seguente crea il cluster con repliche `sample-repl-group` utilizzando il cluster Valkey o Redis OSS (modalità cluster disabilitata) disponibile `redis01` come nodo primario del gruppo di replica. Vengono creati due nuovi nodi che sono repliche di lettura. Le impostazioni di `redis01` (ovvero, gruppo di parametri, gruppo di sicurezza, tipo di nodo, versione motore e così via) verranno applicate a tutti i nodi nel gruppo di replica.

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

Per ulteriori informazioni, consulta gli argomenti APL: ElastiCache 
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)

**Aggiunta di repliche di lettura al gruppo di replica**  
Dopo che il gruppo di replica è stato creato, aggiungi a esso da una a cinque repliche di lettura utilizzando l'operazione `CreateCacheCluster`, assicurandoti di includere i seguenti parametri. 

**CacheClusterId**  
Il nome del cluster che stai aggiungendo al gruppo di replica.  
I vincoli di denominazione dei cluster sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.


**ReplicationGroupId**  
Il nome del gruppo di replica a cui si sta aggiungendo questo cluster.

Ripeti questa operazione per ogni replica di lettura che desideri aggiungere al gruppo di replica, modificando solo il valore del parametro `CacheClusterId`.

Il seguente codice aggiunge la replica di lettura `myReplica01` al gruppo di replica `myReplGroup` Le impostazioni del cluster primario, ovvero gruppo di parametri, gruppo di sicurezza, tipo di nodo e così via - verranno applicati ai nodi quando vengono aggiunti al gruppo di replica.

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento ElastiCache [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) API.

# Creazione da zero di un gruppo di replica Valkey o Redis OSS
<a name="Replication.CreatingReplGroup.NoExistingCluster"></a>

Di seguito, è possibile scoprire come creare un gruppo di replica Valkey o Redis OSS senza utilizzare un cluster Valkey o Redis OSS esistente come principale. È possibile creare un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) o Valkey o Redis OSS (modalità cluster abilitata) partendo da zero utilizzando la console, l'o l'API. ElastiCache AWS CLI ElastiCache

Prima di continuare, decidete se volete creare un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) o un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Per le linee guida, consulta [Replica: modalità cluster Valkey e Redis OSS disabilitata o abilitata](Replication.Redis-RedisCluster.md).

**Topics**
+ [Creazione da zero di un gruppo di replica Valkey o Redis OSS (Cluster Mode Disabled)](Replication.CreatingReplGroup.NoExistingCluster.Classic.md)
+ [Creazione da zero di un gruppo di replica in Valkey o Redis OSS (modalità cluster abilitata)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md)

# Creazione da zero di un gruppo di replica Valkey o Redis OSS (Cluster Mode Disabled)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic"></a>

È possibile creare un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) partendo da zero utilizzando la ElastiCache console, l'o l'API. AWS CLI ElastiCache Un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) ha sempre un gruppo di nodi, un cluster primario e fino a cinque repliche di lettura. I gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) non supportano il partizionamento dei dati.

**Nota**  
Il node/shard limite può essere aumentato fino a un massimo di 500 per cluster. Per richiedere un aumento dei limiti, consulta [AWS Limite dei servizi](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e includi il tipo di istanza nella richiesta.

Per creare da zero un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata), adotta uno dei seguenti approcci:

## Creazione da zero di un gruppo di replica Valkey o Redis OSS (Cluster Mode Disabled) ()AWS CLI
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic.CLI"></a>

La procedura seguente crea un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) utilizzando. AWS CLI

Quando si crea un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) partendo da zero, si crea il gruppo di replica e tutti i relativi nodi con una singola chiamata al comando. AWS CLI `create-replication-group` Includi i seguenti parametri.

**--replication-group-id**  
Il nome del gruppo di replica che stai creando.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**--replication-group-description**  
Descrizione del gruppo di replica.

**--num-cache-clusters**  
Il numero di nodi che devono essere creati con questo gruppo di replica, nodo primario e repliche di lettura combinati.  
Se abiliti Multi-AZ (`--automatic-failover-enabled`), il valore di `--num-cache-clusters` deve essere almeno 2.

**--cache-node-type**  
Il tipo di nodo per ogni nodo nel gruppo di replica.  
ElastiCache supporta i seguenti tipi di nodi. In generale, le generazioni attuali offrono più memoria e più potenza di elaborazione a un costo inferiore rispetto ai prodotti omologi della generazione precedente.  
Per ulteriori informazioni sui dettagli delle prestazioni per ogni tipo di nodo, consulta [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Impostare questo parametro se si utilizza un tipo di nodo r6gd. Se non si desidera il tiering di dati, impostare `--no-data-tiering-enabled`. Per ulteriori informazioni, consulta [Suddivisione dei dati su più livelli in ElastiCache](data-tiering.md).

**--cache-parameter-group**  
Specifica un gruppo di parametri che corrisponde alla versione motore. Se utilizzi Redis OSS 3.2.4 o versione successiva, specifica il gruppo di parametri o un gruppo di `default.redis3.2` parametri derivato da `default.redis3.2` cui creare un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata). Per ulteriori informazioni, consulta [Parametri Valkey e Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).

**--network-type**  
`ipv4`, `ipv6` o `dual-stack`. Se scegli dual-stack, devi impostare il parametro `--IpDiscovery` su `ipv4` o `ipv6`.

**--engine**  
redis

**--engine-version**  
Per disporre del più ampio set di caratteristiche, scegliere la versione motore più recente.

I nomi dei nodi verranno derivati dal nome del gruppo di replica aggiungendo `-00`*\$1*. Ad esempio, utilizzando il nome del gruppo di replica `myReplGroup`, il nome del primario sarà `myReplGroup-001` e le repliche di lettura da `myReplGroup-002` a `myReplGroup-006`.

Se desideri abilitare la crittografia dei dati in transito o dei dati inattivi su questo gruppo di replica, aggiungi uno o entrambi i parametri `--transit-encryption-enabled` o `--at-rest-encryption-enabled` e soddisfa le seguenti condizioni.
+ Il gruppo di replica deve eseguire Redis OSS versione 3.2.6 o 4.0.10.
+ Il gruppo di replica deve essere creato in un Amazon VPC.
+ Devi anche includere il parametro `--cache-subnet-group`.
+ Deve anche includere il parametro `--auth-token` con il valore stringa specificato dal cliente per il token AUTH (password) necessario per eseguire operazioni su questo gruppo di replica.

La seguente operazione crea un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) `sample-repl-group` con tre nodi, uno principale e due repliche.

Per Linux, macOS o 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
```

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

L'aspetto dell'output di questo comando è simile al seguente.

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento. AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)

## Creazione da zero di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) (API) ElastiCache
<a name="Replication.CreatingReplGroup.NoExistingCluster.Classic.API"></a>

La procedura seguente crea un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) utilizzando l'API. ElastiCache 

Quando si crea un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) partendo da zero, si crea il gruppo di replica e tutti i relativi nodi con una singola chiamata all'operazione API. ElastiCache `CreateReplicationGroup` Includi i seguenti parametri.

**ReplicationGroupId**  
Il nome del gruppo di replica che stai creando.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (modalità cluster abilitata) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**ReplicationGroupDescription**  
La descrizione del gruppo di replica.

**NumCacheClusters**  
Il numero totale di nodi che devono essere creati con questo gruppo di replica, nodo primario e repliche di lettura combinati.  
Se abiliti Multi-AZ (`AutomaticFailoverEnabled=true`), il valore di `NumCacheClusters` deve essere almeno 2.

**CacheNodeType**  
Il tipo di nodo per ogni nodo nel gruppo di replica.  
ElastiCache supporta i seguenti tipi di nodi. In generale, le generazioni attuali offrono più memoria e più potenza di elaborazione a un costo inferiore rispetto ai prodotti omologi della generazione precedente.  
Per ulteriori informazioni sui dettagli delle prestazioni per ogni tipo di nodo, consulta [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Impostare questo parametro se si utilizza un tipo di nodo r6gd. Se non si desidera il tiering di dati, impostare `--no-data-tiering-enabled`. Per ulteriori informazioni, consulta [Suddivisione dei dati su più livelli in ElastiCache](data-tiering.md).

**CacheParameterGroup**  
Specifica un gruppo di parametri che corrisponde alla versione motore. Se utilizzi Redis OSS 3.2.4 o versione successiva, specifica il gruppo di parametri o un gruppo di `default.redis3.2` parametri derivato da `default.redis3.2` cui creare un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata). Per ulteriori informazioni, consulta [Parametri Valkey e Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).

**--network-type**  
`ipv4`, `ipv` o `dual-stack`. Se scegli dual-stack, devi impostare il parametro `--IpDiscovery` su `ipv4` o `ipv6`.

**Motore**  
redis

**EngineVersion**  
6.0

I nomi dei nodi verranno derivati dal nome del gruppo di replica aggiungendo `-00`*\$1*. Ad esempio, utilizzando il nome del gruppo di replica `myReplGroup`, il nome del primario sarà `myReplGroup-001` e le repliche di lettura da `myReplGroup-002` a `myReplGroup-006`.

Se desideri abilitare la crittografia dei dati in transito o dei dati inattivi su questo gruppo di replica, aggiungi uno o entrambi i parametri `TransitEncryptionEnabled=true` o `AtRestEncryptionEnabled=true` e soddisfa le seguenti condizioni.
+ Il gruppo di replica deve eseguire Redis OSS versione 3.2.6 o 4.0.10.
+ Il gruppo di replica deve essere creato in un Amazon VPC.
+ Devi anche includere il parametro `CacheSubnetGroup`.
+ Deve anche includere il parametro `AuthToken` con il valore stringa specificato dal cliente per il token AUTH (password) necessario per eseguire operazioni su questo gruppo di replica.

La seguente operazione crea il gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) `myReplGroup` con tre nodi, uno principale e due repliche.

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento API. ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)

# Creazione da zero di un gruppo di replica in Valkey o Redis OSS (modalità cluster abilitata)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster"></a>

È possibile creare un cluster Valkey o Redis OSS (modalità cluster abilitata) (API/CLI: *gruppo di replica*) utilizzando la ElastiCache console, l'o l'API. AWS CLI ElastiCache Un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata) ha da 1 a 500 shard (API/CLI: gruppi di nodi), un nodo primario in ogni shard e fino a 5 repliche di lettura in ogni shard. Puoi creare un cluster con un numero più alto dle partizioni e un numero più basso di repliche per un totale di 90 nodi per cluster. Questa configurazione del cluster può andare da 90 partizioni e 0 repliche a 15 partizioni e 5 repliche che è il numero massimo consentito di repliche.

Il limite di nodi o shard può essere aumentato fino a un massimo di 500 per cluster se la versione del motore OSS Valkey o Redis è 5.0.6 o successiva. Ad esempio, è possibile scegliere di configurare un cluster a 500 nodi che varia tra 83 partizioni (un primario e 5 repliche per partizione) e 500 partizioni (un singolo primario e nessuna replica). Assicurati che esistano abbastanza indirizzi IP disponibili per soddisfare l'aumento. Le problematiche comuni sono che le le sottoreti nel gruppo di sottoreti hanno un intervallo CIDR troppo piccolo o che le sottoreti sono condivise e utilizzate pesantemente da altri cluster. Per ulteriori informazioni, consulta [Creazione di un gruppo di sottoreti](SubnetGroups.Creating.md).

 Per le versioni inferiori alla 5.0.6, il limite è 250 per cluster.

Per richiedere un aumento dei limiti, consulta [Limiti dei servizi AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e seleziona il tipo di limite **Nodi per cluster per tipo di istanza**. 

**Topics**
+ [Utilizzo della console ElastiCache](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
+ [Creazione da zero di un gruppo di replica Valkey o Redis OSS (Cluster Mode Enabled) ()AWS CLI](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)
+ [Creazione da zero di un gruppo di replica in Valkey o Redis OSS (Cluster Mode Enabled) (API) ElastiCache](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)

## Creazione di un cluster Valkey o Redis OSS (modalità cluster abilitata) (console)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON"></a>

Per creare un cluster Valkey o Redis OSS (modalità cluster abilitata), vedere. [Creazione di un cluster Valkey o Redis OSS (modalità cluster abilitata) (Console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster) Assicurati di abilitare la modalità cluster, **Cluster Mode enabled (Modalità cluster abilitata (scalabilità orizzontale))**, e specifica almeno due partizioni e un nodo di replica in ciascuno di essi.

## Creazione da zero di un gruppo di replica Valkey o Redis OSS (Cluster Mode Enabled) ()AWS CLI
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI"></a>

La procedura seguente crea un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata) utilizzando. AWS CLI

Quando si crea un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata) partendo da zero, si crea il gruppo di replica e tutti i relativi nodi con una singola chiamata al comando. AWS CLI `create-replication-group` Includi i seguenti parametri.

**--replication-group-id**  
Il nome del gruppo di replica che stai creando.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (modalità cluster abilitata) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**--replication-group-description**  
Descrizione del gruppo di replica.

**--cache-node-type**  
Il tipo di nodo per ogni nodo nel gruppo di replica.  
ElastiCache supporta i seguenti tipi di nodi. In generale, le generazioni attuali offrono più memoria e più potenza di elaborazione a un costo inferiore rispetto ai prodotti omologi della generazione precedente.  
Per ulteriori informazioni sui dettagli delle prestazioni per ogni tipo di nodo, consulta [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Impostare questo parametro se si utilizza un tipo di nodo r6gd. Se non si desidera il tiering di dati, impostare `--no-data-tiering-enabled`. Per ulteriori informazioni, consulta [Suddivisione dei dati su più livelli in ElastiCache](data-tiering.md).

**--cache-parameter-group**  
Specificare il gruppo di `default.redis6.x.cluster.on` parametri o un gruppo di parametri da cui creare un gruppo di replica Valkey o Redis OSS (modalità `default.redis6.x.cluster.on` cluster abilitata). Per ulteriori informazioni, consulta [Modifiche ai parametri di Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--engine**  
redis

**--engine-version**  
3.2.4

**--num-node-groups**  
Il numero di gruppi di nodi in questo gruppo di replica. I valori validi sono compresi tra 1 e 500.  
Il node/shard limite può essere aumentato fino a un massimo di 500 per cluster. Per richiedere un aumento dei limiti, consulta [AWS Limite del servizio](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e seleziona il tipo di limite “nodi per cluster per tipo di istanza”. 

**--replicas-per-node-group**  
Il numero di nodi di replica in ogni gruppo di nodi. I valori validi sono compresi tra 0 e 5.

**--network-type**  
`ipv4`, `ipv` o `dual-stack`. Se scegli dual-stack, devi impostare il parametro `--IpDiscovery` su `ipv4` o `ipv6`.

Se desideri abilitare la crittografia dei dati in transito o dei dati inattivi su questo gruppo di replica, aggiungi uno o entrambi i parametri `--transit-encryption-enabled` o `--at-rest-encryption-enabled` e soddisfa le seguenti condizioni.
+ Il gruppo di replica deve eseguire Redis OSS versione 3.2.6 o 4.0.10.
+ Il gruppo di replica deve essere creato in un Amazon VPC.
+ Devi anche includere il parametro `--cache-subnet-group`.
+ Deve anche includere il parametro `--auth-token` con il valore stringa specificato dal cliente per il token AUTH (password) necessario per eseguire operazioni su questo gruppo di replica.

La seguente operazione crea il gruppo di replica Valkey o Redis OSS (modalità cluster enabled) con tre nodi groups/shards (--num-node-groups), ciascuno `sample-repl-group` con tre nodi, una replica primaria e due di lettura (--). replicas-per-node-group

Per Linux, macOS o 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>
```

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

Il comando precedente genera il seguente output.

```
{
    "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 si crea un gruppo di replica Valkey o Redis OSS (modalità cluster enabled) da zero, è possibile configurare ogni shard del cluster utilizzando il `--node-group-configuration` parametro come mostrato nell'esempio seguente che configura due gruppi di nodi (Console: shards). La prima partizione dispone di due nodi, un nodo primario e una replica di lettura. La seconda partizione dispone di tre nodi, un nodo primario e due repliche di lettura.

**--node-group-configuration**  
La configurazione per ogni gruppo di nodi. Il parametro `--node-group-configuration` è costituito dai seguenti campi:  
+ `PrimaryAvailabilityZone` - La zona di disponibilità in cui si trova il nodo primario di questo gruppo di nodi. Se questo parametro viene omesso, ElastiCache sceglie la zona di disponibilità per il nodo primario.

  **Esempio:** us-west-2a.
+ `ReplicaAvailabilityZones` - Un elenco separato da virgole di zone di disponibilità in cui si trovano le repliche di lettura. Il numero di zone di disponibilità in questo elenco deve corrispondere al valore di `ReplicaCount`. Se questo parametro viene omesso, ElastiCache sceglie le zone di disponibilità per i nodi di replica.

  **Esempio:** "us-west-2a,us-west-2b,us-west-2c"
+ `ReplicaCount` : Il numero di nodi di replica in questo gruppo di nodi.
+ `Slots` - Una stringa che specifica il keyspace per il gruppo di nodi. Il formato della stringa è `startKey-endKey`. Se questo parametro viene omesso, ElastiCache alloca le chiavi in modo equo tra i gruppi di nodi.

  **Esempio:** "0-4999"

   

La seguente operazione crea il gruppo di replica Valkey o Redis OSS (modalità cluster enabled) `new-group` con due gruppi di nodi/shard (). `--num-node-groups` A differenza dell'esempio precedente, ogni gruppo di nodi è configurato in modo diverso rispetto all'altro gruppo di nodi (`--node-group-configuration`).

Per Linux, macOS o 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'"
```

Per 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'"
```

L'operazione precedente genera il seguente output.

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento. AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)

## Creazione da zero di un gruppo di replica in Valkey o Redis OSS (Cluster Mode Enabled) (API) ElastiCache
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.API"></a>

La procedura seguente crea un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata) utilizzando l'API. ElastiCache 

Quando si crea un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata) partendo da zero, si crea il gruppo di replica e tutti i relativi nodi con una singola chiamata all'operazione API. ElastiCache `CreateReplicationGroup` Includi i seguenti parametri.

**ReplicationGroupId**  
Il nome del gruppo di replica che stai creando.  
I vincoli di denominazione dei gruppi di replica Valkey o Redis OSS (abilitata in modalità cluster) sono i seguenti:  
+ Devono contenere da 1 a 40 caratteri alfanumerici o trattini.
+ Devono iniziare con una lettera.
+ Non possono contenere due trattini consecutivi.
+ Non possono terminare con un trattino.

**ReplicationGroupDescription**  
Descrizione del gruppo di replica.

**NumNodeGroups**  
Il numero di gruppi di nodi che deve essere creato con questo gruppo di replica. I valori validi sono compresi tra 1 e 500.

**ReplicasPerNodeGroup**  
Il numero di nodi di replica in ogni gruppo di nodi. I valori validi sono compresi tra 1 e 5.

**NodeGroupConfiguration**  
La configurazione per ogni gruppo di nodi. Il parametro `NodeGroupConfiguration` è costituito dai seguenti campi:  
+ `PrimaryAvailabilityZone` - La zona di disponibilità in cui si trova il nodo primario di questo gruppo di nodi. Se questo parametro viene omesso, ElastiCache sceglie la zona di disponibilità per il nodo primario.

  **Esempio:** us-west-2a.
+ `ReplicaAvailabilityZones` - Un elenco di zone di disponibilità in cui si trovano le repliche di lettura. Il numero di zone di disponibilità in questo elenco deve corrispondere al valore di `ReplicaCount`. Se questo parametro viene omesso, ElastiCache sceglie le zone di disponibilità per i nodi di replica.
+ `ReplicaCount` : Il numero di nodi di replica in questo gruppo di nodi.
+ `Slots` - Una stringa che specifica il keyspace per il gruppo di nodi. Il formato della stringa è `startKey-endKey`. Se questo parametro viene omesso, ElastiCache alloca le chiavi in modo equo tra i gruppi di nodi.

  **Esempio:** "0-4999"

   

**CacheNodeType**  
Il tipo di nodo per ogni nodo nel gruppo di replica.  
ElastiCache supporta i seguenti tipi di nodi. In generale, le generazioni attuali offrono più memoria e più potenza di elaborazione a un costo inferiore rispetto ai prodotti omologi della generazione precedente.  
Per ulteriori informazioni sui dettagli delle prestazioni per ogni tipo di nodo, consulta [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Impostare questo parametro se si utilizza un tipo di nodo r6gd. Se non si desidera il tiering di dati, impostare `--no-data-tiering-enabled`. Per ulteriori informazioni, consulta [Suddivisione dei dati su più livelli in ElastiCache](data-tiering.md).

**CacheParameterGroup**  
Specificare il gruppo di `default.redis6.x.cluster.on` parametri o un gruppo di parametri da cui creare un gruppo di replica Valkey o Redis OSS (modalità `default.redis6.x.cluster.on` cluster abilitata). Per ulteriori informazioni, consulta [Modifiche ai parametri di Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--network-type**  
`ipv4`, `ipv` o `dual-stack`. Se scegli dual-stack, devi impostare il parametro `--IpDiscovery` su `ipv4` o `ipv6`.

**Motore**  
redis

**EngineVersion**  
6.0

Se desideri abilitare la crittografia dei dati in transito o dei dati inattivi su questo gruppo di replica, aggiungi uno o entrambi i parametri `TransitEncryptionEnabled=true` o `AtRestEncryptionEnabled=true` e soddisfa le seguenti condizioni.
+ Il gruppo di replica deve eseguire Redis OSS versione 3.2.6 o 4.0.10.
+ Il gruppo di replica deve essere creato in un Amazon VPC.
+ Devi anche includere il parametro `CacheSubnetGroup`.
+ Deve anche includere il parametro `AuthToken` con il valore stringa specificato dal cliente per il token AUTH (password) necessario per eseguire operazioni su questo gruppo di replica.

Le interruzioni di riga vengono aggiunte per facilitare la lettura.

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

Per ulteriori informazioni e parametri che potresti voler utilizzare, consulta l'argomento API. ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)

# Visualizzazione dei dettagli del gruppo di replica
<a name="Replication.ViewDetails"></a>

A volte potrebbe essere necessario visualizzare i dettagli di un gruppo di replica. Puoi usare la ElastiCache console, il AWS CLI for ElastiCache o l' ElastiCache API. Il processo della console è diverso per Valkey o Redis OSS (modalità cluster disabilitata) e Valkey o Redis OSS (modalità cluster abilitata).

**Contents**
+ [Visualizzazione di un Valkey o Redis OSS (modalità cluster disabilitata) con repliche](Replication.ViewDetails.Redis.md)
  + [Utilizzo della console ElastiCache](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CON)
  + [Utilizzo del AWS CLI](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CLI)
  + [Utilizzo dell'API ElastiCache](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.API)
+ [Visualizzazione di un gruppo di replica: Valkey o Redis OSS (modalità cluster abilitata)](Replication.ViewDetails.RedisCluster.md)
  + [Utilizzo della console ElastiCache](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CON)
  + [Utilizzando il AWS CLI](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CLI)
  + [Utilizzo dell'API ElastiCache](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.API)
+ [Visualizzazione dei dettagli di un gruppo di replica (AWS CLI)](Replication.ViewDetails.CLI.md)
+ [Visualizzazione dei dettagli di un gruppo di replica (ElastiCache API)](Replication.ViewDetails.API.md)

# Visualizzazione di un Valkey o Redis OSS (modalità cluster disabilitata) con repliche
<a name="Replication.ViewDetails.Redis"></a>

È possibile visualizzare i dettagli di un cluster Valkey o Redis OSS (modalità cluster disabilitata) con repliche (API/CLI: *gruppo di replica*) utilizzando la ElastiCache console, il for o l'API. AWS CLI ElastiCache ElastiCache 

**Contents**
+ [Utilizzo della console ElastiCache](#Replication.ViewDetails.Redis.CON)
+ [Utilizzo del AWS CLI](#Replication.ViewDetails.Redis.CLI)
+ [Utilizzo dell'API ElastiCache](#Replication.ViewDetails.Redis.API)

## Visualizzazione di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) (console)
<a name="Replication.ViewDetails.Redis.CON"></a>

Per visualizzare i dettagli di un cluster Valkey o Redis OSS (modalità cluster disabilitata) con repliche utilizzando la ElastiCache console, consulta l'argomento. [Visualizzazione dei dettagli di Valkey o Redis OSS (modalità cluster disabilitata) (console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.Redis)

## Visualizzazione di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) ()AWS CLI
<a name="Replication.ViewDetails.Redis.CLI"></a>

Per un AWS CLI esempio che visualizza i dettagli di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata), vedere. [Visualizzazione dei dettagli di un gruppo di replica (AWS CLI)](Replication.ViewDetails.CLI.md)

## Visualizzazione di un gruppo di replica (API) Valkey o Redis OSS (modalità cluster disabilitata) ElastiCache
<a name="Replication.ViewDetails.Redis.API"></a>

Per un esempio di ElastiCache API che mostra i dettagli di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata), consulta. [Visualizzazione dei dettagli di un gruppo di replica (ElastiCache API)](Replication.ViewDetails.API.md)

# Visualizzazione di un gruppo di replica: Valkey o Redis OSS (modalità cluster abilitata)
<a name="Replication.ViewDetails.RedisCluster"></a>

## Visualizzazione di un cluster Valkey o Redis OSS (Cluster Mode Enabled) (console)
<a name="Replication.ViewDetails.RedisCluster.CON"></a>

Per visualizzare i dettagli di un cluster Valkey o Redis OSS (modalità cluster abilitata) utilizzando la ElastiCache console, vedere. [Visualizzazione dei dettagli per un cluster Valkey o Redis OSS (Cluster Mode Enabled) (Console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.RedisCluster)

## Visualizzazione di un cluster Valkey o Redis OSS (Cluster Mode Enabled) ()AWS CLI
<a name="Replication.ViewDetails.RedisCluster.CLI"></a>

Per un esempio ElastiCache CLI che mostra i dettagli di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata), vedere. [Visualizzazione dei dettagli di un gruppo di replica (AWS CLI)](Replication.ViewDetails.CLI.md)

## Visualizzazione di un cluster (API) Valkey o Redis OSS (Cluster Mode Enabled) ElastiCache
<a name="Replication.ViewDetails.RedisCluster.API"></a>

Per un esempio di ElastiCache API che mostra i dettagli di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata), consulta. [Visualizzazione dei dettagli di un gruppo di replica (ElastiCache API)](Replication.ViewDetails.API.md)

# Visualizzazione dei dettagli di un gruppo di replica (AWS CLI)
<a name="Replication.ViewDetails.CLI"></a>

È possibile visualizzare i dettagli di un gruppo di replica utilizzando il AWS CLI `describe-replication-groups` comando. Utilizza i seguenti parametri opzionali per perfezionare l'elenco. Se si omettono i parametri, vengono restituiti i dettagli per un massimo di 100 gruppi di replica.

**Parametri facoltativi**
+ `--replication-group-id` - Utilizza questo parametro per elencare i dettagli di un gruppo di replica specifico. Se il gruppo di replica specificato dispone di più gruppi di nodi, i risultati vengono restituiti raggruppati per gruppo di nodi.
+ `--max-items` - Utilizza questo parametro per limitare il numero di gruppi di replica elencati. Il valore di `--max-items` non può essere minore di 20 o maggiore di 100.

**Example**  
Il codice seguente consente di elencare i dettagli per un massimo di 100 gruppi di replica.  

```
aws elasticache describe-replication-groups
```
Il codice seguente consente di elencare i dettagli per `sample-repl-group`.  

```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
Il codice seguente consente di elencare i dettagli per `sample-repl-group`.  

```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
Il codice seguente consente di elencare i dettagli per un massimo di 25 gruppi di replica.  

```
aws elasticache describe-replication-groups --max-items 25
```
L'aspetto dell'output di questa operazione è simile al seguente (in formato JSON).  

```
{
   "ReplicationGroups": [
     {
       "Status": "available", 
       "Description": "test", 
       "NodeGroups": [
         {
            "Status": "available", 
               "NodeGroupMembers": [
                  {
                     "CurrentRole": "primary", 
                     "PreferredAvailabilityZone": "us-west-2a", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-001.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-001"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2b", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-002.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-002"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2c", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-003.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-003"
                  }
               ], 
               "NodeGroupId": "0001", 
               "PrimaryEndpoint": {
                  "Port": 6379, 
                  "Address": "rg-name.1abc4d.ng.0001.usw2.cache.amazonaws.com"
               }
            }
         ], 
         "ReplicationGroupId": "rg-name", 
         "AutomaticFailover": "enabled", 
         "SnapshottingClusterId": "rg-name-002", 
         "MemberClusters": [
            "rg-name-001", 
            "rg-name-002", 
            "rg-name-003"
         ], 
         "PendingModifiedValues": {}
      }, 
      {
      ... some output omitted for brevity
      }
   ]
}
```

Per ulteriori informazioni, consultate l' ElastiCache argomento AWS CLI [describe-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-replication-groups.html) per.

# Visualizzazione dei dettagli di un gruppo di replica (ElastiCache API)
<a name="Replication.ViewDetails.API"></a>

È possibile visualizzare i dettagli di una replica utilizzando l' AWS CLI `DescribeReplicationGroups`operazione. Utilizza i seguenti parametri opzionali per perfezionare l'elenco. Se si omettono i parametri, vengono restituiti i dettagli per un massimo di 100 gruppi di replica.

**Parametri facoltativi**
+ `ReplicationGroupId` - Utilizza questo parametro per elencare i dettagli di un gruppo di replica specifico. Se il gruppo di replica specificato dispone di più gruppi di nodi, i risultati vengono restituiti raggruppati per gruppo di nodi.
+ `MaxRecords` - Utilizza questo parametro per limitare il numero di gruppi di replica elencati. Il valore di `MaxRecords` non può essere minore di 20 o maggiore di 100. Il valore di default è 100.

**Example**  
Il codice seguente consente di elencare i dettagli per un massimo di 100 gruppi di replica.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```
Il codice seguente consente di elencare i dettagli per `myReplGroup`.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```
Il codice seguente consente di elencare i dettagli per un massimo di 25 cluster.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &MaxRecords=25
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Per ulteriori informazioni, consulta l'argomento di riferimento sull' ElastiCache [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html)API.

# Individuazione di endpoint del gruppo di replica
<a name="Replication.Endpoints"></a>

Un'applicazione può connettersi a qualsiasi nodo in un gruppo di replica, purché disponga dell'endpoint DNS e del numero di porta per tale nodo. A seconda che stiate utilizzando un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) o un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata), sarete interessati a diversi endpoint.

**Valkey o Redis OSS (modalità cluster disabilitata)**  
**I cluster Valkey o Redis OSS (modalità cluster disabilitata) con repliche hanno tre tipi di endpoint: l'endpoint *primario, l'endpoint reader e gli endpoint* del nodo.** L'endpoint primario è un nome DNS che viene sempre risolto nel nodo primario nel cluster. L'endpoint primario è immune a modifiche al cluster, ad esempio la promozione di una replica di lettura al ruolo primario. Per attività di scrittura, è preferibile collegare le applicazioni all'endpoint primario.

Un endpoint di lettura dividerà in modo uniforme le connessioni in entrata all'endpoint tra tutte le repliche di lettura in un cluster. ElastiCache Ulteriori fattori come, ad esempio, quando l'applicazione crea le connessioni o il modo in cui l'applicazione riutilizza le connessioni determineranno la distribuzione del traffico. Gli endpoint di lettura mantengono le modifiche ai cluster in tempo reale mano a mano che le repliche vengono aggiunte o rimosse. È possibile collocare le repliche di lettura multiple del cluster ElastiCache for Redis OSS in diverse zone di disponibilità (AZ) per garantire l'elevata AWS disponibilità degli endpoint di lettura. 

**Nota**  
Un endpoint di lettura non è un servizio di load balancer. Si tratta di un record DNS che si risolverà in un indirizzo IP di uno dei nodi di replica in modo round robin.

Per attività di lettura, le applicazioni possono inoltre connettersi a qualsiasi nodo nel cluster. A differenza dell'endpoint primario, gli endpoint dei nodi vengono risolti in endpoint specifici. Se apporti una modifica al cluster, ad esempio aggiungendo o eliminando una replica, devi aggiornare gli endpoint dei nodi nell'applicazione.

**Valkey o Redis OSS (modalità cluster abilitata)**  
I cluster Valkey o Redis OSS (modalità cluster abilitata) con repliche, poiché dispongono di più shard (API/CLI: gruppi di nodi), il che significa che hanno anche più nodi primari, hanno una struttura di endpoint diversa rispetto ai cluster Valkey o Redis OSS (modalità cluster disabilitata). Valkey o Redis OSS (modalità cluster abilitata) dispone di un endpoint di *configurazione che «conosce» tutti gli endpoint* primari e i nodi del cluster. L'applicazione si connette all'endpoint di configurazione. Ogni volta che l'applicazione scrive o legge dall'endpoint di configurazione del cluster, Valkey e Redis OSS, dietro le quinte, determinano a quale shard appartiene la chiave e quale endpoint dello shard utilizzare. Tutto è trasparente all'applicazione.

Puoi trovare gli endpoint per un cluster utilizzando la console, l'o l' ElastiCache API. AWS CLI ElastiCache 

**Individuazione di endpoint del gruppo di replica**

Per trovare gli endpoint per il gruppo di replica, consulta uno dei seguenti argomenti:
+ [Ricerca degli endpoint (console) del cluster Valkey o Redis OSS (modalità cluster disabilitata)](Endpoints.md#Endpoints.Find.Redis)
+ [Ricerca degli endpoint per un cluster (console) Valkey o Redis OSS (modalità cluster abilitata)](Endpoints.md#Endpoints.Find.RedisCluster)
+ [Individuazione degli endpoint per i gruppi di replica Valkey o Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Ricerca di endpoint per Valkey o Redis OSS Replication Groups (API) ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)

# Modifica di un gruppo di replica
<a name="Replication.Modify"></a>

**Vincoli importanti**  
Attualmente, ElastiCache supporta modifiche limitate di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata), ad esempio la modifica della versione del motore, utilizzando l'operazione API (`ModifyReplicationGroup`CLI:). `modify-replication-group` È possibile modificare il numero di shard (gruppi di nodi) in un cluster Valkey o Redis OSS (modalità cluster abilitata) con l'operazione API ([https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html)CLI:). [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html) Per ulteriori informazioni, consulta [Scalabilità dei cluster Valkey o Redis OSS (Cluster Mode Enabled)](scaling-redis-cluster-mode-enabled.md).  
Altre modifiche a un cluster Valkey o Redis OSS (modalità cluster abilitata) richiedono la creazione di un cluster con il nuovo cluster che incorpora le modifiche.
È possibile aggiornare i cluster e i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) e Valkey o Redis OSS (modalità cluster abilitata) a versioni più recenti del motore. Tuttavia, non puoi eseguire il downgrade alle versioni precedenti del motore se non eliminando il cluster esistente o il gruppo di replica e creandolo di nuovo. Per ulteriori informazioni, consulta [Gestione delle versioni per ElastiCache](VersionManagement.md).
È possibile aggiornare un cluster esistente ElastiCache per Valkey o Redis OSS che utilizza la modalità cluster disabilitata per utilizzare la modalità cluster abilitata, utilizzando la console, l'[ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)API o il comando [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)CLI, come mostrato nell'esempio seguente. Oppure, puoi seguire la procedura descritta in [Modifica della modalità cluster.](modify-cluster-mode.md)

È possibile modificare le impostazioni di un cluster Valkey o Redis OSS (modalità cluster disabilitata) utilizzando la ElastiCache console, l'o l' AWS CLI API. ElastiCache Attualmente, ElastiCache supporta un numero limitato di modifiche su un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Altre modifiche richiedono la creazione di un backup del gruppo di replica corrente e l'utilizzo di tale backup per avviare un nuovo gruppo di replica Valkey o Redis OSS (abilitato in modalità cluster).

**Topics**
+ [Utilizzando il Console di gestione AWS](#Replication.Modify.CON)
+ [Utilizzo del AWS CLI](#Replication.Modify.CLI)
+ [Utilizzo dell'API ElastiCache](#Replication.Modify.API)

## Utilizzando il Console di gestione AWS
<a name="Replication.Modify.CON"></a>

Per modificare un cluster Valkey o Redis OSS (modalità cluster disabilitata), vedere. [Modifica di un cluster ElastiCache](Clusters.Modify.md)

## Utilizzo del AWS CLI
<a name="Replication.Modify.CLI"></a>

Di seguito sono AWS CLI riportati alcuni esempi del `modify-replication-group` comando. Puoi utilizzare lo stesso comando per apportare altre modifiche a un gruppo di replica.

**Abilita Multi-AZ su un gruppo di replica Valkey o Redis OSS esistente:**

Per Linux, macOS o Unix:

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --multi-az-enabled = true
```

Per Windows:

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --multi-az-enabled
```

**Modifica della modalità cluster da disabilitata ad abilitata:**

Per modificare la modalità cluster da *disabilitata* ad *abilitata*, è necessario innanzitutto impostare la modalità cluster su *compatibile*. La modalità compatibile consente ai client Valkey o Redis OSS di connettersi utilizzando la modalità cluster abilitata o disabilitata. *Dopo aver migrato tutti i client Valkey o Redis OSS per utilizzare la modalità cluster abilitata, è possibile completare la configurazione della modalità cluster e impostare la modalità cluster su abilitata.*

Per Linux, macOS o Unix:

Imposta la modalità cluster su *compatibile*.

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --cache-parameter-group-name myParameterGroupName \
   --cluster-mode compatible
```

Imposta la modalità cluster su *abilitata*.

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --cluster-mode enabled
```

Per Windows:

Imposta la modalità cluster su *compatibile*.

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --cache-parameter-group-name myParameterGroupName ^
   --cluster-mode compatible
```

Imposta la modalità cluster su *abilitata*.

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --cluster-mode enabled
```

Per ulteriori informazioni sul AWS CLI `modify-replication-group` comando, consulta [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) la sezione [Modifica della modalità cluster]() nella Guida *ElastiCache per l'utente di Redis OSS*.

## Utilizzo dell'API ElastiCache
<a name="Replication.Modify.API"></a>

La seguente operazione ElastiCache API abilita Multi-AZ su un gruppo di replica Valkey o Redis OSS esistente. Puoi utilizzare la stessa operazione per apportare altre modifiche a un gruppo di replica.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &AutomaticFailoverEnabled=true  
   &Mutli-AZEnabled=true  
   &ReplicationGroupId=myReplGroup
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &Version=2014-12-01
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>
```

Per ulteriori informazioni sul funzionamento dell' ElastiCache API`ModifyReplicationGroup`, vedere. [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)

# Eliminazione di un gruppo di replica
<a name="Replication.DeletingRepGroup"></a>

Se non hai più bisogno dei cluster con repliche (chiamati *gruppi di replica* nell'API/CLI), puoi eliminarli. Quando si elimina un gruppo di replica, ElastiCache vengono eliminati tutti i nodi di quel gruppo.

Dopo che è stata avviata, questa operazione non può essere interrotta o annullata.

**avvertimento**  
Quando si elimina un cluster ElastiCache For Redis OSS, le istantanee manuali vengono conservate. Hai anche la possibilità di creare uno snapshot finale prima che il cluster venga eliminato. Gli snapshot di cache automatici non vengono conservati.
`CreateSnapshot`è necessaria l'autorizzazione per creare un'istantanea finale. Senza questa autorizzazione, la chiamata API avrà esito negativo con un'`Access Denied`eccezione.

## Eliminazione di un gruppo di replica (console)
<a name="Replication.DeletingRepGroup.CON"></a>

Per eliminare un cluster che dispone di repliche, consulta [Eliminazione di un cluster in ElastiCache](Clusters.Delete.md).

## Eliminazione di un gruppo di replica (AWS CLI)
<a name="Replication.DeletingRepGroup.CLI"></a>

Utilizza il comando [delete-replication-group](https://docs.aws.amazon.com/AmazonElastiCache/latest/CommandLineReference/CLIReference-cmd-DeleteReplicationGroup.html) per eliminare un gruppo di replica.

```
aws elasticache delete-replication-group --replication-group-id my-repgroup 
```

Ti viene chiesto di confermare la tua decisione. Immetti *y* (sì) per avviare l'operazione immediatamente. Una volta avviato, il processo è irreversibile.

```
						
   After you begin deleting this replication group, all of its nodes will be deleted as well.
   Are you sure you want to delete this replication group? [Ny]y

REPLICATIONGROUP  my-repgroup  My replication group  deleting
```

## Eliminazione di un gruppo di replica (API) ElastiCache
<a name="Replication.DeletingRepGroup.API"></a>

Chiama [DeleteReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DeleteReplicationGroup.html) con il parametro `ReplicationGroup`. 

**Example**  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DeleteReplicationGroup
   &ReplicationGroupId=my-repgroup
   &Version=2014-12-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>
```

**Nota**  
Se imposti il parametro `RetainPrimaryCluster` su `true`, tutte le repliche di lettura verranno eliminate, ma il cluster primario verrà mantenuto.

# Modifica del numero di repliche
<a name="increase-decrease-replica-count"></a>

È possibile aumentare o diminuire dinamicamente il numero di repliche di lettura nel gruppo di replica Valkey o Redis OSS utilizzando l'API Console di gestione AWS, the AWS CLI o. ElastiCache Se il gruppo di replica è un gruppo di replica Valkey o Redis OSS (abilitato alla modalità cluster), è possibile scegliere quali shard (gruppi di nodi) aumentare o diminuire il numero di repliche.

Per modificare dinamicamente il numero di repliche nel gruppo di replica, scegliete l'operazione dalla tabella seguente che si adatta alla vostra situazione.


| Per | Per Valkey o Redis OSS (modalità cluster abilitata) | Per Valkey o Redis OSS (modalità cluster disabilitata) | 
| --- | --- | --- | 
|  Aggiungere repliche  |  [Incremento del numero di repliche in uno shard](increase-replica-count.md)  |  [Incremento del numero di repliche in uno shard](increase-replica-count.md) [Aggiungere una replica di lettura per Valkey o Redis OSS (modalità cluster disabilitata)](Replication.AddReadReplica.md)  | 
|  Eliminare repliche  |  [Riduzione del numero di repliche in uno shard](decrease-replica-count.md)  |  [Riduzione del numero di repliche in uno shard](decrease-replica-count.md) [Eliminazione di una replica di lettura per Valkey o Redis OSS (modalità cluster disabilitata)](Replication.RemoveReadReplica.md)  | 

# Incremento del numero di repliche in uno shard
<a name="increase-replica-count"></a>

È possibile aumentare il numero di repliche in uno shard Valkey o Redis OSS (modalità cluster abilitata) o in un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) fino a un massimo di cinque. È possibile farlo utilizzando l', il Console di gestione AWS o l'API. AWS CLI ElastiCache 

**Topics**
+ [Usando il Console di gestione AWS](#increase-replica-count-con)
+ [Utilizzando il AWS CLI](#increase-replica-count-cli)
+ [Utilizzo dell'API ElastiCache](#increase-replica-count-api)

## Usando il Console di gestione AWS
<a name="increase-replica-count-con"></a>

La procedura seguente utilizza la console per aumentare il numero di repliche in un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata).

**Per aumentare il numero di repliche negli shard**

1. Accedi a Console di gestione AWS e apri la ElastiCache console all'indirizzo. [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/)

1. Nel riquadro di navigazione, scegli **Valkey** o **Redis OSS**, quindi scegli il nome del gruppo di replica a cui desideri aggiungere le repliche.

1. Scegliere la casella per ogni shard cui si desidera aggiungere repliche.

1. Scegliere **Add replicas (Aggiungi repliche)**.

1. Completare la pagina **Add Replicas to Shards (Aggiungi repliche agli shard)**:
   + Per **New number of replicas/shard (Nuovo numero di repliche/shard)**, immettere il numero di repliche che devono avere tutti gli shard selezionati. Questo valore deve essere maggiore o uguale di **Current Number of Replicas per shard (Numero attuale di repliche per shard)** e minore o uguale a cinque. Si consiglia come minimo due repliche.
   + Per **Zone di disponibilità**, scegli **Nessuna preferenza** per aver ElastiCache scelto una zona di disponibilità per ogni nuova replica oppure **Specificare zone di disponibilità per scegliere una zona di disponibilità** per ogni nuova replica.

     Se si sceglie **Specify Availability Zones (Specifica zone di disponibilità)**, per ogni nuova replica specificare una zona di disponibilità utilizzando l'elenco.

1. Scegliere **Add (Aggiungi)** per aggiungere le repliche o **Cancel (Annulla)** per annullare l'operazione.

## Utilizzando il AWS CLI
<a name="increase-replica-count-cli"></a>

Per aumentare il numero di repliche in uno shard Valkey o Redis OSS, utilizzate il `increase-replica-count` comando con i seguenti parametri:
+ `--replication-group-id` - Obbligatorio Identifica il gruppo di replica in cui incrementare il numero di repliche.
+ `--apply-immediately` o `--no-apply-immediately` - Obbligatorio. Specifica se aumentare il conteggio di repliche immediatamente (`--apply-immediately`) o alla successiva finestra di manutenzione (`--no-apply-immediately`). Attualmente, `--no-apply-immediately` non è supportato.
+ `--new-replica-count` : Opzionale. Specifica il numero di nodi di replica desiderati, fino a un massimo di cinque. Utilizzate questo parametro per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) in cui è presente un solo gruppo di nodi o gruppo Valkey o Redis OSS (modalità cluster abilitata) o dove desiderate che tutti i gruppi di nodi abbiano lo stesso numero di repliche. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.
+ `--replica-configuration` : Opzionale. Consente di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Valkey o Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente. 

  `--replica-configuration` dispone di tre membri opzionali:
  + `NodeGroupId` - L'ID di quattro cifre del gruppo di nodi che stai configurando. Per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata), l'ID dello shard è sempre. `0001` Per trovare l'ID di un gruppo di nodi (shard) Valkey o Redis OSS (modalità cluster abilitata), vedi. [Ricerca dell'ID di uno shard](Shards.md#shard-find-id)
  + `NewReplicaCount` - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere maggiore del numero corrente di repliche, fino a un massimo di cinque. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.
  + `PreferredAvailabilityZones` - Un elenco di stringhe `PreferredAvailabilityZone` che specifica in quali zone di disponibilità si devono trovare i nodi del gruppo di replica. Il numero di valori `PreferredAvailabilityZone` deve essere uguale al valore di `NewReplicaCount` più 1 per tenere conto del nodo primario. Se questo membro di `--replica-configuration` viene omesso, ElastiCache per Redis OSS sceglie la zona di disponibilità per ciascuna delle nuove repliche.

**Importante**  
Nella chiamata è necessario includere il parametro `--new-replica-count` o `--replica-configuration`, ma non entrambi.

**Example**  
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene incrementato a tre. Al termine dell'esempio, ogni gruppo di nodi contiene tre repliche. Questo numero si applica sia che si tratti di un gruppo Valkey o Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Valkey o Redis OSS (modalità cluster abilitata) con più gruppi di nodi.  
Per Linux, macOS o Unix:  

```
aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --new-replica-count 3 \
    --apply-immediately
```
Per Windows:  

```
aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 3 ^
    --apply-immediately
```
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene incrementato al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Durante la specifica del `PreferredAvailabilityZones` opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di `NewReplicaCount` più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da `NodeGroupId`.  
Per Linux, macOS o Unix:  

```
aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b \
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately
```
Per Windows:  

```
aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately
```

Per ulteriori informazioni sull'aumento del numero di repliche utilizzando la CLI, [increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html)consulta * ElastiCache Amazon Command* Line Reference.

## Utilizzo dell'API ElastiCache
<a name="increase-replica-count-api"></a>

Per aumentare il numero di repliche in uno shard Valkey o Redis OSS, utilizzate l'`IncreaseReplicaCount`azione con i seguenti parametri:
+ `ReplicationGroupId` - Obbligatorio Identifica il gruppo di replica in cui incrementare il numero di repliche.
+ `ApplyImmediately` – Obbligatorio Specifica se aumentare il conteggio di repliche immediatamente (`ApplyImmediately=True`) o alla successiva finestra di manutenzione (`ApplyImmediately=False`). Attualmente, `ApplyImmediately=False` non è supportato.
+ `NewReplicaCount` : Opzionale. Specifica il numero di nodi di replica desiderati, fino a un massimo di cinque. Utilizzate questo parametro per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata) in cui è presente un solo gruppo di nodi o per i gruppi Valkey o Redis OSS (modalità cluster abilitata) in cui desiderate che tutti i gruppi di nodi abbiano lo stesso numero di repliche. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.
+ `ReplicaConfiguration` : Opzionale. Consente di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Valkey o Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente. 

  `ReplicaConfiguraion` dispone di tre membri opzionali:
  + `NodeGroupId` - L'ID di quattro cifre del gruppo di nodi che si sta configurando. Per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata), l'ID del gruppo di nodi (shard) è sempre. `0001` Per trovare l'ID di un gruppo di nodi (shard) Valkey o Redis OSS (modalità cluster abilitata), vedi. [Ricerca dell'ID di uno shard](Shards.md#shard-find-id)
  + `NewReplicaCount` - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere maggiore del numero corrente di repliche e non superiore a cinque. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.
  + `PreferredAvailabilityZones` - Un elenco di stringhe `PreferredAvailabilityZone` che specifica in quali zone di disponibilità si devono trovare i nodi del gruppo di replica. Il numero di valori `PreferredAvailabilityZone` deve essere uguale al valore di `NewReplicaCount` più 1 per tenere conto del nodo primario. Se questo membro di `ReplicaConfiguration` viene omesso, ElastiCache per Redis OSS sceglie la zona di disponibilità per ciascuna delle nuove repliche.

**Importante**  
Nella chiamata è necessario includere il parametro `NewReplicaCount` o `ReplicaConfiguration`, ma non entrambi.

**Example**  
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene incrementato a tre. Al termine dell'esempio, ogni gruppo di nodi contiene tre repliche. Questo numero si applica sia che si tratti di un gruppo Valkey o Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Valkey o Redis OSS (modalità cluster abilitata) con più gruppi di nodi.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=3
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene incrementato al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Durante la specifica del `PreferredAvailabilityZones` opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di `NewReplicaCount` più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da `NodeGroupId`.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Per ulteriori informazioni sull'aumento del numero di repliche utilizzando l'API, consulta [IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html)*Amazon ElastiCache API Reference*.

# Riduzione del numero di repliche in uno shard
<a name="decrease-replica-count"></a>

È possibile ridurre il numero di repliche in uno shard per Valkey o Redis OSS (modalità cluster abilitata) o in un gruppo di replica per Valkey o Redis OSS (modalità cluster disabilitata):
+ Per Valkey o Redis OSS (modalità cluster disabilitata), è possibile ridurre il numero di repliche a una se Multi-AZ è abilitato e a zero se non è abilitato.
+ Per Valkey o Redis OSS (modalità cluster abilitata), è possibile ridurre il numero di repliche a zero. Tuttavia, non puoi eseguire il failover in una replica se il nodo primario non riesce.

È possibile utilizzare Console di gestione AWS, the AWS CLI o l' ElastiCache API per ridurre il numero di repliche in un gruppo di nodi (shard) o in un gruppo di replica.

**Topics**
+ [Utilizzando il Console di gestione AWS](#decrease-replica-count-con)
+ [Utilizzando il AWS CLI](#decrease-replica-count-cli)
+ [Utilizzo dell'API ElastiCache](#decrease-replica-count-api)

## Utilizzando il Console di gestione AWS
<a name="decrease-replica-count-con"></a>

La procedura seguente utilizza la console per ridurre il numero di repliche in un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata).

**Per ridurre il numero di repliche in uno shard Valkey o Redis OSS**

1. Accedi a Console di gestione AWS e apri la console all'indirizzo. ElastiCache [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/)

1. Nel pannello di navigazione, scegli **Valkey** o **Redis OSS**, quindi scegli il nome del gruppo di replica da cui desideri eliminare le repliche.

1. Scegliere la casella per ogni shard da cui si desidera rimuovere un nodo di replica.

1. Scegliere **Delete replicas (Elimina repliche)**.

1. Completare la pagina **Delete Replicas from Shards (Elimina repliche dagli shard)**:

   1. Per **New number of replicas/shard (Nuovo numero di repliche/shard)**, immettere il numero di repliche specificato per gli shard selezionati. Questo numero deve essere maggiore o uguale a 1. Si consiglia almeno due repliche per shard.

   1. Scegliere **Delete (Elimina)** per eliminare le repliche o **Cancel (Annulla)** per annullare l'operazione.

**Importante**  
Se non specificate i nodi di replica da eliminare, ElastiCache per Redis OSS vengono selezionati automaticamente i nodi di replica da eliminare. Nel farlo, ElastiCache For Redis OSS tenta di mantenere l'architettura Multi-AZ per il gruppo di replica, seguita da conservare le repliche con un ritardo di replica minimo con il primario.
Non è possibile eliminare il primario o nodi primari in un gruppo di replica. Se si specifica un nodo primario per l'eliminazione, l'operazione non riesce e viene restituito un errore che indica che il nodo primario è stato selezionato per l'eliminazione. 

## Utilizzando il AWS CLI
<a name="decrease-replica-count-cli"></a>

Per ridurre il numero di repliche in uno shard Valkey o Redis OSS, utilizzate il `decrease-replica-count` comando con i seguenti parametri:
+ `--replication-group-id` - Obbligatorio Identifica il gruppo di replica in cui ridurre il numero di repliche.
+ `--apply-immediately` o `--no-apply-immediately` : Obbligatorio. Specifica se ridurre il conteggio di repliche immediatamente (`--apply-immediately`) o alla successiva finestra di manutenzione (`--no-apply-immediately`). Attualmente, `--no-apply-immediately` non è supportato.
+ `--new-replica-count` : Opzionale. Specifica il numero di nodi di replica desiderato. Il valore di `--new-replica-count` deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta [Riduzione del numero di repliche in uno shard](#decrease-replica-count). Se il valore di `--new-replica-count` non soddisfa questo requisiti, la chiamata non riesce.
+ `--replicas-to-remove` : Opzionale. Contiene un elenco di nodi che IDs specifica i nodi di replica da rimuovere.
+ `--replica-configuration` : Opzionale. Consente di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Valkey o Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente. 

  `--replica-configuration` dispone di tre membri opzionali:
  + `NodeGroupId` - L'ID di quattro cifre del gruppo di nodi che stai configurando. Per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata), l'ID dello shard è sempre. `0001` Per trovare l'ID di un gruppo di nodi (shard) Valkey o Redis OSS (modalità cluster abilitata), vedi. [Ricerca dell'ID di uno shard](Shards.md#shard-find-id)
  + `NewReplicaCount` - Un parametro facoltativo che specifica il numero di nodi di replica desiderati. Il valore di `NewReplicaCount` deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta [Riduzione del numero di repliche in uno shard](#decrease-replica-count). Se il valore di `NewReplicaCount` non soddisfa questo requisiti, la chiamata non riesce.
  + `PreferredAvailabilityZones` - Un elenco di stringhe `PreferredAvailabilityZone` che specifica in quali zone di disponibilità si trovano i nodi del gruppo di replica. Il numero di valori `PreferredAvailabilityZone` deve essere uguale al valore di `NewReplicaCount` più 1 per tenere conto del nodo primario. Se questo membro di `--replica-configuration` viene omesso, ElastiCache per Redis OSS sceglie la zona di disponibilità per ciascuna delle nuove repliche.

**Importante**  
Devi includere solo uno dei parametri `--new-replica-count`, `--replicas-to-remove` o `--replica-configuration`.

**Example**  
L'esempio seguente utilizza `--new-replica-count` per ridurre a uno il numero di repliche nel gruppo di replica `sample-repl-group`. Al termine dell'esempio, ogni gruppo di nodi contiene una sola replica. Questo numero si applica sia che si tratti di un gruppo Valkey o Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Valkey o Redis OSS (modalità cluster abilitata) con più gruppi di nodi.  
Per Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count
    --replication-group-id sample-repl-group \
    --new-replica-count 1 \
    --apply-immediately
```
Per Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately
```
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene ridotto rimuovendo due repliche specificate (`0001` e `0003`) dal gruppo di nodi.  
Per Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replicas-to-remove 0001,0003 \
    --apply-immediately
```
Per Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replicas-to-remove 0001,0003 \
    --apply-immediately
```
L'esempio seguente utilizza `--replica-configuration` per ridurre il numero di repliche nel gruppo di replica `sample-repl-group` al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Durante la specifica del `PreferredAvailabilityZones` opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di `NewReplicaCount` più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da `NodeGroupId`.  
Per Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=1,PreferredAvailabilityZones=us-east-1a,us-east-1c \
        NodeGroupId=0003,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately
```
Per Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately
```

Per ulteriori informazioni sulla riduzione del numero di repliche utilizzando la CLI, consulta *Amazon ElastiCache * Command Line [decrease-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html)Reference.

## Utilizzo dell'API ElastiCache
<a name="decrease-replica-count-api"></a>

Per ridurre il numero di repliche in uno shard Valkey o Redis OSS, utilizzate l'`DecreaseReplicaCount`azione con i seguenti parametri:
+ `ReplicationGroupId` - Obbligatorio Identifica il gruppo di replica in cui ridurre il numero di repliche.
+ `ApplyImmediately` - Obbligatorio Specifica se ridurre il conteggio di repliche immediatamente (`ApplyImmediately=True`) o alla successiva finestra di manutenzione (`ApplyImmediately=False`). Attualmente, `ApplyImmediately=False` non è supportato.
+ `NewReplicaCount` : Opzionale. Specifica il numero di nodi di replica desiderato. Il valore di `NewReplicaCount` deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta [Riduzione del numero di repliche in uno shard](#decrease-replica-count). Se il valore di `--new-replica-count` non soddisfa questo requisiti, la chiamata non riesce.
+ `ReplicasToRemove` : Opzionale. Contiene un elenco di nodi che IDs specifica i nodi di replica da rimuovere.
+ `ReplicaConfiguration` : Opzionale. Contiene un elenco di gruppi di nodi che consentono di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Valkey o Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente. 

  `ReplicaConfiguraion` dispone di tre membri opzionali:
  + `NodeGroupId` - L'ID di quattro cifre del gruppo di nodi che si sta configurando. Per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata), l'ID del gruppo di nodi è sempre. `0001` Per trovare l'ID di un gruppo di nodi (shard) Valkey o Redis OSS (modalità cluster abilitata), vedi. [Ricerca dell'ID di uno shard](Shards.md#shard-find-id)
  + `NewReplicaCount` - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere inferiore al numero di repliche correnti fino a un minimo di 1 se la funzione Multi-AZ è abilitata o 0 se non è abilitata failover automatico. Se questo valore non è minore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.
  + `PreferredAvailabilityZones` - Un elenco di stringhe `PreferredAvailabilityZone` che specifica in quali zone di disponibilità si trovano i nodi del gruppo di replica. Il numero di valori `PreferredAvailabilityZone` deve essere uguale al valore di `NewReplicaCount` più 1 per tenere conto del nodo primario. Se questo membro di `ReplicaConfiguration` viene omesso, ElastiCache per Redis OSS sceglie la zona di disponibilità per ciascuna delle nuove repliche.

**Importante**  
Devi includere solo uno dei parametri `NewReplicaCount`, `ReplicasToRemove` o `ReplicaConfiguration`.

**Example**  
L'esempio seguente utilizza `NewReplicaCount` per ridurre a uno il numero di repliche nel gruppo di replica `sample-repl-group`. Al termine dell'esempio, ogni gruppo di nodi contiene una sola replica. Questo numero si applica sia che si tratti di un gruppo Valkey o Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Valkey o Redis OSS (modalità cluster abilitata) con più gruppi di nodi.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=1
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
Nell'esempio seguente il numero di repliche nel gruppo di replica `sample-repl-group` viene ridotto rimuovendo due repliche specificate (`0001` e `0003`) dal gruppo di nodi.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicasToRemove.ReplicaToRemove.1=0001
      &ReplicasToRemove.ReplicaToRemove.2=0003
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
L'esempio seguente utilizza `ReplicaConfiguration` per ridurre il numero di repliche nel gruppo di replica `sample-repl-group` al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata). Durante la specifica del `PreferredAvailabilityZones` opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di `NewReplicaCount` più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da `NodeGroupId`.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Per ulteriori informazioni sulla riduzione del numero di repliche utilizzando l'API, consulta [DecreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html)*Amazon ElastiCache API* Reference.

# Aggiungere una replica di lettura per Valkey o Redis OSS (modalità cluster disabilitata)
<a name="Replication.AddReadReplica"></a>

Le informazioni riportate nel seguente argomento si applicano solo ai gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata).

All'aumentare del traffico di lettura, potrebbe essere necessario distribuire tali letture tra più nodi e ridurre la pressione di lettura su qualsiasi nodo. In questo argomento, puoi scoprire come aggiungere una replica di lettura a un cluster Valkey o Redis OSS (modalità cluster disabilitata). 

Un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) può avere un massimo di cinque repliche di lettura. Se tenti di aggiungere una replica di lettura a un gruppo di replica che dispone già di cinque repliche di lettura, l'operazione non riesce.

Per informazioni sull'aggiunta di repliche a un gruppo di replica Valkey o Redis OSS (modalità cluster abilitata), consulta quanto segue:
+ [Scalabilità dei cluster Valkey o Redis OSS (Cluster Mode Enabled)](scaling-redis-cluster-mode-enabled.md)
+ [Incremento del numero di repliche in uno shard](increase-replica-count.md)

È possibile aggiungere una replica di lettura a un cluster Valkey o Redis OSS (modalità cluster disabilitata) utilizzando la ElastiCache console, l'o l'API. AWS CLI ElastiCache 

**Argomenti correlati**
+ [Aggiungere nodi a un ElastiCache cluster](Clusters.AddNode.md)
+ [Aggiunta di una replica di lettura a un gruppo di replica (AWS CLI)](#Replication.AddReadReplica.CLI)
+ [Aggiunta di una replica di lettura a un gruppo di replica utilizzando l'API](#Replication.AddReadReplica.API)

## Aggiunta di una replica di lettura a un gruppo di replica (AWS CLI)
<a name="Replication.AddReadReplica.CLI"></a>

Per aggiungere una replica di lettura a un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata), utilizzate il AWS CLI `create-cache-cluster` comando, con il parametro `--replication-group-id` per specificare a quale gruppo di replica aggiungere il cluster (nodo).

L'esempio seguente consente di creare il cluster `my-read replica` e di aggiungerlo al gruppo di replica `my-replication-group`. I tipi di nodi, i gruppi di parametri, i gruppi di sicurezza, la finestra di manutenzione e altre impostazioni per la replica di lettura sono identiche a quelle di altri nodi in `my-replication-group`. 

Per Linux, macOS o Unix:

```
aws elasticache create-cache-cluster \
      --cache-cluster-id my-read-replica \
      --replication-group-id my-replication-group
```

Per Windows:

```
aws elasticache create-cache-cluster ^
      --cache-cluster-id my-read-replica ^
      --replication-group-id my-replication-group
```

Per ulteriori informazioni sull'aggiunta di una replica di lettura utilizzando la CLI, [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html) consulta * ElastiCache Amazon Command* Line Reference.

## Aggiunta di una replica di lettura a un gruppo di replica utilizzando l'API
<a name="Replication.AddReadReplica.API"></a>

Per aggiungere una replica di lettura a un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata), utilizza l' ElastiCache `CreateCacheCluster`operazione, con il parametro `ReplicationGroupId` per specificare a quale gruppo di replica aggiungere il cluster (nodo).

L'esempio seguente consente di creare il cluster `myReadReplica` e di aggiungerlo al gruppo di replica `myReplicationGroup`. I tipi di nodi, i gruppi di parametri, i gruppi di sicurezza, la finestra di manutenzione e altre impostazioni per la replica di lettura sono identiche a quelle di altri nodi `myReplicationGroup`.

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=CreateCacheCluster
      &CacheClusterId=myReadReplica
      &ReplicationGroupId=myReplicationGroup
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Per ulteriori informazioni sull'aggiunta di una replica di lettura utilizzando l'API, consulta [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) *Amazon ElastiCache API Reference*.

# Eliminazione di una replica di lettura per Valkey o Redis OSS (modalità cluster disabilitata)
<a name="Replication.RemoveReadReplica"></a>

Le informazioni riportate nel seguente argomento si applicano solo ai gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata).

Man mano che il traffico di lettura sul gruppo di replica Valkey o Redis OSS cambia, potresti voler aggiungere o rimuovere le repliche di lettura. La rimozione di un nodo da un gruppo di replica equivale all'eliminazione di un cluster, sebbene esistano delle limitazioni:
+ Non puoi rimuovere il nodo primario da un gruppo di replica. Se desideri eliminare il nodo primario, esegui le seguenti operazioni:

  1. Promuovi una replica di lettura al nodo primario. Per ulteriori informazioni sulla promozione di una replica di lettura al nodo primario, consulta [Promozione di una replica di lettura a quella primaria, per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata)](Replication.PromoteReplica.md).

  1. Elimina il vecchio nodo primario. Per una limitazione su questo metodo, consulta il punto successivo.
+ Se l'opzione Multi-AZ è abilitata su un gruppo di replica, non puoi rimuovere l'ultima replica di lettura dal gruppo di replica. In questo caso, esegui queste operazioni:

  1. Modifica il gruppo di replica disabilitando la funzione Multi-AZ. Per ulteriori informazioni, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

  1. Elimina la replica di lettura.

È possibile rimuovere una replica di lettura da un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) utilizzando la ElastiCache console, il for o l'API. AWS CLI ElastiCache ElastiCache 

Per istruzioni sull'eliminazione di un cluster da un gruppo di replica Valkey o Redis OSS, vedere quanto segue:
+ [Utilizzando il Console di gestione AWS](Clusters.Delete.md#Clusters.Delete.CON)
+ [Utilizzo di AWS CLI per eliminare un ElastiCache cluster](Clusters.Delete.md#Clusters.Delete.CLI)
+ [Utilizzo dell' ElastiCache API](Clusters.Delete.md#Clusters.Delete.API)
+ [Scalabilità dei cluster Valkey o Redis OSS (Cluster Mode Enabled)](scaling-redis-cluster-mode-enabled.md)
+ [Riduzione del numero di repliche in uno shard](decrease-replica-count.md)

# Promozione di una replica di lettura a quella primaria, per i gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata)
<a name="Replication.PromoteReplica"></a>

Le informazioni riportate nel seguente argomento si applicano solo ai gruppi di replica Valkey o Redis OSS (modalità cluster disabilitata).

È possibile promuovere una replica di lettura Valkey o Redis OSS (modalità cluster disabilitata) a replica di lettura principale utilizzando l' Console di gestione AWS, l'o l'API. AWS CLI ElastiCache Non puoi promuovere una replica di lettura al primario mentre la funzione Multi-AZ con failover automatico è abilitata sul gruppo di replica . Per promuovere una replica Valkey o Redis OSS (modalità cluster disabilitata) a principale su un gruppo di replica abilitato Multi-AZ, procedi come segue:

1. Modifica il gruppo di replica per disabilitare Multi-AZ (questa operazione non richiede che tutti i cluster siano nella stessa zona di disponibilità). Per ulteriori informazioni, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

1. Promuovere la replica di lettura al nodo primario.

1. Modifica il gruppo di replica per abilitare nuovamente Multi-AZ.

Multi-AZ non è disponibile nei gruppi di replica che eseguono Redis OSS 2.6.13 o versioni precedenti.

## Usando il Console di gestione AWS
<a name="Replication.PromoteReplica.CON"></a>

La procedura seguente utilizza la console per promuovere un nodo di replica al nodo primario. 

**Per promuovere una replica di lettura al nodo primario (console)**

1. Accedi a Console di gestione AWS e apri la ElastiCache console all'indirizzo [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Se la replica che desideri promuovere è membro di un gruppo di replica Valkey o Redis OSS (modalità cluster disabilitata) in cui Multi-AZ è abilitato, modifica il gruppo di replica per disabilitare Multi-AZ prima di procedere. Per ulteriori informazioni, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

1. Scegliete **Valkey** o **Redis OSS**, quindi dall'elenco dei cluster, scegliete il gruppo di replica che desiderate modificare. Questo gruppo di replica deve eseguire il motore "Redis", non il motore "Clustered Redis"e deve avere due o più nodi.

1. Dall'elenco di nodi, scegliere il nodo di replica che si desidera promuovere al nodo primario, quindi per **Actions (Operazioni)**, scegliere **Promote (Promuovi)**.

1. Nella finestra di dialogo **Promote Read Replica (Promuovi replica di lettura)**, procedere come segue:

   1. Per **Apply Immediately (Applica immediatamente)**, scegliere **Yes (Sì)** per promuovere immediatamente la replica di lettura o **No** per promuoverla alla successiva finestra di manutenzione del cluster.

   1. Scegliere **Promote (Promuovi)** per promuovere la replica di lettura o **Cancel (Annulla)** per annullare l'operazione.

1. Se il cluster è stato abilitato per Multi-AZ prima di iniziare il processo di promozione, attendere finché lo stato del gruppo di replica è **available (disponibile)**, quindi modificare il cluster per abilitare nuovamente Multi-AZ. Per ulteriori informazioni, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

## Usando il AWS CLI
<a name="Replication.PromoteReplica.CLI"></a>

Non puoi promuovere una replica di lettura al nodo primario se il gruppo di replica è abilitato per Multi-AZ. In alcuni casi, la replica che desideri promuovere potrebbe essere membro di un gruppo di repliche in cui è abilitata la funzione Multi-AZ. In questi casi, prima di continuare è necessario modificare il gruppo di replica per disabilitare Multi-AZ. Questa operazione non richiede che tutti i cluster siano nella stessa zona di disponibilità. Per ulteriori informazioni sulla modifica di un gruppo di replica, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

Il AWS CLI comando seguente modifica il gruppo di replica`sample-repl-group`, rendendo la replica di lettura la principale `my-replica-1` del gruppo di replica.

Per Linux, macOS o Unix:

```
aws elasticache modify-replication-group \
   --replication-group-id sample-repl-group \
   --primary-cluster-id my-replica-1
```

Per Windows:

```
aws elasticache modify-replication-group ^
   --replication-group-id sample-repl-group ^
   --primary-cluster-id my-replica-1
```

Per ulteriori informazioni sulla modifica di un gruppo di replica, consulta [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) *Amazon ElastiCache Command Line* Reference.

## Utilizzo dell'API ElastiCache
<a name="Replication.PromoteReplica.API"></a>

Non puoi promuovere una replica di lettura al nodo primario se il gruppo di replica è abilitato per Multi-AZ. In alcuni casi, la replica che desideri promuovere potrebbe essere membro di un gruppo di repliche in cui è abilitata la funzione Multi-AZ. In questi casi, prima di continuare è necessario modificare il gruppo di replica per disabilitare Multi-AZ. Questa operazione non richiede che tutti i cluster siano nella stessa zona di disponibilità. Per ulteriori informazioni sulla modifica di un gruppo di replica, consulta [Modifica di un gruppo di replica](Replication.Modify.md).

La seguente azione ElastiCache API modifica il gruppo di replica`myReplGroup`, rendendo la replica di lettura la principale `myReplica-1` del gruppo di replica.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &ReplicationGroupId=myReplGroup
   &PrimaryClusterId=myReplica-1  
   &Version=2014-12-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>
```

Per ulteriori informazioni sulla modifica di un gruppo di replica, consulta [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) *Amazon ElastiCache API* Reference.