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à.
# Modifica del numero di repliche
È 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
È 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
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
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
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=
```
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=
```
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
È 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
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
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
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=
```
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=
```
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=
```
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)
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)
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
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=
```
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)
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)