Come posso risolvere gli errori dell'API InvokeModel in Amazon Bedrock?

4 minuti di lettura

Desidero risolvere l'errore AccessDeniedException o ValidationException che ricevo quando chiamo l'API InvokeModel in Amazon Bedrock.

Risoluzione

Gli errori AccessDeniedException e ValidationException si verificano quando l'API InvokeModel non può accedere al modello base che sta invocando. Gli errori potrebbero verificarsi anche se l'account AWS non ha le autorizzazioni AWS Identity and Access Management (AWS IAM) richieste per eseguire l'operazione.

Errori di accesso al modello

Se non hai accesso al modello che l'API ha cercato di invocare, ricevi un messaggio di errore simile ai seguenti esempi:

"An error occurred (AccessDeniedException) when calling the InvokeModel operation: Your account is not authorized to invoke this API operation."

-oppure-

"An error occurred (AccessDeniedException) when calling the InvokeModel operation: You don't have access to the model with the specified model ID."

Per risolvere il problema, controlla le seguenti configurazioni:

Il modello è disponibile nella Regione AWS in cui invochi l'API.
Hai impostato Stato di accesso su Concesso.
Nota: configura Stato di accesso solo una volta per ogni Regione.

Errori relativi alle autorizzazioni IAM

Se l'utente o il ruolo IAM che ha invocato l'API non ha le autorizzazioni richieste, ricevi un messaggio di errore simile ai seguenti esempi:

"AccessDeniedException: An error occurred (AccessDeniedException) when calling the InvokeModel operation: User: username is not authorized to perform: bedrock:InvokeModel on resource: resourcename with an explicit deny in an identity-based policy."

-oppure-

"AccessDeniedException: An error occurred (AccessDeniedException) when calling the InvokeModel operation: User: username is not authorized to perform: bedrock:InvokeModel on resource: resourcename because no identity-based policy allows the bedrock:InvokeModel action."

Per risolvere il problema, verifica che l'utente o il ruolo IAM che invoca l'API abbia le seguenti autorizzazioni richieste:

{  "Version": "2012-10-17",
  "Statement": {
    "Sid": "AllowInference",
    "Effect": "Allow",
    "Action": [
      "bedrock:InvokeModel",
      "bedrock:InvokeModelWithResponseStream"
    ],
    "Resource": "arn:aws:bedrock:*::foundation-model/model-id"
  }
}

Errore SCP

Se una policy di controllo dei servizi (SCP) impone restrizioni specifiche al tuo account, ricevi il seguente messaggio di errore:

"User: username is not authorized to perform: bedrock:InvokeModel on resource: username with an explicit deny in a service control policy"

L'errore precedente si verifica anche se hai fornito le autorizzazioni richieste al ruolo IAM che ha invocato l'API. Generalmente questo errore si verifica quando utilizzi un'interferenza multi-Regione che indirizza la chiamata a una Regione bloccata dalla SCP.

Per risolvere il problema, verifica la chiamata API e la Regione a cui è indirizzata negli eventi di AWS CloudTrail . Quindi verifica se la SCP limita le azioni per quell'API o quella Regione. Inoltre, verifica la presenza di altre restrizioni della SCP, come ad esempio le restrizioni imposte all'ID di un modello specifico.

Errore di azione API

Se hai utilizzato un'azione API non corretta, ricevi il seguente messaggio di errore:

"ValidationException: An error occurred (ValidationException) when calling the InvokeModel operation: The requested operation is not recognized by the service."

Per risolvere l'errore precedente, specifica bedrock-runtime come servizio nella chiamata API. Per ulteriori informazioni, consulta BedrockRuntime sul sito web di Boto3.

Potresti anche ricevere il seguente messaggio di errore:

"An error occurred (ValidationException) when calling the InvokeModel operation: The provided model identifier is invalid"

-oppure-

"ResourceNotFoundException: An error occurred (ResourceNotFoundException) when calling the InvokeModel operation: Could not resolve the foundation model from the provided model identifier."

Gli errori precedenti si verificano a causa di problemi di configurazione. Per risolverli, verifica le seguenti configurazioni:

Hai impostato Stato di accesso su Concesso.
Nota: configura Stato di accesso solo una volta per ogni Regione.
Il modello è disponibile nella Regione in cui richiami l'API.
L'ID del modello è corretto.

Errore di versione SDK

Se utilizzi una versione non compatibile di AWS SDK per Python (Boto3) per chiamare l'API InvokeModel, ricevi il seguente messaggio di errore:

"UnknownServiceError: Unknown service: 'bedrock-runtime"

Per risolvere il problema, aggiorna l'SDK alla versione più recente. Per visualizzare l'ultima versione dell'SDK, consulta boto3/CHANGELOG.rst sul sito web di GitHub.