Risoluzione dei codici di errore dell'API Amazon Bedrock

Questa sezione fornisce informazioni dettagliate sugli errori comuni che potresti riscontrare durante l'utilizzo di Amazon Bedrock APIs, la causa dell'errore e la soluzione per risolverlo.

AccessDeniedException

Codice di stato HTTP: 400

Causa: non disponi di autorizzazioni sufficienti per eseguire l'azione richiesta

Soluzione::

• Verifica che il tuo utente o ruolo IAM disponga delle autorizzazioni necessarie per l'azione che stai tentando

• Se utilizzi credenziali di sicurezza temporanee, assicurati che non siano scadute

IncompleteSignature

Codice di stato HTTP: 400

Causa: la firma della richiesta non è conforme agli standard AWS

Soluzione::

• Assicurati di utilizzare una versione AWS SDK che supporti Amazon Bedrock

• Verifica che l'ID della chiave di AWS accesso e la chiave segreta siano configurati correttamente

• Se stai firmando manualmente le richieste, ti suggeriamo di ricontrollare il processo di calcolo della firma

InternalFailure

Codice di stato HTTP: 500

Causa: l'elaborazione della richiesta non è riuscita a causa di un errore del server

Soluzione::

• Suggeriamo di utilizzare l'approccio AWS consigliato di utilizzare nuovi tentativi con backoff esponenziale e jitter casuale per una maggiore affidabilità.

• Se il problema persiste, contatta il AWS Support Center e fornisci i dettagli sulla tua richiesta e sull'errore riscontrato.

InvalidAction

Codice di stato HTTP: 400

Causa: l'azione o l'operazione richiesta non è valida

Soluzione::

• Ti consigliamo di ricontrollare l'ortografia e la formattazione del nome dell'azione nella richiesta

• Verifica che l'action call sia supportata da Amazon Bedrock e sia documentata correttamente, come mostrato in Amazon Bedrock API Reference

• Assicurati di utilizzare la maggior parte delle up-to-date versioni dell' AWS SDK o della CLI

InvalidClientTokenId

Codice di stato HTTP: 403

Causa: il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi

Soluzione::

• Verifica di utilizzare l'ID della chiave di AWS accesso corretto

• Se di recente hai creato nuove chiavi di accesso, assicurati di utilizzare le nuove credenziali e non quelle vecchie

NotAuthorized

Codice di stato HTTP: 400

Causa: non sei autorizzato a eseguire questa azione

Soluzione::

• Verifica le tue autorizzazioni IAM e assicurati di disporre dei diritti necessari per eseguire l'azione richiesta sulle risorse di Amazon Bedrock

• Se utilizzi un ruolo IAM, verifica che il ruolo disponga delle autorizzazioni e delle relazioni di fiducia appropriate

• Verifica eventuali politiche organizzative o politiche di controllo dei servizi che potrebbero limitare il tuo accesso

RequestExpired

Codice di stato HTTP: 400

Causa: la richiesta non è più valida a causa di timestamp scaduti

Soluzione::

• Assicurati che l'orologio di sistema sia sincronizzato correttamente con una fonte di orario affidabile

• Se stai effettuando richieste da fusi orari diversi, tieni presente le potenziali discrepanze nei timestamp

ServiceUnavailable

Codice di stato HTTP: 503

Causa: il servizio non è temporaneamente in grado di gestire la richiesta

Soluzione::

• Suggeriamo di utilizzare l'approccio AWS consigliato di utilizzare nuovi tentativi con backoff esponenziale e jitter casuale per una maggiore affidabilità

• Prendi in considerazione la possibilità di passare a un'altra regione AWS se il problema persiste nella tua regione attuale. Regioni diverse possono avere diversi livelli di carico e disponibilità

• Utilizza l'inferenza interregionale per gestire senza problemi i picchi di traffico non pianificati utilizzando l'elaborazione su diverse aree Regioni AWS

• Se hai requisiti di throughput elevati, ti suggeriamo di esplorare Provisioned Throughput per il tuo caso d'uso

Best practice

• Assicurati che l'applicazione sia in grado di gestire i codici di stato 503 in modo appropriato nella logica di gestione degli errori e dei tentativi

• Controlla il AWS Service Health Dashboard per eventuali problemi annunciati o manutenzione programmata che potrebbero influire sul servizio.

Se riscontri errori 503 frequenti o se influiscono in modo significativo sulle tue operazioni, contatta il AWS supporto per ulteriore assistenza e indicazioni personalizzate in base al tuo caso d'uso specifico

ThrottlingException

Codice di stato HTTP: 429

Causa: la richiesta è stata rifiutata a causa del superamento delle quote dell'account per Amazon Bedrock

Soluzione::

• Controlla le quote del servizio Amazon Bedrock nella console delle quote di servizio Amazon Bedrock per conoscere i limiti assegnati al tuo account.

• Ti suggeriamo di utilizzare l'approccio AWS consigliato di utilizzare nuovi tentativi con backoff esponenziale e jitter casuale per una maggiore affidabilità

• Se hai requisiti di throughput elevati, ti suggeriamo di esplorare Provisioned Throughput per il tuo caso d'uso

• Richiedi un aumento della quota contattando il tuo account manager o l'AWS assistenza se il traffico del carico di lavoro supera le quote del tuo account

ValidationError

Codice di stato HTTP: 400

Causa: l'input non soddisfa i vincoli specificati da Amazon Bedrock.

Soluzione::

• Consulta la documentazione dell'API per assicurarti che tutti i parametri richiesti siano inclusi e formattati correttamente

• Verifica che i valori di input rientrino negli intervalli consentiti o siano conformi ai modelli previsti

• Ti suggeriamo di prestare attenzione a eventuali regole di convalida specifiche menzionate nel riferimento all'API per l'azione che stai utilizzando

ResourceNotFound

Codice di stato HTTP: 404

Causa: la risorsa richiesta non è stata trovata

Soluzione::

• Verifica la correttezza dell'ID del modello, del nome dell'endpoint o di altri identificatori di risorsa nella richiesta

• Implementa un meccanismo di fallback per utilizzare modelli o endpoint alternativi quando non viene trovata una risorsa principale

Best practice

• ListFoundationModelsUsalo per scoprire i modelli Amazon Bedrock Foundation disponibili che puoi utilizzare

• Ti suggeriamo di implementare un processo di sincronizzazione periodica per aggiornare il catalogo di risorse locali

Se continui a riscontrare problemi dopo aver provato queste soluzioni, contatta il AWS Supporto per ulteriore assistenza e indicazioni personalizzate in base al tuo caso d'uso specifico