Partilhar via

Streaming Policies - List

  • Referência
Serviço:
Media Services
Versão da API:
2022-08-01

Listar Políticas de Transmissão em Fluxo
Listas as Políticas de Transmissão em Fluxo na conta

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01
Com parâmetros opcionais: 
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 do URI

Name Em Necessário Tipo Description
accountName
 path True

string

O nome da conta dos Serviços de Multimédia.
resourceGroupName
 path True

string

O nome do grupo de recursos na subscrição do Azure.
subscriptionId
 path True

string

O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version
 query True

string

A versão da API a utilizar com o pedido de cliente.
$filter
 query

string

Restringe o conjunto de itens devolvidos.
$orderby
 query

string

Especifica a chave pela qual a coleção de resultados deve ser ordenada.
$top
 query

integer

int32

Especifica um número inteiro não negativo que limita o número de itens devolvidos de uma coleção. O serviço devolve o número de itens disponíveis até, mas não maior do que o valor especificado n.

Respostas

Name Tipo Description
200 OK

StreamingPolicyCollection

OK
Other Status Codes

ErrorResponse

Informações de erro detalhadas.

Exemplos

Lists Streaming Policies

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "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"
}

Definições

Name Description
CbcsDrmConfiguration

Classe para especificar configurações DRM do esquema CommonEncryptionCbcs na Política de Transmissão em Fluxo
CencDrmConfiguration

Classe para especificar configurações DRM do esquema CommonEncryptionCenc na Política de Transmissão em Fluxo
ClearKeyEncryptionConfiguration

Classe para especificar a configuração ClearKey de esquemas de encriptação comuns na Política de Transmissão em Fluxo
CommonEncryptionCbcs

Class for CommonEncryptionCbcs encryption scheme (Classe para o esquema de encriptação CommonEncryptionCbcs)
CommonEncryptionCenc

Classe para esquema de encriptação de envelopes
createdByType

O tipo de identidade que criou o recurso.
DefaultKey

Classe para especificar propriedades da chave de conteúdo predefinida para cada esquema de encriptação
EnabledProtocols

Classe para especificar os protocolos que estão ativados
EnvelopeEncryption

Classe para esquema de encriptação EnvelopeEncryption
ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta a erros
NoEncryption

Class for NoEncryption scheme (Classe para esquema NoEncryption)
StreamingPolicy

Um recurso de Política de Transmissão em Fluxo
StreamingPolicyCollection

Uma coleção de itens StreamingPolicy.
StreamingPolicyContentKey

Classe para especificar propriedades da chave de conteúdo
StreamingPolicyContentKeys

Classe para especificar propriedades de todas as chaves de conteúdo na Política de Transmissão em Fluxo
StreamingPolicyFairPlayConfiguration

Classe para especificar configurações do FairPlay na Política de Transmissão em Fluxo
StreamingPolicyPlayReadyConfiguration

Classe para especificar configurações do PlayReady na Política de Transmissão em Fluxo
StreamingPolicyWidevineConfiguration

Classe para especificar configurações do Widevine na Política de Transmissão em Fluxo
systemData

Metadados relativos à criação e última modificação do recurso.
TrackPropertyCompareOperation

Controlar a operação de condição de propriedade
TrackPropertyCondition

Classe para especificar uma condição de propriedade de faixa
TrackPropertyType

Controlar tipo de propriedade
TrackSelection

Classe para selecionar uma faixa

CbcsDrmConfiguration

Classe para especificar configurações DRM do esquema CommonEncryptionCbcs na Política de Transmissão em Fluxo

Name Tipo Description
fairPlay

StreamingPolicyFairPlayConfiguration

Configurações do FairPlay
playReady

StreamingPolicyPlayReadyConfiguration

Configurações do PlayReady
widevine

StreamingPolicyWidevineConfiguration

Configurações do Widevine

CencDrmConfiguration

Classe para especificar configurações DRM do esquema CommonEncryptionCenc na Política de Transmissão em Fluxo

Name Tipo Description
playReady

StreamingPolicyPlayReadyConfiguration

Configurações do PlayReady
widevine

StreamingPolicyWidevineConfiguration

Configurações do Widevine

ClearKeyEncryptionConfiguration

Classe para especificar a configuração ClearKey de esquemas de encriptação comuns na Política de Transmissão em Fluxo

Name Tipo Description
customKeysAcquisitionUrlTemplate

string

Modelo para o URL do serviço personalizado que fornece chaves de conteúdo aos leitores de utilizadores finais. Não é necessário ao utilizar os Serviços de Multimédia do Azure para emitir licenças. O modelo suporta tokens substituíveis que o serviço irá atualizar no runtime com o valor específico do pedido. O valor do token atualmente suportado é {AlternativeMediaId}, que é substituído pelo valor de StreamingLocatorId.AlternativeMediaId.

CommonEncryptionCbcs

Class for CommonEncryptionCbcs encryption scheme (Classe para o esquema de encriptação CommonEncryptionCbcs)

Name Tipo Description
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Configuração opcional que suporta ClearKey no esquema de encriptação CommonEncryptionCbcs.
clearTracks

TrackSelection[]

Representar as faixas que não devem ser encriptadas
contentKeys

StreamingPolicyContentKeys

Representar a chave de conteúdo predefinida para cada esquema de encriptação e chaves de conteúdo separadas para faixas específicas
drm

CbcsDrmConfiguration

Configuração de DRMs para o esquema de encriptação atual
enabledProtocols

EnabledProtocols

Representar protocolos suportados

CommonEncryptionCenc

Classe para esquema de encriptação de envelopes

Name Tipo Description
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Configuração opcional que suporta ClearKey no esquema de encriptação CommonEncryptionCenc.
clearTracks

TrackSelection[]

Representar as faixas que não devem ser encriptadas
contentKeys

StreamingPolicyContentKeys

Representar a chave de conteúdo predefinida para cada esquema de encriptação e chaves de conteúdo separadas para faixas específicas
drm

CencDrmConfiguration

Configuração de DRMs para o esquema de encriptação CommonEncryptionCenc
enabledProtocols

EnabledProtocols

Representar protocolos suportados

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultKey

Classe para especificar propriedades da chave de conteúdo predefinida para cada esquema de encriptação

Name Tipo Description
label

string

A etiqueta pode ser utilizada para especificar a Chave de Conteúdo ao criar um Localizador de Transmissão em Fluxo
policyName

string

Política utilizada pela Chave Predefinida

EnabledProtocols

Classe para especificar os protocolos que estão ativados

Name Tipo Description
dash

boolean

Ativar ou não o protocolo DASH
download

boolean

Ativar o protocolo Transferir ou não
hls

boolean

Ativar ou não o protocolo HLS
smoothStreaming

boolean

Ativar ou não o protocolo SmoothStreaming

EnvelopeEncryption

Classe para esquema de encriptação EnvelopeEncryption

Name Tipo Description
clearTracks

TrackSelection[]

Representar as faixas que não devem ser encriptadas
contentKeys

StreamingPolicyContentKeys

Representar a chave de conteúdo predefinida para cada esquema de encriptação e chaves de conteúdo separadas para faixas específicas
customKeyAcquisitionUrlTemplate

string

Modelo para o URL do serviço personalizado que fornece chaves aos leitores de utilizadores finais. Não é necessário ao utilizar os Serviços de Multimédia do Azure para emitir chaves. O modelo suporta tokens substituíveis que o serviço irá atualizar no runtime com o valor específico do pedido. Os valores de token atualmente suportados são {AlternativeMediaId}, que é substituído pelo valor de StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, que é substituído pelo valor do identificador da chave que está a ser pedida.
enabledProtocols

EnabledProtocols

Representar protocolos suportados

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

NoEncryption

Class for NoEncryption scheme (Classe para esquema NoEncryption)

Name Tipo Description
enabledProtocols

EnabledProtocols

Representar protocolos suportados

StreamingPolicy

Um recurso de Política de Transmissão em Fluxo

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

O nome do recurso
properties.commonEncryptionCbcs

CommonEncryptionCbcs

Configuração de CommonEncryptionCbcs
properties.commonEncryptionCenc

CommonEncryptionCenc

Configuração do CommonEncryptionCenc
properties.created

string

Hora de criação da Política de Transmissão em Fluxo
properties.defaultContentKeyPolicyName

string

ContentKey Predefinido utilizado pela Política de Transmissão em Fluxo atual
properties.envelopeEncryption

