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à.

# Risolvi gli errori dell'API Amazon SQS
<a name="troubleshooting-api-errors"></a>

I seguenti argomenti trattano gli errori più comuni restituiti durante le chiamate API di Amazon SQS e come risolverli.

## QueueDoesNotExist errore
<a name="queuedoesnotexist-error"></a>

Questo errore viene restituito quando il servizio Amazon SQS non riesce a trovare la coda menzionata per l'azione Amazon SQS.

**Possibili cause e mitigazioni:**
+ **Regione errata:** esamina la configurazione del client Amazon SQS per confermare di aver configurato la regione corretta sul client. Se non configuri una regione sul client, utilizza l'SDK o AWS CLI scegli la regione dal [file di configurazione o dalla variabile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) di ambiente. Se l'SDK non trova una regione nel file di configurazione, l'SDK imposta la regione su us-east-1 per impostazione predefinita. 
+ La **coda potrebbe essere stata eliminata di recente:** se la coda è stata eliminata prima di effettuare la chiamata API, la chiamata API restituirà questo errore. Verifica la presenza CloudTrail di eventuali [DeleteQueue](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteQueue.html)operazioni prima del momento in cui si è verificato l'errore.
+ **Problemi di autorizzazione:** se l'utente o il ruolo richiedente AWS Identity and Access Management (IAM) non dispone delle autorizzazioni richieste, potresti ricevere il seguente errore:

  ```
  The specified queue does not exist or you do not have access to it.
  ```

  Controlla le autorizzazioni ed effettua la chiamata API con le autorizzazioni corrette. 

Per ulteriori dettagli sulla risoluzione dell'`QueueDoesNotExist`errore, consulta [Come posso risolvere l' QueueDoesNotExist errore quando effettuo chiamate API alla mia coda Amazon SQS?](https://repost.aws/knowledge-center/sqs-queuedoesnotexist-errors) *nella Knowledge Center Guide.AWS *

## InvalidAttributeValue errore
<a name="invalidattributevalue-error"></a>

Questo errore verrà restituito dopo l'aggiornamento della policy delle risorse di coda di Amazon SQS o delle proprietà con una policy o un principal errati.

**Possibili cause e mitigazioni:**
+ **Politica sulle risorse non valida: verifica che la politica** delle risorse contenga tutti i campi obbligatori. Per ulteriori informazioni, consulta [IAM JSON Policy Elements Reference](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) e [Validating](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_policy-validator.html) IAM Policy. Puoi anche utilizzare il [generatore di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation.html) per creare e testare una policy di risorse Amazon SQS. Assicurati che la policy sia in formato JSON.
+ **Principal non valido:** assicurati che l'`Principal`elemento esista nella politica delle risorse e che il valore sia valido. Se l'`Principal`elemento della policy delle risorse di Amazon SQS include un'entità IAM, assicurati che l'entità esista prima di utilizzare la policy. Amazon SQS convalida la politica delle risorse e verifica l'entità IAM. Se l'entità IAM non esiste, riceverai un errore. Per confermare le entità IAM, usa [`GetRole`](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html)and [`GetUser`](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetUser.html) APIs.

Per ulteriori informazioni su come risolvere un `InvalidAttributeValue` errore, consulta [Come si risolve l' QueueDoesNotExist errore quando effettuo chiamate API alla mia coda Amazon SQS](https://repost.aws/knowledge-center/sqs-invalid-parameter-policy)? *nella Knowledge Center Guide.AWS *

## ReceiptHandle errore
<a name="receipthandle-error"></a>

Al momento di effettuare una chiamata [`DeleteMessage`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessage.html)API, l'errore `ReceiptHandleIsInvalid` o `InvalidParameterValue` potrebbe essere restituito se l'handle di ricezione non è corretto o è scaduto.
+ **ReceiptHandleIsInvalid errore:** Se la gestione delle ricevute non è corretta, riceverai un errore simile a questo esempio:

  ```
  An error occurred (ReceiptHandleIsInvalid) when calling the DeleteMessage operation: The input receipt handle <YOUR RECEIPT HANDLE> is not a valid receipt handle.
  ```
+ **InvalidParameterValue errore:** Se il codice di ricezione è scaduto, riceverai un errore simile a questo esempio:

  ```
  An error occurred (InvalidParameterValue) when calling the DeleteMessage operation: Value <YOUR RECEIPT HANDLE> for parameter ReceiptHandle is invalid. Reason: The receipt handle has expired.
  ```

**Possibili cause e mitigazioni:**

L'handle di ricezione viene creato per ogni messaggio ricevuto ed è valido solo per il periodo di timeout di visibilità. Quando il periodo di timeout di visibilità scade, il messaggio diventa visibile in coda per i consumatori. Quando ricevi nuovamente il messaggio dal consumatore, ricevi una nuova maniglia di ricezione. Per evitare errori di gestione delle ricevute errati o scaduti, utilizza il codice di ricezione corretto per eliminare il messaggio entro il periodo di timeout di visibilità della coda di Amazon SQS.

Per ulteriori informazioni su come risolvere un `ReceiptHandle` errore, consulta [Come si risolvono gli errori "" e "ReceiptHandleIsInvalid" quando utilizzo InvalidParameterValue la chiamata all'API Amazon SQS](https://repost.aws/knowledge-center/sqs-receipt-handle-error)? DeleteMessage *nella Knowledge Center Guide.AWS *