Codici di errore di Servizi multimediali di AzureAzure Media Services error codes

Quando si usa Servizi multimediali di Microsoft Azure, è possibile ricevere codici di errore HTTP dal servizio a seconda del problema, ad esempio scadenza dei token di autenticazione o azioni non supportate in Servizi multimediali.When using Microsoft Azure Media Services, you may receive HTTP error codes from the service depending on issues such as authentication tokens expiring to actions that are not supported in Media Services. Di seguito è riportato un elenco di codici di errore HTTP che possono essere restituiti da Servizi multimediali e le cause che li possono generare.The following is a list of HTTP error codes that may be returned by Media Services and the possible causes for them.

400 - Richiesta non valida400 Bad Request

La richiesta contiene informazioni non valide e viene rifiutata a causa di uno dei motivi seguenti:The request contains invalid information and is rejected due to one of the following reasons:

  • Viene specificata una versione API non supportata.An unsupported API version is specified. Per la versione più aggiornata, vedere Setup for Media Services REST API Development (Configurazione della distribuzione dell'API REST di Servizi multimediali).For the most current version, see Setup for Media Services REST API Development.
  • Non viene specificata la versione dell'API di Servizi multimediali.The API version of Media Services is not specified. Per informazioni su come specificare la versione dell'API, vedere Informazioni di riferimento sull'API REST di Servizi multimediali.For information on how to specify the API version, see Media Services Operations REST API Reference.

    Nota

    Se si usano gli SDK .NET o Java per connettersi a Servizi multimediali, la versione dell'API viene specificata automaticamente ogni volta che si tenta di eseguire un'azione su Servizi multimediali.If you are using the .NET or Java SDKs to connect to Media Services, the API version is specified for you whenever you try and perform some action against Media Services.

  • Viene specificata una proprietà non definita.An undefined property has been specified. Il nome della proprietà è nel messaggio di errore.The property name is in the error message. Solo le proprietà che fanno parte di una determinata entità possono essere specificate.Only those properties that are members of a given entity can be specified. Per un elenco delle entità e delle relative proprietà, vedere Azure Media Services REST API Reference (Informazioni di riferimento relative all'API REST di Servizi multimediali di Azure).See Azure Media Services REST API Reference for a list of entities and their properties.
  • Viene specificato un valore di proprietà non valido.An invalid property value has been specified. Il nome della proprietà è nel messaggio di errore.The property name is in the error message. Per i tipi di proprietà validi e i relativi valori, fare clic sul collegamento precedente.See the previous link for valid property types and their values.
  • Il valore di una proprietà risulta mancante ed è obbligatorio.A property value is missing and is required.
  • Parte dell'URL specificato contiene un valore non valido.Part of the URL specified contains a bad value.
  • È stato effettuato un tentativo di aggiornamento di una proprietà WriteOnce.An attempt was made to update a WriteOnce property.
  • È stato effettuato un tentativo di creazione di un'istanza di Job che dispone di un'istanza di Asset di input con un'istanza di AssetFile primaria che non è stata specificata o non può essere determinata.An attempt was made to create a Job that has an input Asset with a primary AssetFile that was not specified or could not be determined.
  • È stato effettuato un tentativo di aggiornamento di un localizzatore di firma di accesso condiviso.An attempt was made to update a SAS Locator. I localizzatori di firma di accesso condiviso possono solo essere creati o eliminati.SAS locators can only be created or deleted. I localizzatori di flusso possono essere aggiornati.Streaming locators can be updated. Per altre informazioni, vedere Locators (Localizzatori).For more information, see Locators.
  • È stata inviata un'operazione o una query non supportata.An unsupported operation or query was submitted.

401 - Non autorizzato401 Unauthorized

La richiesta non può essere autenticata (prima di poterla autorizzare) a causa di uno dei motivi seguenti:The request could not be authenticated (before it can be authorized) due to one of the following reasons:

  • L'intestazione di autenticazione risulta mancante.Missing authentication header.
  • Il valore dell'intestazione di autenticazione non è valido.Bad authentication header value.
    • Il token è scaduto.The token has expired.
    • Il token contiene una firma non valida.The token contains an invalid signature.

403 - Accesso negato403 Forbidden

La richiesta non è consentita per uno dei motivi seguenti:The request is not allowed due to one of the following reasons:

  • Non è possibile trovare l'account di Servizi multimediali o è stato eliminato.The Media Services account cannot be found or has been deleted.
  • L'account di Servizi multimediali è disattivato e il tipo di richiesta non è HTTP GET.The Media Services account is disabled and the request type is not HTTP GET. Le operazioni del servizio restituiranno una risposta 403.Service operations will return a 403 response as well.
  • Il token di autenticazione non contiene informazioni sulle credenziali dell'utente: nome account e/o ID sottoscrizione.The authentication token does not contain the user’s credential information: AccountName and/or SubscriptionId. È possibile trovare queste informazioni nell'estensione dell'interfaccia utente di Servizi multimediali per l'account di Servizi multimediali nel portale di gestione di Azure.You can find this information in the Media Services UI extension for your Media Services account in the Azure Management Portal.
  • Non è possibile accedere alla risorsa.The resource cannot be accessed.

    • È stato effettuato un tentativo di uso di un'istanza di MediaProcessor non disponibile per l'account di Servizi multimediali.An attempt was made to use a MediaProcessor that is not available for your Media Services account.
    • È stato effettuato un tentativo di aggiornamento di un'istanza di JobTemplate definita da Servizi multimediali.An attempt was made to update a JobTemplate defined by Media Services.
    • È stato effettuato un tentativo di sovrascrittura di altre istanze di Locator dell'account di Servizi multimediali.An attempt was made to overwrite some other Media Services account's Locator.
    • È stato effettuato un tentativo di sovrascrittura di altre istanze di ContentKey dell'account di Servizi multimediali.An attempt was made to overwrite some other Media Services account's ContentKey.
  • Non è stato possibile creare la risorsa a causa di una quota del servizio raggiunta per l'account di Servizi multimediali.The resource could not be created due to a service quota that was reached for the Media Services account. Per altre informazioni sulle quote del servizio, vedere Quote e limitazioni.For more information on the service quotas, see Quotas and Limitations.

404 - Non trovato404 Not Found

La richiesta non è consentita su una risorsa per uno dei motivi seguenti:The request is not allowed on a resource due to one of the following reasons:

  • È stato effettuato un tentativo di aggiornamento di un'entità che non esiste.An attempt was made to update an entity that does not exist.
  • È stato effettuato un tentativo di eliminazione di un'entità che non esiste.An attempt was made to delete an entity that does not exist.
  • È stato effettuato un tentativo di creazione di un'entità che si collega a un'entità che non esiste.An attempt was made to create an entity that links to an entity that does not exist.
  • È stato effettuato un tentativo di ottenere un'entità che non esiste.An attempt was made to GET an entity that does not exist.
  • È stato effettuato un tentativo di specificare un account di archiviazione non associato all'account di Servizi multimediali.An attempt was made to specify a storage account that is not associated with the Media Services account.

409 - Conflitto409 Conflict

La richiesta non è consentita per uno dei motivi seguenti:The request is not allowed due to one of the following reasons:

  • Una o più istanze di AssetFile hanno il nome specificato nell'istanza di Asset.More than one AssetFile has the specified name within the Asset.
  • È stato effettuato un tentativo di creazione di una seconda istanza primaria di AssetFile nell'istanza di Asset.An attempt was made to create a second primary AssetFile within the Asset.
  • È stato effettuato un tentativo di creazione di un'istanza di ContentKey con l'ID specificato già in uso.An attempt was made to create a ContentKey with the specified Id already used.
  • È stato effettuato un tentativo di creazione di un'istanza di Locator con l'ID specificato già in uso.An attempt was made to create a Locator with the specified Id already used.
  • Più istanze di IngestManifestFile hanno il nome specificato nell'istanza di IngestManifest.More than one IngestManifestFile has the specified name within the IngestManifest.
  • È stato effettuato un tentativo di collegamento di una seconda crittografia di archiviazione ContentKey all'istanza di Asset crittografata nell'archiviazione.An attempt was made to link a second storage encryption ContentKey to the storage-encrypted Asset.
  • È stato effettuato un tentativo di collegamento della stessa istanza di ContentKey all'istanza di Asset.An attempt was made to link the same ContentKey to the Asset.
  • È stato effettuato un tentativo di creazione di un localizzatore in un'istanza di Asset il cui contenitore di archiviazione risulta mancante o non è più associato all'istanza di Asset.An attempt was made to create a locator to an Asset whose storage container is missing or is no longer associated with the Asset.
  • È stato effettuato un tentativo di creazione di un localizzatore in un'istanza di Asset che ha già cinque localizzatori in uso.An attempt was made to create a locator to an Asset which already has 5 locators in use. Archiviazione di Azure applica il limite di cinque criteri di accesso condiviso in un contenitore di archiviazione.(Azure Storage enforces the limit of five shared access policies on one storage container.)
  • Il collegamento di account di archiviazione di un'istanza di Asset a un'istanza di IngestManifestAsset non corrisponde all'account di archiviazione usato dall'istanza di IngestManifest.Linking storage account of an Asset to an IngestManifestAsset is not the same as the storage account used by the parent IngestManifest.

500 - Errore interno del server500 Internal Server Error

Durante l'elaborazione della richiesta, in Servizi multimediali viene generato un errore che impedisce di continuare l'elaborazione.During the processing of the request, Media Services encounters some error that prevents the processing from continuing. Il problema può dipendere da una delle cause seguenti:This could be due to one of the following reasons:

  • La creazione di un'istanza di Asset o Job ha esito negativo a causa della temporanea mancanza di disponibilità di informazioni sulle quote di servizio dell'account di Servizi multimediali.Creating an Asset or Job fails because the Media Services account's service quota information is temporarily unavailable.
  • La creazione di un contenitore di archiviazione BLOB di Asset o IngestManifest ha esito negativo perché le informazioni sull'account di archiviazione dell'account sono temporaneamente non disponibili.Creating an Asset or IngestManifest blob storage container fails because the account's storage account information is temporarily unavailable.
  • Un altro errore imprevisto.Other unexpected error.

503 - Servizio non disponibile503 Service Unavailable

Il server non è attualmente in grado di ricevere richieste.The server is currently unable to receive requests. Questo errore può essere causato da un numero eccessivo di richieste al servizio.This error may be caused by excessive requests to the service. Il meccanismo di limitazione delle richieste di Servizi multimediali limita l'uso delle risorse per le applicazioni che inviano un numero elevato di richieste al servizio.Media Services throttling mechanism restricts the resource usage for applications that make excessive request to the service.

Nota

Controllare il messaggio di errore e la stringa del codice di errore per ottenere informazioni più dettagliate sul motivo per cui è stato generato un errore 503.Check the error message and error code string to get more detailed information about the reason you got the 503 error. Questo errore non indica necessariamente la limitazione delle richieste.This error does not always mean throttling.

Possibili descrizioni dello stato sono:Possible status descriptions are:

  • "Il server è occupato."Server is busy. Esecuzioni precedenti di questo tipo di richiesta hanno impiegato più di {0} secondi."Previous runs of this type of request took more than {0} seconds."
  • "Il server è occupato."Server is busy. Più di {0} richieste al secondo possono essere limitate."More than {0} requests per second can be throttled."
  • "Il server è occupato."Server is busy. Più di {0} richieste in {1} secondi possono essere limitate."More than {0} requests within {1} seconds can be throttled."

Per gestire questo errore, è consigliabile usare la logica di ripetizione dei tentativi con interruzione temporanea esponenziale.To handle this error, we recommend using exponential back-off retry logic. Ciò significa usare attese progressivamente più lunghe tra le ripetizioni dei tentativi per le risposte di errore consecutive.That means using progressively longer waits between retries for consecutive error responses. Per altre informazioni, vedere Transient Fault Handling Application Block (Blocco di applicazioni per la gestione degli errori temporanei).For more information, see Transient Fault Handling Application Block.

Nota

Se si usa Azure Media Services SDK for .Net, la logica di ripetizione dei tentativi per l'errore 503 è stata implementata dall'SDK.If you are using Azure Media Services SDK for .Net, the retry logic for the 503 error has been implemented by the SDK.

Vedere ancheSee Also

Codici di errore di gestione di Servizi multimedialiMedia Services Management Error Codes

Passaggi successiviNext steps

Altre informazioni sui percorsi di apprendimento di Servizi multimediali di Azure:Read about the Azure Media Services learning paths:

Fornire commenti e suggerimentiProvide feedback

Usare il forum di suggerimenti degli utenti per fornire commenti e suggerimenti su come migliorare Servizi multimediali di Azure.Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. È anche possibile passare direttamente a una delle categorie seguenti:You also can go directly to one of the following categories: