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à. # Apportare modifiche alla configurazione in Amazon OpenSearch Service Amazon OpenSearch Service utilizza un processo di distribuzione *blu/verde* per l'aggiornamento dei domini. Una blue/green distribuzione crea un ambiente inattivo per gli aggiornamenti del dominio che copia l'ambiente di produzione e indirizza gli utenti al nuovo ambiente una volta completati gli aggiornamenti. In una blue/green distribuzione, l'ambiente blu è l'ambiente di produzione corrente. L'ambiente verde è l'ambiente inattivo. I dati vengono migrati dall'ambiente blu all'ambiente verde. Quando il nuovo ambiente è pronto, OpenSearch Service passa da un ambiente all'altro per far sì che l'ambiente verde diventi il nuovo ambiente di produzione. Il passaggio avviene senza perdita di dati. Questa pratica riduce al minimo i tempi di inattività e mantiene l'ambiente originale nel caso in cui l'implementazione nel nuovo ambiente non abbia esito positivo. **Topics** + [Modifiche che di solito causano implementazioni blue/green](#bg) + [Modifiche che di solito non causano blue/green distribuzioni](#nobg) + [Opzioni di implementazione blu/verdi](#bg-deployment-options) + [Determinare se una modifica provocherà una blue/green distribuzione](#dryrun) + [Monitoraggio di una modifica alla configurazione](#initiating-tracking-configuration-changes) + [Fasi di una modifica della configurazione](#managedomains-config-stages) + [Impatto delle implementazioni sulle prestazioni blue/green](#performance-impact-bluegreen) + [Costi per le modifiche di configurazione](#managedomains-config-charges) + [Risoluzione degli errori di convalida](#validation) ## Modifiche che di solito causano implementazioni blue/green Le seguenti operazioni causano blue/green le distribuzioni: + Modifica del tipo di istanza + Abilitazione del controllo granulare degli accessi + Esecuzione degli aggiornamenti software del servizio + Abilitazione o disabilitazione di nodi master dedicati + Abilitazione o disabilitazione di Multi-AZ senza Standby + Modifica del tipo di archiviazione, del tipo di volume o della dimensione del volume + Scelta di sottoreti VPC diverse + Aggiunta o rimozione di gruppi di sicurezza VPC + Aggiungere o rimuovere nodi coordinatori dedicati + Abilitazione o disabilitazione dell'autenticazione Amazon Cognito per dashboard OpenSearch + Scelta di un bacino d'utenza o pool di identità di Amazon Cognito differente + Modifica delle impostazioni avanzate + Aggiornamento a una nuova OpenSearch versione (le OpenSearch dashboard potrebbero non essere disponibili durante tutto o in parte l'aggiornamento) + Attivazione della crittografia dei dati archiviati o della crittografia node-to-node + Attivazione UltraWarm o disabilitazione della conservazione a freddo + Disabilitazione della regolazione automatica e rollback delle sue modifiche + Associazione di un plug-in opzionale a un dominio e dissociazione di un plug-in opzionale da un dominio + Aumento del numero di nodi master dedicati per i domini Multi-AZ con due nodi master dedicati + Riduzione della dimensione del volume EBS + Modifica delle dimensioni, degli IOPS o del throughput del volume EBS, se l'ultima modifica apportata è in corso o è avvenuta meno di 6 ore fa + Attivazione della pubblicazione dei registri di controllo su. CloudWatch Per i domini Multi-AZ con standby, è possibile effettuare solo una richiesta di modifica alla volta. Se è già in corso una modifica, la nuova richiesta viene rifiutata. Puoi controllare lo stato della modifica corrente con l'`DescribeDomainChangeProgress`API. ## Modifiche che di solito non causano blue/green distribuzioni Nella *maggior parte* dei casi, le seguenti operazioni non causano blue/green distribuzioni: + Modifica della politica di accesso + Modifica dell'endpoint personalizzato + Modifica della politica Transport Layer Security (TLS) + Modifica dell'orario di uno snapshot automatico + Abilitazione o disabilitazione di **Require HTTPS (Richiedi HTTPS)** + Abilitazione della regolazione automatica senza il rollback delle sue modifiche + Se il tuo dominio ha nodi master dedicati, modifica del nodo dati o del numero di UltraWarm nodi + Se il dominio dispone di nodi master dedicati, modifica del tipo o del numero di istanze master dedicate (ad eccezione dei domini Multi-AZ con due nodi master dedicati) + Abilitazione o disabilitazione della pubblicazione dei log degli errori o degli slow log su CloudWatch + Disattivazione della pubblicazione dei registri di controllo su CloudWatch + Aumento delle dimensioni del volume, degli IOPS o del throughput per il tipo gp3 EBS. **Nota** Prima del 10 marzo 2026, gli aumenti di volume in atto erano supportati solo per volumi fino a 3 TiB per gp3. Il 10 marzo 2026, questa limitazione è stata rimossa, consentendo aumenti di volume effettivi oltre i 3 TiB. Tuttavia, se il cluster aveva una dimensione del volume superiore a 3 TiB prima che questa limitazione venisse rimossa, il primo aumento di volume richiederà una blue/green deployment. All subsequent volume increases for that cluster will be performed as in-place updates and will not require a blue/green distribuzione. + Aggiunta e rimozione di tag **Nota** Esistono alcune eccezioni a seconda della versione del software di servizio. Se vuoi essere sicuro che una modifica non provochi una blue/green distribuzione, [esegui un'operazione a secco](#dryrun) prima di aggiornare il dominio, se questa opzione è disponibile. Alcune modifiche non offrono un'opzione di esecuzione a secco. In genere consigliamo di apportare modifiche al cluster al di fuori delle ore di traffico di punta. ## Opzioni di implementazione blu/verdi Seleziona una strategia di implementazione per controllare il modo in cui il cluster gestisce le distribuzioni quando non è disponibile una capacità sufficiente al momento dell'aggiornamento. 1. **Full Swap Blue/Green**: il comportamento di distribuzione predefinito. Richiede la piena capacità iniziale dell'istanza, garantendo l'implementazione più rapida quando la capacità è disponibile. L'installazione non procederà se non è possibile allocare una capacità sufficiente. 1. **Capacità ottimizzata**: consigliata per cluster con più di 30 nodi di dati. Tenta innanzitutto uno blue/green swap completo e, se la capacità è insufficiente, procede con la distribuzione in batch. Garantisce il completamento delle implementazioni anche quando la capacità è limitata. Il tempo di completamento può aumentare, poiché l'implementazione verrà eseguita in batch. ------ #### [ Console ] **Per Edit Domain Flow:** 1. Apri la console Amazon OpenSearch Service all'indirizzo[https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home). 1. Nel riquadro di navigazione, in **Domini**, scegli il nome di dominio per aprire la configurazione del cluster. 1. Fai clic sul pulsante **Modifica** a destra nella scheda **Configurazione del cluster**. 1. Dalle opzioni **della strategia di distribuzione** scegli le configurazioni richieste per l'aggiornamento del dominio: 1. **Full Swap Blue/Green**: il comportamento di distribuzione predefinito. Richiede la piena capacità iniziale dell'istanza, garantendo l'implementazione più rapida quando la capacità è disponibile. L'installazione non procederà se non è possibile allocare una capacità sufficiente. 1. **Capacità ottimizzata**: consigliata per cluster con più di 30 nodi di dati. Tenta innanzitutto uno blue/green swap completo e, se la capacità è insufficiente, procede con la distribuzione in batch. Garantisce il completamento delle implementazioni anche quando la capacità è limitata. Il tempo di completamento può aumentare, poiché l'implementazione verrà eseguita in batch. 1. Scegli **Save changes** (Salva modifiche). **Per Create Domain Flow:** 1. Apri la console Amazon OpenSearch Service all'indirizzo[https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home). 1. Nel riquadro di navigazione a sinistra, scegli **Domains** (Domini). 1. Fai clic sul pulsante **Crea dominio**. 1. Seleziona tutte le configurazioni richieste per il dominio. 1. Dalle opzioni **della strategia di distribuzione** scegli le configurazioni richieste per l'aggiornamento del dominio: 1. **Full Swap Blue/Green**: il comportamento di distribuzione predefinito. Richiede la piena capacità iniziale dell'istanza, garantendo l'implementazione più rapida quando la capacità è disponibile. L'installazione non procederà se non è possibile allocare una capacità sufficiente. 1. **Capacità ottimizzata**: consigliata per cluster con più di 30 nodi di dati. Tenta innanzitutto uno blue/green swap completo e, se la capacità è insufficiente, procede con la distribuzione in batch. Garantisce il completamento delle implementazioni anche quando la capacità è limitata. Il tempo di completamento può aumentare, poiché l'implementazione verrà eseguita in batch. 1. Fai clic sul pulsante **Crea** nel pannello di **riepilogo del dominio** sul lato destro. ------ #### [ API ] È possibile configurare la strategia di implementazione utilizzando l'[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)API. **Opzione ottimizzata per la capacità** ``` POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "DeploymentStrategyOptions": { "DeploymentStrategy": "CapacityOptimized" } } ``` **Opzione predefinita** ``` POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "DeploymentStrategyOptions": { "DeploymentStrategy": "Default" } } ``` ------ ## Determinare se una modifica provocherà una blue/green distribuzione È possibile testare alcuni tipi di modifiche alla configurazione pianificate per determinare se causeranno una blue/green distribuzione, senza doversi impegnare ad apportare tali modifiche. Prima di avviare una modifica della configurazione, utilizza la console o un'API per eseguire un controllo di convalida per garantire che il dominio sia idoneo per un aggiornamento. ------ #### [ Console ] **Per convalidare una modifica alla configurazione** 1. Accedi alla console di Amazon OpenSearch Service all'indirizzo[https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Nel riquadro di navigazione a sinistra, scegli **Domains** (Domini). 1. Seleziona il dominio per cui desideri avviare una modifica della configurazione. Si apre la pagina dei dettagli del dominio. Seleziona il menu a discesa **Actions** (Operazioni), quindi scegli **Edit cluster configuration** (Modifica configurazione cluster). 1. Apporta modifiche al dominio, ad esempio cambiando il tipo di istanza o il numero di nodi. 1. In **Dry run analysis**, scegli **Esegui**. Il dry run convalida la modifica della configurazione alla ricerca di errori e determina se è necessaria un' blue/green implementazione. 1. Al termine del dry run, i risultati vengono visualizzati nella parte inferiore della pagina, insieme a un ID dry run. L'analisi indica se la modifica della configurazione richiede o meno una blue/green distribuzione. Ogni ciclo a secco sovrascrive quello precedente. Per conservare i dettagli di ogni corsa, salvate il relativo ID di funzionamento a secco. Le esecuzioni a secco sono disponibili per 90 giorni o fino a quando non si effettua un aggiornamento della configurazione. 1. Per procedere con l'aggiornamento della configurazione, scegli **Save changes** (Salva modifiche). Altrimenti, scegli **Cancel** (Annulla). Entrambe le opzioni riportano alla scheda **Cluster configuration** (Configurazione del cluster). In questa scheda, puoi scegliere **Dry run details** (Dettagli del test) per visualizzare i dettagli del tuo ultimo test. Questa pagina include anche un side-by-side confronto tra la configurazione prima del funzionamento a secco e la configurazione del funzionamento a secco. ------ #### [ API ] È possibile eseguire la convalida del test di analisi anche tramite l'API di configurazione. Per testare le modifiche con l'API, imposta `DryRun` su `true` e `DryRunMode` su `Verbose`. La modalità verbosa esegue un controllo di convalida oltre a determinare se la modifica avvierà una implementazione blu/verde. Ad esempio, questa [UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)richiesta verifica il tipo di distribuzione risultante dall'attivazione di UltraWarm: ``` POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "ClusterConfig": { "WarmCount": 3, "WarmEnabled": true, "WarmType": "ultrawarm1.large.search" }, "DryRun": true, "DryRunMode": "Verbose" } ``` La richiesta esegue un controllo di convalida e restituisce il tipo di implementazione che sarà causata dalla modifica ma non esegue effettivamente l'aggiornamento: ``` { "ClusterConfig": { ... }, "DryRunResults": { "DeploymentType": "Blue/Green", "Message": "This change will require a blue/green deployment." } } ``` I possibili tipi di implementazione sono: + `Blue/Green`: la modifica causerà una implementazione blu/verde. + `DynamicUpdate`: la modifica non causerà una implementazione blu/verde. + `Undetermined`: il dominio è ancora in stato di elaborazione, quindi non è possibile determinare il tipo di implementazione. + `None`: nessuna modifica alla configurazione. Se la convalida non riesce, viene restituito un elenco di [errori di convalida](#validation). ``` { "ClusterConfig":{ "..." }, "DryRunProgressStatus":{ "CreationDate":"2023-01-12T01:14:33.847Z", "DryRunId":"db00ca39-48b2-4774-bbd3-252cf094d205", "DryRunStatus":"failed", "UpdateDate":"2023-01-12T01:14:33.847Z", "ValidationFailures":[ { "Code":"Cluster.Index.WriteBlock", "Message":"Cluster has index write blocks." } ] } } ``` Se lo stato è fisso`pending`, puoi utilizzare l'ID dry run nella UpdateDomainConfig risposta alle [DescribeDryRunProgress](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_DescribeDryRunProgress.html)chiamate successive per verificare lo stato della convalida. ``` GET https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/dryRun?dryRunId=my-dry-run-id { "DryRunConfig": null, "DryRunProgressStatus": { "CreationDate": "2023-01-12T01:14:42.998Z", "DryRunId": "db00ca39-48b2-4774-bbd3-252cf094d205", "DryRunStatus": "succeeded", "UpdateDate": "2023-01-12T01:14:49.334Z", "ValidationFailures": null }, "DryRunResults": { "DeploymentType": "Blue/Green", "Message": "This change will require a blue/green deployment." } } ``` Per eseguire un test senza un controllo di convalida, imposta `DryRunMode` su `Basic` quando usi l'API di configurazione. ------ #### [ Python ] Il seguente codice Python utilizza l'[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html)API per eseguire un controllo di convalida dell'esecuzione a secco e, se il controllo ha esito positivo, chiama la stessa API senza esecuzione a secco per avviare l'aggiornamento. Se il controllo fallisce, lo script stampa l'errore e si interrompe. ``` import time import boto3 client = boto3.client('opensearch') response = client.UpdateDomainConfig( ClusterConfig={ 'WarmCount': 3, 'WarmEnabled': True, 'WarmCount': 123, }, DomainName='test-domain', DryRun=True, DryRunMode='Verbose' ) dry_run_id = response.DryRunProgressStatus.DryRunId retry_count = 0 while True: if retry_count == 5: print('An error occured') break dry_run_progress_response = client.DescribeDryRunProgress('test-domain', dry_run_id) dry_run_status = dry_run_progress_response.DryRunProgressStatus.DryRunStatus if dry_run_status == 'succeeded': client.UpdateDomainConfig( ClusterConfig={ 'WarmCount': 3, 'WarmEnabled': True, 'WarmCount': 123, }) break elif dry_run_status == 'failed': validation_failures_list = dry_run_progress_response.DryRunProgressStatus.ValidationFailures for item in validation_failures_list: print(f"Code: {item['Code']}, Message: {item['Message']}") break retry_count += 1 time.sleep(30) ``` ------ ## Monitoraggio di una modifica alla configurazione È possibile richiedere una modifica alla configurazione alla volta o raggruppare più modifiche in un'unica richiesta. Utilizza i campi **Stato di elaborazione del dominio** e **Stato di modifica della configurazione** nella console per tenere traccia delle modifiche alla configurazione. Attendi che lo stato del dominio diventi `Active` tale prima di richiedere ulteriori modifiche. Un dominio può avere i seguenti **stati di elaborazione**: + `Active`— Non è in corso alcuna modifica alla configurazione. È possibile inviare una nuova richiesta di modifica della configurazione. + `Creating`— Il dominio è in fase di creazione. + `Modifying`— Sono in corso modifiche alla configurazione, come l'aggiunta di nuovi nodi di dati, EBS, gp3, il provisioning IOPS o la configurazione di chiavi KMS. + `Upgrading engine version`— È in corso un aggiornamento della versione del motore. + `Updating service software`— È in corso un aggiornamento del software di servizio. + `Deleting`— Il dominio viene eliminato. + `Isolated`— Il dominio è sospeso. Un dominio può avere i seguenti **stati di modifica della configurazione**: + `Pending`— È stata inviata una richiesta di modifica della configurazione. + `Initializing`— Il servizio sta inizializzando una modifica alla configurazione. + `Validating`— Il servizio sta convalidando le modifiche richieste e le risorse richieste. + `Awaiting user inputs`— Il servizio prevede che le modifiche alla configurazione, ad esempio la modifica del tipo di istanza, continuino. È possibile modificare le modifiche alla configurazione. + `Applying changes`— Il servizio sta applicando le modifiche di configurazione richieste. + `Cancelled`— La modifica della configurazione viene annullata. Scegli **Annulla** e ripristina tutte le modifiche. + `Completed`— Le modifiche alla configurazione richieste sono state completate con successo. + `Validation failed`— Le modifiche alla configurazione richieste non sono state completate. Non è stata applicata alcuna modifica alla configurazione. **Nota** Gli errori di convalida possono essere il risultato di indici rossi presenti nel dominio, dell'indisponibilità di un tipo di istanza scelto o di uno spazio su disco insufficiente. Per un elenco degli errori di convalida, consulta. [Risoluzione degli errori di convalida](#validation) Durante un evento di errore di convalida, è possibile annullare, riprovare o modificare le modifiche alla configurazione. Una volta completate le modifiche alla configurazione, lo stato del dominio torna a. `Active` Puoi esaminare lo stato del cluster e i CloudWatch parametri di Amazon e vedere che il numero di nodi nel cluster aumenta temporaneamente, spesso raddoppiando, durante l'aggiornamento del dominio. L'illustrazione seguente mostra il numero di nodi che raddoppia da 11 a 22 durante una modifica di configurazione e torna a 11 al termine dell'aggiornamento. ![\[Raddoppio del numero di nodi da 11 a 22 durante una modifica delle configurazioni del dominio.\]](http://docs.aws.amazon.com/it_it/opensearch-service/latest/developerguide/images/NodesDoubled.png) Questo aumento temporaneo può gravare sui [nodi master dedicati](managedomains-dedicatedmasternodes.md) del cluster, che improvvisamente devono gestire molti più nodi. Può anche aumentare le latenze di ricerca e indicizzazione poiché OpenSearch Service copia i dati dal vecchio cluster a quello nuovo. È importante mantenere una capacità sufficiente sul cluster per gestire il sovraccarico associato a queste implementazioni. blue/green **Importante** Le modifiche di configurazione e manutenzione del servizio *non* comportano costi aggiuntivi. Ti viene fatturato solo il numero di nodi richiesti per il cluster. Per le specifiche, consulta [Costi per le modifiche di configurazione](#managedomains-config-charges). Per evitare il sovraccarico dei nodi master dedicati, puoi [monitorare l'utilizzo con i parametri di Amazon CloudWatch](managedomains-cloudwatchmetrics.md). Per scoprire i valori massimi consigliati, consulta [CloudWatch Allarmi consigliati per Amazon Service OpenSearch](cloudwatch-alarms.md). ## Fasi di una modifica della configurazione Dopo aver avviato una modifica alla configurazione, OpenSearch Service esegue una serie di passaggi per aggiornare il dominio. È possibile visualizzare lo stato di avanzamento della modifica della configurazione in **Stato di modifica della configurazione** nella console. I passaggi esatti eseguiti da un aggiornamento dipendono dal tipo di modifica che stai apportando. È inoltre possibile monitorare una modifica di configurazione utilizzando l’operazione API [DescribeDomainChangeProgress](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_DescribeDomainChangeProgress.html). Di seguito sono riportate le fasi possibili che un aggiornamento può passare durante una modifica della configurazione: | Nome fase | Description | | --- | --- | | Convalida | Convalida che il dominio è idoneo per un aggiornamento e fa emergere [problemi di convalida](#validation) se necessario. | | Creazione di un nuovo ambiente | Completamento dei prerequisiti necessari e creazione delle risorse necessarie per avviare la blue/green distribuzione. | | Provisioning di nuovi nodi | Creazione di una nuova istanza database nell'ambiente di anteprima. | | Routing del traffico su nuovi nodi | Reindirizzamento del traffico ai nodi dati appena creati. | | Routing del traffico sui vecchi nodi | Disabilitazione del traffico sui vecchi nodi dati. | | Preparazione dei nodi per la rimozione | Preparazione alla rimozione dei nodi. Questo passaggio si verifica solo quando si esegue il downscaling del dominio (ad esempio, da 8 nodi a 6 nodi). | | Copia di partizioni su nuovi nodi | Spostamento di partizioni dai vecchi nodi ai nuovi nodi. | | Terminazione dei nodi | Terminare ed eliminare i vecchi nodi dopo la rimozione delle partizioni. | | Eliminazione delle risorse meno recenti | Eliminazione di risorse associate al vecchio ambiente (ad esempio il load balancer). | | Aggiornamento dinamico | Viene visualizzato quando l'aggiornamento non richiede una blue/green distribuzione e può essere applicato dinamicamente. | | Applicazione di modifiche dedicate relative al master | Visualizzato quando si modifica il tipo o il conteggio dell'istanza principale dedicata. | | Applicazione delle modifiche relative al volume | Viene visualizzato quando le dimensioni, il tipo, gli IOPS e la velocità effettiva del volume vengono modificati. | ## Impatto delle implementazioni sulle prestazioni blue/green Durante la blue/green distribuzione, il tuo cluster Amazon OpenSearch Service è disponibile per le richieste di ricerca e indicizzazione in entrata. Tuttavia, potresti riscontrare i seguenti problemi di prestazioni: + Aumento temporaneo dell'utilizzo sui nodi leader poiché i cluster hanno più nodi da gestire. + Maggiore latenza di ricerca e indicizzazione poiché il OpenSearch servizio copia i dati dai vecchi nodi ai nuovi nodi. + Aumento dei rifiuti per le richieste in entrata a causa dell'aumento del carico del cluster durante le implementazioni. blue/green + Per evitare problemi di latenza e il rifiuto delle richieste, è necessario eseguire le blue/green distribuzioni quando il cluster è integro e il traffico di rete è ridotto. ## Costi per le modifiche di configurazione Se si modifica la configurazione di un dominio, OpenSearch Service crea un nuovo cluster come descritto in. [Apportare modifiche alla configurazione in Amazon OpenSearch Service](#managedomains-configuration-changes) Durante la migrazione dal vecchio al nuovo, saranno calcolate le spese seguenti: + Se si modifica il tipo di istanza, saranno addebitate le spese sia per i cluster che per la prima ora. Dopo la prima ora, l'addebito è relativo solo al nuovo cluster. I volumi EBS non vengono addebitati due volte perché fanno parte del cluster, quindi la loro fatturazione segue la fatturazione delle istanze. **Esempio:** la configurazione viene modificata passando da tre istanze `m3.xlarge` a quattro istanze `m4.large`. Per la prima ora, ti viene addebitato il costo per entrambi i cluster (3 \$1 `m3.xlarge` \$1 4 \$1 `m4.large`). Dopo la prima ora, ti viene addebitato solo il nuovo cluster (4 \$1 `m4.large`). + Se non modifichi il tipo di istanza, ti saranno addebitate solo le spese per il cluster più grande per la prima ora. Dopo la prima ora, l'addebito è relativo solo al nuovo cluster. **Esempio:** la configurazione viene modificata passando da sei istanze `m3.xlarge` a tre istanze `m3.xlarge`. Per la prima ora, ti viene addebitato il cluster più grande (6 \$1 `m3.xlarge`). Dopo la prima ora, ti viene addebitato solo il nuovo cluster (3 \$1 `m3.xlarge`). ## Risoluzione degli errori di convalida Quando avvii una modifica alla configurazione o esegui un OpenSearch aggiornamento della versione di Elasticsearch, OpenSearch Service esegue innanzitutto una serie di controlli di convalida per garantire che il tuo dominio sia idoneo per un aggiornamento. Se uno di questi controlli non riesce, si riceve una notifica nella console contenente i problemi specifici che è necessario correggere prima di aggiornare il dominio. OpenSearch Il servizio isola il dominio se rimane inutilizzabile per più di 60 giorni. Ti invieremo promemoria di notifica per risolvere questi problemi. Se non risolvi i problemi entro questo lasso di tempo, il OpenSearch Servizio elimina il tuo dominio e i relativi dati. La tabella seguente elenca i possibili problemi di dominio che il OpenSearch Servizio potrebbe riscontrare e i passaggi per risolverli. | Problema | Codice di errore | Fasi per la risoluzione dei problemi | | --- | --- | --- | | Gruppo di sicurezza non trovato | SecurityGroupNotFound | Il gruppo di sicurezza associato al dominio di OpenSearch servizio non esiste. Per risolvere questo problema, [crea un gruppo di sicurezza](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#creating-security-groups) con il nome specificato. | | Sottorete non trovata | SubnetNotFound | La sottorete associata al dominio OpenSearch di servizio non esiste. Per risolvere questo problema, [crea una sottorete](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-subnets.html#create-subnets) nel VPC. | | Ruolo collegato al servizio non configurato | SLRNotConfigured | Il [ruolo collegato al servizio](slr.md) per OpenSearch Service non è configurato. Il ruolo collegato al servizio è predefinito da OpenSearch Service e include tutte le autorizzazioni richieste dal servizio per chiamare altri servizi per conto dell'utente. AWS Se il ruolo non esiste, potresti aver bisogno della [Creazione manuale](slr-aos.md#create-slr). | | Indirizzi IP insufficienti | InsufficientFreeIPsForSubnets | Una o più sottoreti VPC non dispongono di indirizzi IP sufficienti per aggiornare il dominio. Per calcolare quanti indirizzi IP sono necessari, vedere [Prenotazione di indirizzi IP in una sottorete VPC](vpc.md#reserving-ip-vpc-endpoints). | | Il pool di utenti di Cognito non esiste | CognitoUserPoolNotFound | OpenSearch Il servizio non riesce a trovare il pool di utenti di Amazon Cognito. Conferma di averne creato uno e di avere l'ID corretto. Per trovare l'ID, è possibile usare la console Amazon Cognito o il seguente comando della AWS CLI : 
aws cognito-idp list-user-pools --max-results 60 --region us-east-1
| | Il pool di identità di Cognito non esiste | CognitoIdentityPoolNotFound | OpenSearch Il servizio non riesce a trovare il pool di identità di Cognito. Conferma di averne creato uno e di avere l'ID corretto. Per trovare l'ID, è possibile usare la console Amazon Cognito o il seguente comando della AWS CLI : 
aws cognito-identity list-identity-pools --max-results 60 --region us-east-1
| | Dominio di Cognito non trovato per il pool di utenti | CognitoDomainNotFound | Il pool di utenti non ha un nome di dominio. Puoi configurarne uno utilizzando la console Amazon Cognito o il seguente AWS CLI comando: 
aws cognito-idp create-user-pool-domain --domain my-domain --user-pool-id id
| | Ruolo Cognito non configurato | CognitoRoleNotConfigured | Il ruolo IAM che concede l'autorizzazione al OpenSearch Servizio per configurare i pool di utenti e identità di Amazon Cognito e utilizzarli per l'autenticazione, non è configurato. Configura il ruolo con un set di autorizzazioni e una relazione di trust appropriati. Puoi utilizzare la console, che crea il [CognitoAccessForAmazonOpenSearch](cognito-auth.md#cognito-auth-role)ruolo predefinito per te, oppure puoi configurare manualmente un ruolo utilizzando l'SDK AWS CLI o l' AWS SDK. | | Impossibile descrivere il pool di utenti | UserPoolNotDescribable | Il ruolo Amazon Cognito specificato non dispone dell'autorizzazione per descrivere il pool di utenti associato al tuo dominio. Assicurarsi che la policy delle autorizzazioni dei ruoli consenta l'operazione cognito-identity:DescribeUserPool. Consulta [Informazioni sul ruolo CognitoAccessForAmazonOpenSearch](cognito-auth.md#cognito-auth-role) per la policy completa delle autorizzazioni. | | Impossibile descrivere il pool di identità | IdentityPoolNotDescribable | Il ruolo Amazon Cognito specificato non dispone dell'autorizzazione per descrivere il pool di identità associato al tuo dominio. Assicurarsi che la policy delle autorizzazioni dei ruoli consenta l'operazione cognito-identity:DescribeIdentityPool. Consulta [Informazioni sul ruolo CognitoAccessForAmazonOpenSearch](cognito-auth.md#cognito-auth-role) per la policy completa delle autorizzazioni. | | Impossibile descrivere il pool utente e il pool di identità | CognitoPoolsNotDescribable | Il ruolo Amazon Cognito specificato non dispone dell'autorizzazione per descrivere i pool di identità e utente associati al tuo dominio. Assicurarsi che la policy delle autorizzazioni dei ruoli consenta le operazioni cognito-identity:DescribeIdentityPool e cognito-identity:DescribeUserPool. Consulta [Informazioni sul ruolo CognitoAccessForAmazonOpenSearch](cognito-auth.md#cognito-auth-role) per la policy completa delle autorizzazioni. | | Chiave KMS non è abilitata | KMSKeyNotEnabled | La chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare il dominio è disabilitata. [Riattiva la chiave](https://docs.aws.amazon.com/kms/latest/developerguide/enabling-keys) immediatamente. | | Certificato personalizzato non in stato EMESSO | InvalidCertificate | Se il tuo dominio utilizza un endpoint personalizzato, lo proteggi generando un certificato SSL in AWS Certificate Manager (ACM) o importandone uno tuo. Lo stato del certificato deve essere **Emesso**. Se viene visualizzato questo errore, [verificare lo stato del certificato](https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-describe.html) nella console ACM. Se lo stato è Scaduto, Non riuscito, Inattivo o In attesa di convalida, consulta ka [documentazione per la risoluzione dei problemi](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting.html) di ACM per risolvere il problema. | | Capacità insufficiente per avviare il tipo di istanza scelto | InsufficientInstanceCapacity | La capacità del tipo di istanza richiesta non è disponibile. Ad esempio, potresti aver richiesto cinque `i3.16xlarge.search` nodi, ma OpenSearch Service non dispone di abbastanza `i3.16xlarge.search` host disponibili, quindi la richiesta non può essere soddisfatta. Controlla i [tipi di istanza supportati](supported-instance-types.md) in OpenSearch Service e scegli un tipo di istanza diverso. | | Indici rossi nel cluster | RedCluster | Uno o più indici del cluster hanno uno stato rosso, che porta a uno stato generale del cluster rosso. Per risolvere il problema e risolvere questo problema, vedere [Cluster in stato rosso](handling-errors.md#handling-errors-red-cluster-status). | | Interruttore automatico di memoria, troppe richieste | TooManyRequests | Ci sono troppe richieste di ricerca e scrittura sul tuo dominio, quindi OpenSearch Service non può aggiornarne la configurazione. Puoi ridurre il numero di richieste, scalare le istanze verticalmente fino a 64 GiB di RAM o scalare orizzontalmente aggiungendo le istanze. | | La nuova configurazione non può contenere dati (spazio su disco insufficiente) | InsufficientStorageCapacity | Le dimensioni di archiviazione configurate non possono contenere tutti i dati del tuo dominio. Per risolvere questo problema, [scegli un volume più grande](limits.md#ebsresource), [elimina gli indici inutilizzati](https://opensearch.org/docs/latest/opensearch/rest-api/index-apis/delete-index/) o aumenta il numero di nodi nel cluster per liberare immediatamente spazio su disco. | | Partizioni fissate a nodi specifici | ShardMovementBlocked | Uno o più indici nel tuo dominio sono collegati a nodi specifici e non possono essere riassegnati. Ciò è probabilmente accaduto perché è stato configurato il filtro di allocazione delle partizioni, che consente di specificare quali nodi sono autorizzati a ospitare le partizioni di un determinato indice. Per risolvere questo problema, rimuovere i filtri di allocazione delle partizioni da tutti gli indici interessati: 
PUT my-index/_settings
{  
  "settings": {    
    "index.routing.allocation.require._name": null  
  }
}
| | La nuova configurazione non può contenere tutte le partizioni (numero di partizioni) | TooManyShards | Il numero di shard sul tuo dominio è troppo alto, il che impedisce a OpenSearch Service di spostarli nella nuova configurazione. Per risolvere questo problema, ridimensiona il tuo dominio orizzontalmente aggiungendo nodi dello stesso tipo di configurazione dei nodi del cluster corrente. Nota che la [dimensione massima dei volumi EBS](limits.md#ebsresource) dipende dal tipo di istanza del nodo.Per evitare questo problema in futuro, vedere [Scelta del numero di partizioni](bp-sharding.md) e definire una strategia di partizione appropriata per il tuo caso d'uso. | | La sottorete associata al tuo dominio non supporta gli indirizzi IPv4 | `ResultCodeIPv4BlockNotExists` | Per risolvere questo problema, [crea una sottorete o aggiorna la sottorete esistente](https://docs.aws.amazon.com//vpc/latest/userguide/configure-subnets.html#subnet-IP-address-range) nel tuo VPC in base al tipo di indirizzo IP configurato del dominio. Se il dominio utilizza un **IPv4solo** tipo di indirizzo, utilizza una IPv4 sottorete -only. Se il tuo dominio utilizza la **modalità Dual-stack, utilizza una sottorete dual-stack**. | | La sottorete associata al tuo dominio non supporta gli indirizzi IPv6 | `ResultCodeIPv6BlockNotExists` | Per risolvere questo problema, [crea una sottorete o aggiorna la sottorete esistente](https://docs.aws.amazon.com//vpc/latest/userguide/configure-subnets.html#subnet-IP-address-range) nel tuo VPC in base al tipo di indirizzo IP configurato del dominio. Se il dominio utilizza un **IPv4solo** tipo di indirizzo, utilizza una IPv4 sottorete -only. Se il tuo dominio utilizza la **modalità Dual-stack, utilizza una sottorete dual-stack**. |