Streaming Policies - Get

Ottenere un criterio di streaming
Ottenere i dettagli di un criterio di streaming nell'account servizi multimediali

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}?api-version=2022-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

Nome dell'account di Servizi multimediali.

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

streamingPolicyName
path True

string

Nome criteri di streaming.

subscriptionId
path True

string

Identificatore univoco per una sottoscrizione di Microsoft Azure.

api-version
query True

string

Versione dell'API da usare con la richiesta client.

Risposte

Nome Tipo Descrizione
200 OK

StreamingPolicy

OK

Other Status Codes

ErrorResponse

Informazioni dettagliate sull'errore.

Esempio

Get a Streaming Policy by name

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/clearStreamingPolicy?api-version=2022-08-01

Risposta di esempio

{
  "name": "clearStreamingPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/clearStreamingPolicy",
  "type": "Microsoft.Media/mediaservices/streamingPolicies",
  "properties": {
    "created": "2018-08-08T18:29:30.8501486Z",
    "noEncryption": {
      "enabledProtocols": {
        "download": true,
        "dash": true,
        "hls": true,
        "smoothStreaming": true
      }
    }
  }
}

Definizioni

Nome Descrizione
CbcsDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCbcs in Criteri di streaming

CencDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCenc in Criteri di streaming

ClearKeyEncryptionConfiguration

Classe per specificare la configurazione ClearKey degli schemi di crittografia comuni nei criteri di streaming

CommonEncryptionCbcs

Classe per CommonEncryptionCbcs schema di crittografia

CommonEncryptionCenc

Classe per lo schema di crittografia busta

createdByType

Tipo di identità che ha creato la risorsa.

DefaultKey

Classe per specificare le proprietà della chiave di contenuto predefinita per ogni schema di crittografia

EnabledProtocols

Classe per specificare quali protocolli sono abilitati

EnvelopeEncryption

Classe per lo schema di crittografia EnvelopeEncryption

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

NoEncryption

Classe per lo schema NoEncryption

StreamingPolicy

Risorsa Criteri di streaming

StreamingPolicyContentKey

Classe per specificare le proprietà della chiave di contenuto

StreamingPolicyContentKeys

Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming

StreamingPolicyFairPlayConfiguration

Classe per specificare le configurazioni di FairPlay nei criteri di streaming

StreamingPolicyPlayReadyConfiguration

Classe per specificare le configurazioni di PlayReady nei criteri di streaming

StreamingPolicyWidevineConfiguration

Classe per specificare le configurazioni di Widevine nei criteri di streaming

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

TrackPropertyCompareOperation

Tenere traccia dell'operazione della condizione delle proprietà

TrackPropertyCondition

Classe per specificare una condizione di proprietà track

TrackPropertyType

Tipo di proprietà Track

TrackSelection

Classe per selezionare una traccia

CbcsDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCbcs in Criteri di streaming

Nome Tipo Descrizione
fairPlay

StreamingPolicyFairPlayConfiguration

Configurazioni FairPlay

playReady

StreamingPolicyPlayReadyConfiguration

Configurazioni playReady

widevine

StreamingPolicyWidevineConfiguration

Configurazioni Widevine

CencDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCenc in Criteri di streaming

Nome Tipo Descrizione
playReady

StreamingPolicyPlayReadyConfiguration

Configurazioni playReady

widevine

StreamingPolicyWidevineConfiguration

Configurazioni Widevine

ClearKeyEncryptionConfiguration

Classe per specificare la configurazione ClearKey degli schemi di crittografia comuni nei criteri di streaming

Nome Tipo Descrizione
customKeysAcquisitionUrlTemplate

string

Modello per l'URL del servizio personalizzato che fornisce chiavi di contenuto ai lettori utente finali. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. Il valore del token attualmente supportato è {AlternativeMediaId}, sostituito con il valore di StreamingLocatorId.AlternativeMediaId.

CommonEncryptionCbcs

Classe per CommonEncryptionCbcs schema di crittografia

Nome Tipo Descrizione
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCbcs.

clearTracks

TrackSelection[]

Rappresentazione delle tracce che non devono essere crittografate

contentKeys

StreamingPolicyContentKeys

Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche

drm

CbcsDrmConfiguration

Configurazione delle macchine di ripristino di emergenza per lo schema di crittografia corrente

enabledProtocols

EnabledProtocols

Rappresentazione dei protocolli supportati

CommonEncryptionCenc

Classe per lo schema di crittografia busta

Nome Tipo Descrizione
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCenc.

clearTracks

TrackSelection[]

Rappresentazione delle tracce che non devono essere crittografate

contentKeys

StreamingPolicyContentKeys

Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche

drm

CencDrmConfiguration

Configurazione delle macchine di ripristino di emergenza per lo schema di crittografia CommonEncryptionCenc

enabledProtocols

EnabledProtocols

Rappresentazione dei protocolli supportati

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultKey

Classe per specificare le proprietà della chiave di contenuto predefinita per ogni schema di crittografia

Nome Tipo Descrizione
label

string

L'etichetta può essere usata per specificare la chiave di contenuto durante la creazione di un localizzatore di streaming

policyName

string

Criteri usati dalla chiave predefinita

EnabledProtocols

Classe per specificare quali protocolli sono abilitati

Nome Tipo Descrizione
dash

boolean

Abilitare il protocollo DASH o meno

download

boolean

Abilitare il protocollo di download o meno

hls

boolean

Abilitare il protocollo HLS o meno

smoothStreaming

boolean

Abilitare il protocollo SmoothStreaming o meno

EnvelopeEncryption

Classe per lo schema di crittografia EnvelopeEncryption

Nome Tipo Descrizione
clearTracks

TrackSelection[]

Rappresentazione delle tracce che non devono essere crittografate

contentKeys

StreamingPolicyContentKeys

Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche

customKeyAcquisitionUrlTemplate

string

Modello per l'URL del servizio personalizzato che fornisce chiavi ai giocatori finali. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di chiavi. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

enabledProtocols

EnabledProtocols

Rappresentazione dei protocolli supportati

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

NoEncryption

Classe per lo schema NoEncryption

Nome Tipo Descrizione
enabledProtocols

EnabledProtocols

Rappresentazione dei protocolli supportati

StreamingPolicy

Risorsa Criteri di streaming

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nome della risorsa.

properties.commonEncryptionCbcs

CommonEncryptionCbcs

Configurazione di CommonEncryptionCbcs

properties.commonEncryptionCenc

CommonEncryptionCenc

Configurazione di CommonEncryptionCenc

properties.created

string

Ora di creazione dei criteri di streaming

properties.defaultContentKeyPolicyName

string

ContentKey predefinita usata dai criteri di streaming correnti

properties.envelopeEncryption

EnvelopeEncryption

Configurazione di EnvelopeEncryption

properties.noEncryption

NoEncryption

Configurazione di NoEncryption

systemData

systemData

Metadati di sistema relativi a questa risorsa.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

StreamingPolicyContentKey

Classe per specificare le proprietà della chiave di contenuto

Nome Tipo Descrizione
label

string

L'etichetta può essere usata per specificare la chiave di contenuto durante la creazione di un localizzatore di streaming

policyName

string

Criteri usati da Content Key

tracks

TrackSelection[]

Tiene traccia che usano questa chiave di contenuto

StreamingPolicyContentKeys

Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming

Nome Tipo Descrizione
defaultKey

DefaultKey

Chiave di contenuto predefinita per uno schema di crittografia

keyToTrackMappings

StreamingPolicyContentKey[]

Rappresentazione delle tracce richiede una chiave di contenuto separata

StreamingPolicyFairPlayConfiguration

Classe per specificare le configurazioni di FairPlay nei criteri di streaming

Nome Tipo Descrizione
allowPersistentLicense

boolean

Tutte le licenze da mantenere o meno

customLicenseAcquisitionUrlTemplate

string

Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

StreamingPolicyPlayReadyConfiguration

Classe per specificare le configurazioni di PlayReady nei criteri di streaming

Nome Tipo Descrizione
customLicenseAcquisitionUrlTemplate

string

Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

playReadyCustomAttributes

string

Attributi personalizzati per PlayReady

StreamingPolicyWidevineConfiguration

Classe per specificare le configurazioni di Widevine nei criteri di streaming

Nome Tipo Descrizione
customLicenseAcquisitionUrlTemplate

string

Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima risorsa.

TrackPropertyCompareOperation

Tenere traccia dell'operazione della condizione delle proprietà

Nome Tipo Descrizione
Equal

string

Operazione uguale

Unknown

string

Operazione di confronto delle proprietà di traccia sconosciuta

TrackPropertyCondition

Classe per specificare una condizione di proprietà track

Nome Tipo Descrizione
operation

TrackPropertyCompareOperation

Tenere traccia dell'operazione della condizione delle proprietà

property

TrackPropertyType

Tipo di proprietà Track

value

string

Tenere traccia del valore della proprietà

TrackPropertyType

Tipo di proprietà Track

Nome Tipo Descrizione
FourCC

string

Tenere traccia di FourCC

Unknown

string

Proprietà track sconosciuta

TrackSelection

Classe per selezionare una traccia

Nome Tipo Descrizione
trackSelections

TrackPropertyCondition[]

TrackSelections è un elenco di condizioni di proprietà di traccia che può specificare tracce