Avviso di fine del supporto: il 13 novembre 2025, il supporto per Amazon Elastic Transcoder AWS verrà interrotto. Dopo il 13 novembre 2025, non potrai più accedere alla console Elastic Transcoder o alle risorse Elastic Transcoder.

Per ulteriori informazioni sulla transizione a, consulta questo post del blog AWS Elemental MediaConvert.

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

Gestione degli errori in Elastic Transcoder

Quando invii richieste e ricevi risposte dall'API Elastic Transcoder, potresti riscontrare due tipi di errori API:

Per ogni errore API, Elastic Transcoder restituisce i seguenti valori:

Per un elenco dei codici di errore restituiti da Elastic Transcoder per gli errori del client e del server, consultaCodici di errore API (Errori client e server).

Potrebbero inoltre verificarsi errori durante l'elaborazione del lavoro da parte di Elastic Transcoder. Per ulteriori informazioni, consulta Errori durante l'elaborazione del processo.

Codici di errore API (Errori client e server)

I codici di stato HTTP indicano se un'operazione è stata eseguita correttamente o no.

Il codice di risposta 200 indica che l'operazione è riuscita. Altri codici di errore indicano un errore del client (4xx) o un errore del server (5xx).

Nella tabella seguente sono elencati gli errori restituiti da Elastic Transcoder. Alcuni errori vengono risolti semplicemente ripetendo la stessa richiesta. Nella tabella sono indicati gli errori probabilmente risolvibili con ripetizioni successive. Se il valore della colonna Riprova è:

Per ulteriori informazioni sulla ripetizione delle richieste, consulta Ripetizione dei tentativi in caso di errore e backoff esponenziale.

Risposta di errore di esempio

Di seguito è riportata una risposta HTTP indicante che il valore di inputBucket era null, che non è un valore valido.

HTTP/1.1 400 Bad Request
x-amzn-RequestId: b0e91dc8-3807-11e2-83c6-5912bf8ad066
x-amzn-ErrorType: ValidationException
Content-Type: application/json
Content-Length: 124
Date: Mon, 26 Nov 2012 20:27:25 GMT

{"message":"1 validation error detected: Value null at 'inputBucket' failed to satisfy constraint: Member must not be null"}

Errori durante l'elaborazione del processo

Quando Elastic Transcoder rileva un errore durante l'elaborazione del lavoro, lo segnala in due modi:

Intercettazione di errori

Per il buon funzionamento dell'applicazione, devi integrare la logica che permette di intercettare gli errori e rispondere in modo adeguato. Un approccio tipico consiste nell'implementare la tua richiesta all'interno di un blocco try o di un'istruzione if-then.

Gli SDK AWS eseguono le proprie ripetizioni di tentativi e le proprie verifiche degli errori. Se rilevi un errore durante l'utilizzo di uno degli SDK AWS, dovresti visualizzare il codice e la descrizione dell'errore, nonché un valore Request ID. IlRequest ID valore può aiutare a risolvere i problemi con il supporto di Elastic Transcoder.

L'esempio seguente impiega il kit SDK AWS per Java per eliminare una voce all'interno di un blocco try e utilizza un blocco catch per rispondere all'errore. In questo caso, avvisa che la richiesta non è riuscita. L'esempio utilizza la classe AmazonServiceException per recuperare informazioni su eventuali errori operativi, incluso il Request ID. L'esempio utilizza inoltre la classe AmazonClientException nel caso in cui la richiesta non sia riuscita per altri motivi.

try {
   DeleteJobRequest request = new DeleteJobRequest(jobId);
   DeleteJobResult result = ET.deleteJob(request);
   System.out.println("Result: " + result);
   // Get error information from the service while trying to run the operation	
   }  catch (AmazonServiceException ase) {
      System.err.println("Failed to delete job " + jobId);
      // Get specific error information
      System.out.println("Error Message:    " + ase.getMessage());
      System.out.println("HTTP Status Code: " + ase.getStatusCode());
      System.out.println("AWS Error Code:   " + ase.getErrorCode());
      System.out.println("Error Type:       " + ase.getErrorType());
      System.out.println("Request ID:       " + ase.getRequestId());
   // Get information in case the operation is not successful for other reasons	
   }  catch (AmazonClientException ace) {
      System.out.println("Caught an AmazonClientException, which means"+
      " the client encountered " +
      "an internal error while trying to " +
      "communicate with Elastic Transcoder, " +
      "such as not being able to access the network.");
      System.out.println("Error Message: " + ace.getMessage());
   }

Ripetizione dei tentativi in caso di errore e backoff esponenziale

Numerosi componenti di una rete, ad esempio server DNS, switch, sistemi di bilanciamento del carico e altri, possono generare errori in qualsiasi fase del ciclo di vita di una richiesta specifica.

La tecnica che viene generalmente utilizzata per gestire queste risposte di errore in un ambiente di rete consiste nell'implementare nuovi tentativi nell'applicazione client. Questa tecnica aumenta l'affidabilità dell'applicazione e consente di ridurre i costi operativi per lo sviluppatore.

Ogni SDK AWS che supporta Elastic Transcoder implementa una logica di ripetizione automatica. Il kit SDK AWS per Java ripete automaticamente le richieste e le impostazioni relative alle ripetizioni sono configurabili tramite la classe ClientConfiguration. Ad esempio in alcune occasioni, come nel caso di una pagina Web che fa una richiesta con latenza minima e senza ulteriori tentativi, è possibile disattivare la logica di ripetizione. Usa la classe ClientConfiguration e specifica per maxErrorRetry il valore 0 per disattivare i tentativi.

Se non utilizzi un SDK AWS, dovresti riprovare le richieste originali che ricevono errori del server (5xx). Tuttavia, gli errori del client (4xx, tranne ThrottlingException o ProvisionedThroughputExceededException) indicano che è necessario modificare la richiesta per correggere il problema prima di riprovare.

Oltre a semplici tentativi, consigliamo di utilizzare un algoritmo di backoff esponenziale per migliorare il controllo del flusso. L'idea che sottende al backoff esponenziale è di utilizzare attese progressivamente più lunghe tra i tentativi per le risposte di errore consecutive. Ad esempio è possibile lasciar passare un secondo prima del primo nuovo tentativo, quattro secondi prima del secondo, 16 secondi prima del terzo e così via. Tuttavia, se la richiesta non è riuscita dopo un minuto, il problema potrebbe essere dovuto a un limite rigido e non alla frequenza della richiesta. Ad esempio potresti aver raggiunto il numero massimo di pipeline consentite. Imposta l'arresto del numero massimo di tentativi a circa un minuto.

Di seguito è riportato un flusso di lavoro che illustra una logica di ripetizione dei tentativi. Per prima cosa la logica del flusso di lavoro determina se si tratta di un errore del server (5xx). In caso affermativo, il codice ripete la richiesta originale.

currentRetry = 0
DO
  set retry to false

  execute Elastic Transcoder request

  IF Exception.errorCode = ProvisionedThroughputExceededException
    set retry to true
  ELSE IF Exception.httpStatusCode = 500
    set retry to true
  ELSE IF Exception.httpStatusCode = 400
    set retry to false 
    fix client error (4xx)

  IF retry = true  
    wait for (2^currentRetry * 50) milliseconds
    currentRetry = currentRetry + 1

WHILE (retry = true AND currentRetry < MaxNumberOfRetries)  // limit retries