Risoluzione dei codici di API errore di Amazon Bedrock

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

AccessDeniedException

HTTPCodice di stato: 400

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

Soluzione::

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

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

IncompleteSignature

HTTPCodice di stato: 400

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

Soluzione::

• Assicurati di utilizzare una AWS SDK versione 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

HTTPCodice di stato: 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

HTTPCodice di stato: 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 Reference. API

• Assicurati di utilizzare la up-to-date versione più recente di o AWS SDK CLI

InvalidClientTokenId

HTTPCodice di stato: 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

HTTPCodice di stato: 400

Causa: non sei autorizzato a eseguire questa azione

Soluzione::

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

• Se utilizzi un IAM ruolo, 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

HTTPCodice di stato: 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

HTTPCodice di stato: 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à

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

• 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 correttamente i codici di stato 503 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

HTTPCodice di stato: 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 Service AWS Quotas 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

HTTPCodice di stato: 400

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

Soluzione::

• APIConsulta la documentazione 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 tutte le regole di convalida specifiche menzionate nel API riferimento per l'azione che stai utilizzando

ResourceNotFound

HTTPCodice di stato: 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 consigliamo 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.