Sviluppare con le API di Servizi multimediali v3

  • Articolo

Logo servizi multimediali v3

Avviso

Servizi multimediali di Azure verrà ritirato il 30 giugno 2024. Per altre informazioni, vedere la Guida al ritiro di AMS.

Come sviluppatore, è possibile usare librerie client per (.NET, Python, Node.js, Java e Go) che consentono di interagire con l'API REST per creare, gestire e gestire flussi di lavoro multimediali personalizzati. L'API Servizi multimediali v3 è basata sulla specifica OpenAPI (in precedenza nota come Swagger).

Questo articolo descrive le regole applicabili alle entità e alle API quando vengono eseguite attività di sviluppo con Servizi multimediali v3.

Avviso

Non è consigliabile tentare di eseguire il wrapping dell'API REST per Servizi multimediali direttamente nel codice della libreria, perché in questo modo è necessario implementare la logica di ripetizione dei tentativi di Gestione risorse di Azure completa e comprendere come gestire operazioni a esecuzione prolungata nelle API di Gestione risorse di Azure. Questo viene gestito dagli SDK client per diversi linguaggi , .NET, Java, TypeScript, Python e così via, riducendo automaticamente le probabilità di problemi relativi alla logica di ripetizione dei tentativi o alle chiamate API non riuscite. Gli SDK client gestiscono tutto questo.

Accesso all'API di Servizi multimediali di Azure

Per essere autorizzati ad accedere alle risorse e all'API di Servizi multimediali, è innanzitutto necessario essere autenticati. Servizi multimediali supporta l'autenticazione basata su Azure Active Directory (Azure AD). Esistono due opzioni di autenticazione comuni:

  • Autenticazione tramite entità servizio: usata per autenticare un servizio, ad esempio app Web, app per le funzioni, app per la logica, API e microservizi. Le applicazioni che in genere usano questo metodo di autenticazione sono app che eseguono servizi daemon, servizi di livello intermedio o processi pianificati. Per le app Web, ad esempio, deve essere sempre presente un livello intermedio che si connette a Servizi multimediali con un'entità servizio.
  • Autenticazione utente: usata per autenticare una persona che usa l'app per interagire con le risorse di Servizi multimediali. L'app interattiva deve prima richiedere all'utente le credenziali. Un esempio è un'app della console di gestione usata dagli utenti autorizzati per monitorare i processi di codifica o lo streaming live.

Per l'API di Servizi multimediali è necessario che l'utente o l'app che effettua le richieste all'API REST possa accedere alla risorsa dell'account di Servizi multimediali e usi un ruolo Collaboratore o Proprietario. L'API può essere accessibile con il ruolo Lettore , ma saranno disponibili solo le operazioni Get o List . Per altre informazioni, vedere Controllo degli accessi in base al ruolo di Azure per gli account di Servizi multimediali.

Invece di creare un'entità servizio, è consigliabile usare identità gestite per le risorse di Azure per accedere all'API di Servizi multimediali tramite Azure Resource Manager. Per altre informazioni sulle identità gestite per le risorse di Azure, vedere Informazioni sulle identità gestite per le risorse di Azure.

Entità servizio di Azure AD

L'app e l'entità servizio di Azure AD devono trovarsi nello stesso tenant. Dopo aver creato l'app, concedere al ruolo Collaboratore o Proprietario dell'app l'accesso all'account di Servizi multimediali.

Se non si è certi di avere le autorizzazioni necessarie per creare un'app Azure AD, vedere Autorizzazioni necessarie.

Nella figura seguente i numeri rappresentano il flusso delle richieste in ordine cronologico:

Autenticazione di app di livello intermedio con AAD da un'API Web

  1. Un'app di livello intermedio richiede un token di accesso di Azure AD con i parametri seguenti:

    • Endpoint tenant di Azure AD.
    • URI di risorsa per Servizi multimediali.
    • URI di risorsa per Servizi multimediali REST.
    • Valori dell'app Azure AD: ID client e segreto client.

    Per ottenere tutti i valori necessari, vedere Accedere all'API di Servizi multimediali di Azure.

  2. Il token di accesso di Azure AD viene inviato al livello intermedio.

  3. Il livello intermedio invia una richiesta all'API REST di Servizi multimediali di Azure con il token di Azure AD.

  4. Il livello intermedio ottiene nuovamente i dati da Servizi multimediali.

Esempi

Vedere gli esempi seguenti che illustrano come connettersi con l'entità servizio di Azure AD:

Convenzioni di denominazione

