Streaming Policies - List
Enumerar directivas de streaming
Listas las directivas de streaming de la cuenta
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}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Media Services. |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Identificador único de una suscripción de Microsoft Azure. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. |
$filter
|
query |
string |
Restringe el conjunto de elementos devueltos. |
|
$orderby
|
query |
string |
Especifica la clave por la que se debe ordenar la colección de resultados. |
|
$top
|
query |
integer int32 |
Especifica un entero no negativo n que limita el número de elementos devueltos de una colección. El servicio devuelve el número de elementos disponibles hasta pero no mayor que el valor especificado n. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Información detallada del error. |
Ejemplos
Lists Streaming Policies
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
Definiciones
Nombre | Description |
---|---|
Cbcs |
Clase para especificar configuraciones drm del esquema CommonEncryptionCbcs en la directiva de streaming |
Cenc |
Clase para especificar configuraciones drm del esquema CommonEncryptionCenc en la directiva de streaming |
Clear |
Clase para especificar la configuración clearKey de esquemas de cifrado comunes en la directiva de streaming |
Common |
Clase para el esquema de cifrado CommonEncryptionCbcs |
Common |
Clase para el esquema de cifrado de sobre |
created |
Tipo de identidad que creó el recurso. |
Default |
Clase para especificar las propiedades de la clave de contenido predeterminada para cada esquema de cifrado |
Enabled |
Clase para especificar qué protocolos están habilitados |
Envelope |
Clase para el esquema de cifrado EnvelopeEncryption |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
No |
Clase para el esquema NoEncryption |
Streaming |
Un recurso de directiva de streaming |
Streaming |
Colección de elementos streamingPolicy. |
Streaming |
Clase para especificar las propiedades de la clave de contenido |
Streaming |
Clase para especificar propiedades de todas las claves de contenido en la directiva de streaming |
Streaming |
Clase para especificar configuraciones de FairPlay en la directiva de streaming |
Streaming |
Clase para especificar configuraciones de PlayReady en la directiva de streaming |
Streaming |
Clase para especificar configuraciones de Widevine en la directiva de streaming |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
Track |
Realizar un seguimiento de la operación de condición de propiedad |
Track |
Clase para especificar una condición de propiedad de seguimiento |
Track |
Tipo de propiedad Track |
Track |
Clase para seleccionar una pista |
CbcsDrmConfiguration
Clase para especificar configuraciones drm del esquema CommonEncryptionCbcs en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
fairPlay |
Configuraciones de FairPlay |
|
playReady |
Configuraciones de PlayReady |
|
widevine |
Configuraciones de Widevine |
CencDrmConfiguration
Clase para especificar configuraciones drm del esquema CommonEncryptionCenc en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
playReady |
Configuraciones de PlayReady |
|
widevine |
Configuraciones de Widevine |
ClearKeyEncryptionConfiguration
Clase para especificar la configuración clearKey de esquemas de cifrado comunes en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
customKeysAcquisitionUrlTemplate |
string |
Plantilla para la dirección URL del servicio personalizado que entrega claves de contenido a los reproductores del usuario final. No se requiere cuando se usa Azure Media Services para emitir las licencias. La plantilla admite tokens reemplazables que el servicio actualizará en tiempo de ejecución con el valor específico de la solicitud. El valor de token admitido actualmente es {AlternativeMediaId}, que se reemplaza por el valor de StreamingLocatorId.AlternativeMediaId. |
CommonEncryptionCbcs
Clase para el esquema de cifrado CommonEncryptionCbcs
Nombre | Tipo | Description |
---|---|---|
clearKeyEncryptionConfiguration |
Configuración opcional que admite ClearKey en el esquema de cifrado CommonEncryptionCbcs. |
|
clearTracks |
Representación de las pistas que no se deben cifrar |
|
contentKeys |
Representa la clave de contenido predeterminada para cada esquema de cifrado y claves de contenido independientes para pistas específicas |
|
drm |
Configuración de DRM para el esquema de cifrado actual |
|
enabledProtocols |
Representación de protocolos admitidos |
CommonEncryptionCenc
Clase para el esquema de cifrado de sobre
Nombre | Tipo | Description |
---|---|---|
clearKeyEncryptionConfiguration |
Configuración opcional que admite ClearKey en el esquema de cifrado CommonEncryptionCenc. |
|
clearTracks |
Representación de las pistas que no se deben cifrar |
|
contentKeys |
Representa la clave de contenido predeterminada para cada esquema de cifrado y claves de contenido independientes para pistas específicas |
|
drm |
Configuración de DRM para el esquema de cifrado CommonEncryptionCenc |
|
enabledProtocols |
Representación de protocolos admitidos |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultKey
Clase para especificar las propiedades de la clave de contenido predeterminada para cada esquema de cifrado
Nombre | Tipo | Description |
---|---|---|
label |
string |
La etiqueta se puede usar para especificar la clave de contenido al crear un localizador de streaming |
policyName |
string |
Directiva usada por la clave predeterminada |
EnabledProtocols
Clase para especificar qué protocolos están habilitados
Nombre | Tipo | Description |
---|---|---|
dash |
boolean |
Habilitar el protocolo DASH o no |
download |
boolean |
Habilitar el protocolo de descarga o no |
hls |
boolean |
Habilitación del protocolo HLS o no |
smoothStreaming |
boolean |
Habilitación del protocolo SmoothStreaming o no |
EnvelopeEncryption
Clase para el esquema de cifrado EnvelopeEncryption
Nombre | Tipo | Description |
---|---|---|
clearTracks |
Representación de las pistas que no se deben cifrar |
|
contentKeys |
Representa la clave de contenido predeterminada para cada esquema de cifrado y claves de contenido independientes para pistas específicas |
|
customKeyAcquisitionUrlTemplate |
string |
Plantilla para la dirección URL del servicio personalizado que entrega claves a los jugadores del usuario final. No se requiere cuando se usa Azure Media Services para la emisión de claves. La plantilla admite tokens reemplazables que el servicio actualizará en tiempo de ejecución con el valor específico de la solicitud. Los valores de token que se admiten actualmente son {AlternativeMediaId}, que se reemplaza por el valor de StreamingLocatorId.AlternativeMediaId, y {ContentKeyId}, que se reemplaza por el valor de identificador de la clave solicitada. |
enabledProtocols |
Representación de protocolos admitidos |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
NoEncryption
Clase para el esquema NoEncryption
Nombre | Tipo | Description |
---|---|---|
enabledProtocols |
Representación de protocolos admitidos |
StreamingPolicy
Un recurso de directiva de streaming
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso. |
properties.commonEncryptionCbcs |
Configuración de CommonEncryptionCbcs |
|
properties.commonEncryptionCenc |
Configuración de CommonEncryptionCenc |
|
properties.created |
string |
Hora de creación de la directiva de streaming |
properties.defaultContentKeyPolicyName |
string |
ContentKey predeterminada que utiliza la directiva de streaming actual |
properties.envelopeEncryption |
Configuración de EnvelopeEncryption |
|
properties.noEncryption |
Configuraciones de NoEncryption |
|
systemData |
Metadatos del sistema relacionados con este recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
StreamingPolicyCollection
Colección de elementos streamingPolicy.
Nombre | Tipo | Description |
---|---|---|
@odata.nextLink |
string |
Vínculo a la página siguiente de la colección (cuando la colección contiene demasiados resultados para devolver en una respuesta). |
value |
Colección de elementos streamingPolicy. |
StreamingPolicyContentKey
Clase para especificar las propiedades de la clave de contenido
Nombre | Tipo | Description |
---|---|---|
label |
string |
La etiqueta se puede usar para especificar la clave de contenido al crear un localizador de streaming |
policyName |
string |
Directiva usada por la clave de contenido |
tracks |
Pistas que usan esta clave de contenido |
StreamingPolicyContentKeys
Clase para especificar propiedades de todas las claves de contenido en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
defaultKey |
Clave de contenido predeterminada para un esquema de cifrado |
|
keyToTrackMappings |
La representación de pistas necesita una clave de contenido independiente |
StreamingPolicyFairPlayConfiguration
Clase para especificar configuraciones de FairPlay en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
allowPersistentLicense |
boolean |
Toda la licencia para que sea persistente o no |
customLicenseAcquisitionUrlTemplate |
string |
Plantilla para la dirección URL del servicio personalizado que entrega licencias a los jugadores de usuario final. No se requiere cuando se usa Azure Media Services para emitir las licencias. La plantilla admite tokens reemplazables que el servicio actualizará en tiempo de ejecución con el valor específico de la solicitud. Los valores de token que se admiten actualmente son {AlternativeMediaId}, que se reemplaza por el valor de StreamingLocatorId.AlternativeMediaId, y {ContentKeyId}, que se reemplaza por el valor de identificador de la clave solicitada. |
StreamingPolicyPlayReadyConfiguration
Clase para especificar configuraciones de PlayReady en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Plantilla para la dirección URL del servicio personalizado que entrega licencias a los jugadores del usuario final. No se requiere cuando se usa Azure Media Services para emitir las licencias. La plantilla admite tokens reemplazables que el servicio actualizará en tiempo de ejecución con el valor específico de la solicitud. Los valores de token que se admiten actualmente son {AlternativeMediaId}, que se reemplaza por el valor de StreamingLocatorId.AlternativeMediaId, y {ContentKeyId}, que se reemplaza por el valor de identificador de la clave solicitada. |
playReadyCustomAttributes |
string |
Atributos personalizados para PlayReady |
StreamingPolicyWidevineConfiguration
Clase para especificar configuraciones de Widevine en la directiva de streaming
Nombre | Tipo | Description |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Plantilla para la dirección URL del servicio personalizado que entrega licencias a los jugadores del usuario final. No se requiere cuando se usa Azure Media Services para emitir las licencias. La plantilla admite tokens reemplazables que el servicio actualizará en tiempo de ejecución con el valor específico de la solicitud. Los valores de token que se admiten actualmente son {AlternativeMediaId}, que se reemplaza por el valor de StreamingLocatorId.AlternativeMediaId, y {ContentKeyId}, que se reemplaza por el valor de identificador de la clave solicitada. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
TrackPropertyCompareOperation
Realizar un seguimiento de la operación de condición de propiedad
Nombre | Tipo | Description |
---|---|---|
Equal |
string |
Operación igual |
Unknown |
string |
Operación de comparación de propiedades de seguimiento desconocida |
TrackPropertyCondition
Clase para especificar una condición de propiedad de seguimiento
Nombre | Tipo | Description |
---|---|---|
operation |
Realizar un seguimiento de la operación de condición de propiedad |
|
property |
Tipo de propiedad Track |
|
value |
string |
Seguimiento del valor de la propiedad |
TrackPropertyType
Tipo de propiedad Track
Nombre | Tipo | Description |
---|---|---|
FourCC |
string |
Seguimiento de FourCC |
Unknown |
string |
Propiedad de pista desconocida |
TrackSelection
Clase para seleccionar una pista
Nombre | Tipo | Description |
---|---|---|
trackSelections |
TrackSelections es una lista de condiciones de propiedad de seguimiento que puede especificar pistas. |