EnvelopeEncryption

Configuração de EnvelopeEncryption
properties.noEncryption

NoEncryption

Configurações de NoEncryption
systemData

systemData

Os metadados do sistema relacionados com este recurso.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

StreamingPolicyCollection

Uma coleção de itens StreamingPolicy.

Name Tipo Description
@odata.nextLink

string

Uma ligação para a página seguinte da coleção (quando a coleção contém demasiados resultados para devolver numa resposta).
value

StreamingPolicy[]

Uma coleção de itens StreamingPolicy.

StreamingPolicyContentKey

Classe para especificar propriedades da chave de conteúdo

Name Tipo Description
label

string

A etiqueta pode ser utilizada para especificar a Chave de Conteúdo ao criar um Localizador de Transmissão em Fluxo
policyName

string

Política utilizada pela Chave de Conteúdo
tracks

TrackSelection[]

Faixas que utilizam esta chave de conteúdo

StreamingPolicyContentKeys

Classe para especificar propriedades de todas as chaves de conteúdo na Política de Transmissão em Fluxo

Name Tipo Description
defaultKey

DefaultKey

Chave de conteúdo predefinida para um esquema de encriptação
keyToTrackMappings

StreamingPolicyContentKey[]

Representar faixas precisa de uma chave de conteúdo separada

StreamingPolicyFairPlayConfiguration

Classe para especificar configurações do FairPlay na Política de Transmissão em Fluxo

Name Tipo Description
allowPersistentLicense

boolean

Todas as licenças para serem persistentes ou não
customLicenseAcquisitionUrlTemplate

string

Modelo para o URL do serviço personalizado que fornece licenças aos leitores de utilizadores finais. Não é necessário ao utilizar os Serviços de Multimédia do Azure para emitir licenças. O modelo suporta tokens substituíveis que o serviço irá atualizar no runtime com o valor específico do pedido. Os valores de token atualmente suportados são {AlternativeMediaId}, que é substituído pelo valor de StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, que é substituído pelo valor do identificador da chave que está a ser pedida.

StreamingPolicyPlayReadyConfiguration

Classe para especificar configurações do PlayReady na Política de Transmissão em Fluxo

Name Tipo Description
customLicenseAcquisitionUrlTemplate

string

Modelo para o URL do serviço personalizado que fornece licenças aos utilizadores finais. Não é necessário ao utilizar os Serviços de Multimédia do Azure para emitir licenças. O modelo suporta tokens substituíveis que o serviço irá atualizar no runtime com o valor específico do pedido. Os valores de token atualmente suportados são {AlternativeMediaId}, que é substituído pelo valor de StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, que é substituído pelo valor do identificador da chave que está a ser pedida.
playReadyCustomAttributes

string

Atributos personalizados para PlayReady

StreamingPolicyWidevineConfiguration

Classe para especificar configurações do Widevine na Política de Transmissão em Fluxo

Name Tipo Description
customLicenseAcquisitionUrlTemplate

string

Modelo para o URL do serviço personalizado que fornece licenças aos utilizadores finais. Não é necessário ao utilizar os Serviços de Multimédia do Azure para emitir licenças. O modelo suporta tokens substituíveis que o serviço irá atualizar no runtime com o valor específico do pedido. Os valores de token atualmente suportados são {AlternativeMediaId}, que é substituído pelo valor de StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, que é substituído pelo valor do identificador da chave que está a ser pedida.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

TrackPropertyCompareOperation

Controlar a operação de condição de propriedade

Name Tipo Description
Equal

string

Operação de igual
Unknown

string

Operação de comparação de propriedades de registo desconhecida

TrackPropertyCondition

Classe para especificar uma condição de propriedade de faixa

Name Tipo Description
operation

TrackPropertyCompareOperation

Controlar a operação de condição de propriedade
property

TrackPropertyType

Controlar o tipo de propriedade
value

string

Controlar o valor da propriedade

TrackPropertyType

Controlar tipo de propriedade

Name Tipo Description
FourCC

string

Controlar FourCC
Unknown

string

Propriedade de faixa desconhecida

TrackSelection

Classe para selecionar uma faixa

Name Tipo Description
trackSelections

TrackPropertyCondition[]

TrackSelections é uma lista de condições de propriedade track que pode especificar faixa(s)