I nomi delle risorse di Servizi multimediali di Azure v3 (ad esempio, asset, processi e trasformazioni) sono soggetti ai vincoli di denominazione di Azure Resource Manager. In conformità con Azure Resource Manager, i nomi delle risorse sono sempre univoci. Di conseguenza, per i nomi delle risorse è possibile usare qualsiasi stringa di identificatore univoco (ad esempio, GUID).

I nomi delle risorse di Servizi multimediali non possono includere: '<', '',> '%', '&', ':', '\', '?', '/', '*', '+', '+', '.', il carattere di virgolette singole o qualsiasi carattere di controllo. Sono consentiti tutti gli altri caratteri. La lunghezza massima di un nome di risorsa è di 260 caratteri.

Per altre informazioni sulla denominazione di Azure Resource Manager, vedere Requisiti di denominazione e Convenzioni di denominazione.

Nomi di file/BLOB all'interno di un asset

I nomi di file/BLOB all'interno di un asset devono rispettare i requisiti del nome del BLOB e i requisiti del nome NTFS. Questi requisiti sono necessari perché i file possano essere copiati dall'archiviazione BLOB in un disco NTFS locale per l'elaborazione.

Operazioni a esecuzione prolungata

Le operazioni contrassegnate con x-ms-long-running-operation nei file Swagger di Servizi multimediali di Azure sono a esecuzione prolungata.

Per informazioni dettagliate su come tenere traccia delle operazioni asincrone di Azure, vedere Operazioni asincrone.

Servizi multimediali include le seguenti operazioni a esecuzione prolungata:

Al termine dell'invio di un'operazione prolungata, viene visualizzato un '201 Create' e deve eseguire il polling per il completamento dell'operazione usando l'ID operazione restituito.

L'articolo Tenere traccia delle operazioni asincrone spiega in maniera approfondita come tenere traccia dello stato delle operazioni asincrone di Azure tramite i valori restituiti nella risposta.

Per un determinato evento live o per qualsiasi output live associato è supportata una sola operazione a esecuzione prolungata. Dopo l'avvio, un'operazione a esecuzione prolungata deve essere completata prima di avviare una successiva operazione a esecuzione prolungata per lo stesso evento live o per qualsiasi output live associato. Per gli eventi live con più output live, è necessario attendere il completamento di un'operazione a esecuzione prolungata per un output live prima di attivare un'operazione a esecuzione prolungata per un altro output live.

SDK

Nota

Gli SDK di Servizi multimediali di Azure v3 non sono garantiti come thread-safe. Quando si sviluppa un'app multithreading, è necessario aggiungere la propria logica di sincronizzazione thread per proteggere il client oppure usare un nuovo oggetto AzureMediaServicesClient per ogni thread. È anche necessario prestare attenzione ai problemi di multithreading introdotti da oggetti facoltativi forniti dal codice al client (ad esempio, un'istanza di HttpClient in .NET).

SDK Informazioni di riferimento
.NET SDK Informazioni di riferimento su .NET
SDK per Java Informazioni di riferimento su Java
Python SDK Informazioni di riferimento su Python
Node.js SDK Informazioni di riferimento su Node.js
Go SDK Informazioni di riferimento su Go

Vedere anche

Explorer di Servizi multimediali di Azure

Azure Media Services Explorer (AMSE) è uno strumento disponibile per i clienti di Windows che vogliono informazioni su Servizi multimediali. AMSE è un'applicazione Winforms/C# che esegue operazioni di caricamento, download, codifica, streaming di VOD e contenuti live con Servizi multimediali. Lo strumento AMSE è stato pensato per i clienti che vogliono testare Servizi multimediali senza scrivere codice. Il codice AMSE viene fornito come risorsa per i clienti che vogliono sviluppare con Servizi multimediali.

AMSE è un progetto Open Source, il supporto viene fornito dalla community (i problemi possono essere segnalati a https://github.com/Azure/Azure-Media-Services-Explorer/issues). Questo progetto ha adottato il Codice di comportamento di Microsoft per l'open source. Per altre informazioni, vedere Domande frequenti sul codice di comportamento oppure scrivere a opencode@microsoft.com per qualsiasi altro commento o domanda.

Applicazione di filtri, ordinamento e restituzione di più pagine delle entità di Servizi multimediali

Vedere Applicazione di filtri, ordinamento e paging delle entità di Servizi multimediali di Azure.

Guida e supporto tecnico

È possibile contattare Servizi multimediali con domande o seguire gli aggiornamenti tramite uno dei metodi seguenti: