Streaming Policies - List
Elencare i criteri di streaming
Elenchi i criteri di streaming nell'account
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01&$filter={$filter}&$top={$top}&$orderby={$orderby}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di Servizi multimediali. |
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione di Azure. |
subscription
|
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. |
$filter
|
query |
string |
Limita il set di elementi restituiti. |
|
$orderby
|
query |
string |
Specifica la chiave in base alla quale deve essere ordinata la raccolta dei risultati. |
|
$top
|
query |
integer int32 |
Specifica un numero intero non negativo n che limita il numero di elementi restituiti da una raccolta. Il servizio restituisce il numero di elementi disponibili fino a ma non maggiore del valore specificato n. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Informazioni dettagliate sull'errore. |
Esempio
Lists Streaming Policies
Esempio di richiesta
Risposta di esempio
{
"value": [
{
"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.676067Z",
"noEncryption": {
"enabledProtocols": {
"download": true,
"dash": true,
"hls": true,
"smoothStreaming": true
}
}
}
},
{
"name": "secureStreamingPolicy",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicy",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:30.6781134Z",
"defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
"envelopeEncryption": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": true,
"smoothStreaming": true
},
"clearTracks": [],
"contentKeys": {
"defaultKey": {
"label": "aesDefaultKey"
},
"keyToTrackMappings": []
},
"customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
},
"commonEncryptionCenc": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": false,
"smoothStreaming": true
},
"clearTracks": [
{
"trackSelections": [
{
"property": "FourCC",
"operation": "Unknown",
"value": "hev1"
}
]
}
],
"contentKeys": {
"defaultKey": {
"label": "cencDefaultKey"
},
"keyToTrackMappings": []
},
"drm": {
"playReady": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/playready/{ContentKeyId}",
"playReadyCustomAttributes": "PlayReady CustomAttributes"
},
"widevine": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/widevine/{ContentKeyId"
}
}
},
"commonEncryptionCbcs": {
"enabledProtocols": {
"download": false,
"dash": false,
"hls": true,
"smoothStreaming": false
},
"clearTracks": [],
"contentKeys": {
"defaultKey": {
"label": "cbcsDefaultKey"
},
"keyToTrackMappings": []
},
"drm": {
"fairPlay": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
"allowPersistentLicense": true
}
}
}
}
},
{
"name": "secureStreamingPolicyWithCommonEncryptionCbcsOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithCommonEncryptionCbcsOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:30.6781134Z",
"defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
"commonEncryptionCbcs": {
"enabledProtocols": {
"download": false,
"dash": false,
"hls": true,
"smoothStreaming": false
},
"clearTracks": [],
"contentKeys": {
"defaultKey": {
"label": "cbcsDefaultKey"
},
"keyToTrackMappings": []
},
"drm": {
"fairPlay": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
"allowPersistentLicense": true
}
}
}
}
},
{
"name": "secureStreamingPolicyWithCommonEncryptionCencOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithCommonEncryptionCencOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:30.6781134Z",
"defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
"commonEncryptionCenc": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": false,
"smoothStreaming": true
},
"clearTracks": [
{
"trackSelections": [
{
"property": "FourCC",
"operation": "Unknown",
"value": "hev1"
}
]
}
],
"contentKeys": {
"defaultKey": {
"label": "cencDefaultKey"
},
"keyToTrackMappings": []
},
"drm": {
"playReady": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/playready/{ContentKeyId}",
"playReadyCustomAttributes": "PlayReady CustomAttributes"
},
"widevine": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/widevine/{ContentKeyId"
}
}
}
}
},
{
"name": "secureStreamingPolicyWithEnvelopeEncryptionOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithEnvelopeEncryptionOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:30.6781134Z",
"defaultContentKeyPolicyName": "PolicyWithClearKeyOptionAndTokenRestriction",
"envelopeEncryption": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": true,
"smoothStreaming": true
},
"clearTracks": [],
"contentKeys": {
"defaultKey": {
"label": "aesDefaultKey"
},
"keyToTrackMappings": []
},
"customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
}
}
}
],
"@odata.nextLink": "http://server/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies?api-version=2022-08-01&$skiptoken=secureStreamingPolicyWithEnvelopeEncryptionOnly"
}
Definizioni
Nome | Descrizione |
---|---|
Cbcs |
Classe per specificare le configurazioni DRM dello schema CommonEncryptionCbcs nei criteri di streaming |
Cenc |
Classe per specificare le configurazioni DRM dello schema CommonEncryptionCenc nei criteri di streaming |
Clear |
Classe per specificare la configurazione ClearKey degli schemi di crittografia comuni nei criteri di streaming |
Common |
Classe per lo schema di crittografia CommonEncryptionCbcs |
Common |
Classe per lo schema di crittografia della busta |
created |
Tipo di identità che ha creato la risorsa. |
Default |
Classe per specificare le proprietà della chiave simmetrica predefinita per ogni schema di crittografia |
Enabled |
Classe per specificare i protocolli abilitati |
Envelope |
Classe per lo schema di crittografia EnvelopeEncryption |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
No |
Classe per lo schema NoEncryption |
Streaming |
Una risorsa criteri di streaming |
Streaming |
Raccolta di elementi StreamingPolicy. |
Streaming |
Classe per specificare le proprietà della chiave simmetrica |
Streaming |
Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming |
Streaming |
Classe per specificare le configurazioni di FairPlay nei criteri di streaming |
Streaming |
Classe per specificare le configurazioni di PlayReady nei criteri di streaming |
Streaming |
Classe per specificare le configurazioni di Widevine nei criteri di streaming |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Track |
Tenere traccia dell'operazione della condizione della proprietà |
Track |
Classe per specificare una condizione della proprietà track |
Track |
Tipo di proprietà Track |
Track |
Classe per selezionare una traccia |
CbcsDrmConfiguration
Classe per specificare le configurazioni DRM dello schema CommonEncryptionCbcs nei criteri di streaming
Nome | Tipo | Descrizione |
---|---|---|
fairPlay |
Configurazioni FairPlay |
|
playReady |
Configurazioni PlayReady |
|
widevine |
Configurazioni Widevine |
CencDrmConfiguration
Classe per specificare le configurazioni DRM dello schema CommonEncryptionCenc nei criteri di streaming
Nome | Tipo | Descrizione |
---|---|---|
playReady |
Configurazioni PlayReady |
|
widevine |
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 distribuisce chiavi di contenuto ai lettori degli utenti finali. Non necessario quando si usa Servizi multimediali di Azure per il rilascio di licenze. Il modello supporta token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. Il valore del token attualmente supportato è {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId. |
CommonEncryptionCbcs
Classe per lo schema di crittografia CommonEncryptionCbcs
Nome | Tipo | Descrizione |
---|---|---|
clearKeyEncryptionConfiguration |
Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCbcs. |
|
clearTracks |
Rappresentazione delle tracce che non devono essere crittografate |
|
contentKeys |
Rappresentazione della chiave simmetrica predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche |
|
drm |
Configurazione dei drms per lo schema di crittografia corrente |
|
enabledProtocols |
Rappresentazione dei protocolli supportati |
CommonEncryptionCenc
Classe per lo schema di crittografia della busta
Nome | Tipo | Descrizione |
---|---|---|
clearKeyEncryptionConfiguration |
Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCenc. |
|
clearTracks |
Rappresentazione delle tracce che non devono essere crittografate |
|
contentKeys |
Rappresentazione della chiave simmetrica predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche |
|
drm |
Configurazione di DRMs per lo schema di crittografia CommonEncryptionCenc |
|
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 simmetrica predefinita per ogni schema di crittografia
Nome | Tipo | Descrizione |
---|---|---|
label |
string |
L'etichetta può essere usata per specificare la chiave simmetrica durante la creazione di un localizzatore di streaming |
policyName |
string |
Criteri usati dalla chiave predefinita |
EnabledProtocols
Classe per specificare i protocolli abilitati
Nome | Tipo | Descrizione |
---|---|---|
dash |
boolean |
Abilitare o meno il protocollo DASH |
download |
boolean |
Abilitare o meno il protocollo di download |
hls |
boolean |
Abilitare o meno il protocollo HLS |
smoothStreaming |
boolean |
Abilitare o meno il protocollo SmoothStreaming |
EnvelopeEncryption
Classe per lo schema di crittografia EnvelopeEncryption
Nome | Tipo | Descrizione |
---|---|---|
clearTracks |
Rappresentazione delle tracce che non devono essere crittografate |
|
contentKeys |
Rappresentazione della chiave simmetrica 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 le chiavi ai lettori degli utenti finali. Non necessario quando si usa Servizi multimediali di Azure per l'emissione di chiavi. Il modello supporta 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 |
Rappresentazione dei protocolli supportati |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
NoEncryption
Classe per lo schema NoEncryption
Nome | Tipo | Descrizione |
---|---|---|
enabledProtocols |
Rappresentazione dei protocolli supportati |
StreamingPolicy
Una risorsa criteri di streaming
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nome della risorsa. |
properties.commonEncryptionCbcs |
Configurazione di CommonEncryptionCbcs |
|
properties.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 |
Configurazione di EnvelopeEncryption |
|
properties.noEncryption |
Configurazione di NoEncryption |
|
systemData |
Metadati di sistema relativi a questa risorsa. |
|
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
StreamingPolicyCollection
Raccolta di elementi StreamingPolicy.
Nome | Tipo | Descrizione |
---|---|---|
@odata.nextLink |
string |
Collegamento alla pagina successiva dell'insieme (quando la raccolta contiene troppi risultati da restituire in una sola risposta). |
value |
Raccolta di elementi StreamingPolicy. |
StreamingPolicyContentKey
Classe per specificare le proprietà della chiave simmetrica
Nome | Tipo | Descrizione |
---|---|---|
label |
string |
L'etichetta può essere usata per specificare la chiave simmetrica durante la creazione di un localizzatore di streaming |
policyName |
string |
Criteri usati dalla chiave simmetrica |
tracks |
Tiene traccia dell'uso di questa chiave simmetrica |
StreamingPolicyContentKeys
Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming
Nome | Tipo | Descrizione |
---|---|---|
defaultKey |
Chiave simmetrica predefinita per uno schema di crittografia |
|
keyToTrackMappings |
La rappresentazione delle tracce richiede una chiave simmetrica separata |
StreamingPolicyFairPlayConfiguration
Classe per specificare le configurazioni di FairPlay nei criteri di streaming
Nome | Tipo | Descrizione |
---|---|---|
allowPersistentLicense |
boolean |
Tutte le licenze per essere persistenti o meno |
customLicenseAcquisitionUrlTemplate |
string |
Modello per l'URL del servizio personalizzato che fornisce licenze ai lettori degli utenti finali. Non necessario quando si usa Servizi multimediali di Azure per il rilascio di licenze. Il modello supporta 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 lettori degli utenti finali. Non necessario quando si usa Servizi multimediali di Azure per il rilascio di licenze. Il modello supporta 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 lettori degli utenti finali. Non necessario quando si usa Servizi multimediali di Azure per il rilascio di licenze. Il modello supporta 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 |
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 volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
TrackPropertyCompareOperation
Tenere traccia dell'operazione della condizione della proprietà
Nome | Tipo | Descrizione |
---|---|---|
Equal |
string |
Operazione uguale |
Unknown |
string |
Operazione di confronto delle proprietà di traccia sconosciuta |
TrackPropertyCondition
Classe per specificare una condizione della proprietà track
Nome | Tipo | Descrizione |
---|---|---|
operation |
Tenere traccia dell'operazione della condizione della proprietà |
|
property |
Tipo di proprietà Track |
|
value |
string |
Tenere traccia del valore della proprietà |
TrackPropertyType
Tipo di proprietà Track
Nome | Tipo | Descrizione |
---|---|---|
FourCC |
string |
Track FourCC |
Unknown |
string |
Proprietà track sconosciuta |
TrackSelection
Classe per selezionare una traccia
Nome | Tipo | Descrizione |
---|---|---|
trackSelections |
TrackSelections è un elenco di condizioni della proprietà track che può specificare tracce |