Streaming Policies - List
Список политик потоковой передачи
Списки политик потоковой передачи в учетной записи
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}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
account
|
path | True |
string |
Имя учетной записи Служб мультимедиа. |
resource
|
path | True |
string |
Имя группы ресурсов в подписке Azure. |
subscription
|
path | True |
string |
Уникальный идентификатор подписки Microsoft Azure. |
api-version
|
query | True |
string |
Версия API, которая будет использоваться с клиентским запросом. |
$filter
|
query |
string |
Ограничивает набор возвращаемых элементов. |
|
$orderby
|
query |
string |
Указывает ключ, по которому должна быть упорядочена коллекция результатов. |
|
$top
|
query |
integer int32 |
Задает неотрицательное целое число n, которое ограничивает количество элементов, возвращаемых из коллекции. Служба возвращает количество доступных элементов, не превышающее указанное значение n. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК |
|
Other Status Codes |
Подробные сведения об ошибке. |
Примеры
Lists Streaming Policies
Образец запроса
Пример ответа
{
"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"
}
Определения
Имя | Описание |
---|---|
Cbcs |
Класс для указания конфигураций DRM схемы CommonEncryptionCbcs в политике потоковой передачи |
Cenc |
Класс для указания конфигураций DRM схемы CommonEncryptionCenc в политике потоковой передачи |
Clear |
Класс для указания конфигурации ClearKey общих схем шифрования в политике потоковой передачи |
Common |
Класс для схемы шифрования CommonEncryptionCbcs |
Common |
Класс для схемы шифрования конвертов |
created |
Тип удостоверения, создавшего ресурс. |
Default |
Класс для указания свойств ключа содержимого по умолчанию для каждой схемы шифрования |
Enabled |
Класс для указания включенных протоколов |
Envelope |
Класс для схемы шифрования EnvelopeEncryption |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
No |
Класс для схемы NoEncryption |
Streaming |
Ресурс политики потоковой передачи |
Streaming |
Коллекция элементов StreamingPolicy. |
Streaming |
Класс для указания свойств ключа содержимого |
Streaming |
Класс для указания свойств всех ключей содержимого в политике потоковой передачи |
Streaming |
Класс для указания конфигураций FairPlay в политике потоковой передачи |
Streaming |
Класс для указания конфигураций PlayReady в политике потоковой передачи |
Streaming |
Класс для указания конфигураций Widevine в политике потоковой передачи |
system |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
Track |
Отслеживание операции с условием свойства |
Track |
Класс для указания одного условия свойства track |
Track |
Отслеживание типа свойства |
Track |
Класс для выбора дорожки |
CbcsDrmConfiguration
Класс для указания конфигураций DRM схемы CommonEncryptionCbcs в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
fairPlay |
Конфигурации FairPlay |
|
playReady |
Конфигурации PlayReady |
|
widevine |
Конфигурации Widevine |
CencDrmConfiguration
Класс для указания конфигураций DRM схемы CommonEncryptionCenc в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
playReady |
Конфигурации PlayReady |
|
widevine |
Конфигурации Widevine |
ClearKeyEncryptionConfiguration
Класс для указания конфигурации ClearKey общих схем шифрования в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
customKeysAcquisitionUrlTemplate |
string |
Шаблон для URL-адреса пользовательской службы, предоставляющей ключи содержимого игрокам конечных пользователей. Не требуется при использовании Служб мультимедиа Azure для выдачи лицензий. Этот шаблон поддерживает заменяемые маркеры, которые служба будет обновлять во время выполнения, устанавливая значение, соответствующее запросу. Поддерживаемое в настоящее время значение маркера — {AlternativeMediaId}, которое заменяется значением StreamingLocatorId.AlternativeMediaId. |
CommonEncryptionCbcs
Класс для схемы шифрования CommonEncryptionCbcs
Имя | Тип | Описание |
---|---|---|
clearKeyEncryptionConfiguration |
Необязательная конфигурация, поддерживающая ClearKey в схеме шифрования CommonEncryptionCbcs. |
|
clearTracks |
Представление дорожек, которые не должны шифроваться |
|
contentKeys |
Представление ключа содержимого по умолчанию для каждой схемы шифрования и отдельных ключей содержимого для определенных дорожек |
|
drm |
Настройка DRM для текущей схемы шифрования |
|
enabledProtocols |
Представление поддерживаемых протоколов |
CommonEncryptionCenc
Класс для схемы шифрования конвертов
Имя | Тип | Описание |
---|---|---|
clearKeyEncryptionConfiguration |
Необязательная конфигурация, поддерживающая ClearKey в схеме шифрования CommonEncryptionCenc. |
|
clearTracks |
Представление дорожек, которые не должны шифроваться |
|
contentKeys |
Представление ключа содержимого по умолчанию для каждой схемы шифрования и отдельных ключей содержимого для определенных дорожек |
|
drm |
Настройка DRM для схемы шифрования CommonEncryptionCenc |
|
enabledProtocols |
Представление поддерживаемых протоколов |
createdByType
Тип удостоверения, создавшего ресурс.
Имя | Тип | Описание |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultKey
Класс для указания свойств ключа содержимого по умолчанию для каждой схемы шифрования
Имя | Тип | Описание |
---|---|---|
label |
string |
Метка может использоваться для указания ключа содержимого при создании указателя потоковой передачи |
policyName |
string |
Политика, используемая ключом по умолчанию |
EnabledProtocols
Класс для указания включенных протоколов
Имя | Тип | Описание |
---|---|---|
dash |
boolean |
Включить протокол DASH или нет |
download |
boolean |
Включить протокол скачивания или нет |
hls |
boolean |
Включить протокол HLS или нет |
smoothStreaming |
boolean |
Включить протокол SmoothStreaming или нет |
EnvelopeEncryption
Класс для схемы шифрования EnvelopeEncryption
Имя | Тип | Описание |
---|---|---|
clearTracks |
Представление дорожек, которые не должны шифроваться |
|
contentKeys |
Представление ключа содержимого по умолчанию для каждой схемы шифрования и отдельных ключей содержимого для определенных дорожек |
|
customKeyAcquisitionUrlTemplate |
string |
Шаблон для URL-адреса пользовательской службы, предоставляющей ключи игрокам конечных пользователей. Не требуется при использовании Служб мультимедиа Azure для выдачи ключей. Этот шаблон поддерживает заменяемые маркеры, которые служба будет обновлять во время выполнения, устанавливая значение, соответствующее запросу. В настоящее время поддерживаются значения маркера {AlternativeMediaId}, который заменяется значением StreamingLocatorId.AlternativeMediaId, и {ContentKeyId}, который заменяется значением идентификатора запрашиваемого ключа. |
enabledProtocols |
Представление поддерживаемых протоколов |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |
NoEncryption
Класс для схемы NoEncryption
Имя | Тип | Описание |
---|---|---|
enabledProtocols |
Представление поддерживаемых протоколов |
StreamingPolicy
Ресурс политики потоковой передачи
Имя | Тип | Описание |
---|---|---|
id |
string |
Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Имя ресурса. |
properties.commonEncryptionCbcs |
Конфигурация CommonEncryptionCbcs |
|
properties.commonEncryptionCenc |
Конфигурация CommonEncryptionCenc |
|
properties.created |
string |
Время создания политики потоковой передачи |
properties.defaultContentKeyPolicyName |
string |
ContentKey, который по умолчанию используется текущей потоковой политикой |
properties.envelopeEncryption |
Конфигурация EnvelopeEncryption |
|
properties.noEncryption |
Конфигурации NoEncryption |
|
systemData |
Системные метаданные, относящиеся к этому ресурсу. |
|
type |
string |
Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts. |
StreamingPolicyCollection
Коллекция элементов StreamingPolicy.
Имя | Тип | Описание |
---|---|---|
@odata.nextLink |
string |
Ссылка на следующую страницу коллекции (если коллекция содержит слишком много результатов для возврата в одном ответе). |
value |
Коллекция элементов StreamingPolicy. |
StreamingPolicyContentKey
Класс для указания свойств ключа содержимого
Имя | Тип | Описание |
---|---|---|
label |
string |
Метка может использоваться для указания ключа содержимого при создании указателя потоковой передачи |
policyName |
string |
Политика, используемая ключом содержимого |
tracks |
Отслеживает, в которых используется этот ключ содержимого |
StreamingPolicyContentKeys
Класс для указания свойств всех ключей содержимого в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
defaultKey |
Ключ содержимого по умолчанию для схемы шифрования |
|
keyToTrackMappings |
Для представления дорожек требуется отдельный ключ содержимого |
StreamingPolicyFairPlayConfiguration
Класс для указания конфигураций FairPlay в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
allowPersistentLicense |
boolean |
Все лицензии должны быть постоянными или нет |
customLicenseAcquisitionUrlTemplate |
string |
Шаблон для URL-адреса пользовательской службы, предоставляющей лицензии игрокам конечных пользователей. Не требуется при использовании Служб мультимедиа Azure для выдачи лицензий. Этот шаблон поддерживает заменяемые маркеры, которые служба будет обновлять во время выполнения, устанавливая значение, соответствующее запросу. В настоящее время поддерживаются значения маркера {AlternativeMediaId}, который заменяется значением StreamingLocatorId.AlternativeMediaId, и {ContentKeyId}, который заменяется значением идентификатора запрашиваемого ключа. |
StreamingPolicyPlayReadyConfiguration
Класс для указания конфигураций PlayReady в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Шаблон для URL-адреса пользовательской службы, предоставляющей лицензии игрокам конечных пользователей. Не требуется при использовании Служб мультимедиа Azure для выдачи лицензий. Этот шаблон поддерживает заменяемые маркеры, которые служба будет обновлять во время выполнения, устанавливая значение, соответствующее запросу. В настоящее время поддерживаются значения маркера {AlternativeMediaId}, который заменяется значением StreamingLocatorId.AlternativeMediaId, и {ContentKeyId}, который заменяется значением идентификатора запрашиваемого ключа. |
playReadyCustomAttributes |
string |
Настраиваемые атрибуты для PlayReady |
StreamingPolicyWidevineConfiguration
Класс для указания конфигураций Widevine в политике потоковой передачи
Имя | Тип | Описание |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Шаблон для URL-адреса пользовательской службы, предоставляющей лицензии игрокам конечных пользователей. Не требуется при использовании Служб мультимедиа Azure для выдачи лицензий. Этот шаблон поддерживает заменяемые маркеры, которые служба будет обновлять во время выполнения, устанавливая значение, соответствующее запросу. В настоящее время поддерживаются значения маркера {AlternativeMediaId}, который заменяется значением StreamingLocatorId.AlternativeMediaId, и {ContentKeyId}, который заменяется значением идентификатора запрашиваемого ключа. |
systemData
Метаданные, относящиеся к созданию и последнему изменению ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Удостоверение, которое последним изменял ресурс. |
lastModifiedByType |
Тип удостоверения, которое последним изменял ресурс. |
TrackPropertyCompareOperation
Отслеживание операции с условием свойства
Имя | Тип | Описание |
---|---|---|
Equal |
string |
Операция равенства |
Unknown |
string |
Операция сравнения свойств неизвестной трассы |
TrackPropertyCondition
Класс для указания одного условия свойства track
Имя | Тип | Описание |
---|---|---|
operation |
Отслеживание операции с условием свойства |
|
property |
Отслеживание типа свойства |
|
value |
string |
Отслеживание значения свойства |
TrackPropertyType
Отслеживание типа свойства
Имя | Тип | Описание |
---|---|---|
FourCC |
string |
Отслеживание FourCC |
Unknown |
string |
Неизвестное свойство track |
TrackSelection
Класс для выбора дорожки
Имя | Тип | Описание |
---|---|---|
trackSelections |
TrackSelections — это список условий свойств отслеживания, который может указывать дорожки |