你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Streaming Policies - List
列出流式处理策略
Lists帐户中的流式处理策略
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 |
用于在流式处理策略中指定 CommonEncryptionCbcs 方案的 DRM 配置的类 |
Cenc |
用于在流式处理策略中指定 CommonEncryptionCenc 方案的 DRM 配置的类 |
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
用于在流式处理策略中指定 CommonEncryptionCbcs 方案的 DRM 配置的类
名称 | 类型 | 说明 |
---|---|---|
fairPlay |
FairPlay 配置 |
|
playReady |
PlayReady 配置 |
|
widevine |
Widevine 配置 |
CencDrmConfiguration
用于在流式处理策略中指定 CommonEncryptionCenc 方案的 DRM 配置的类
名称 | 类型 | 说明 |
---|---|---|
playReady |
PlayReady 配置 |
|
widevine |
Widevine 配置 |
ClearKeyEncryptionConfiguration
用于指定流式处理策略中常见加密方案的 ClearKey 配置的类
名称 | 类型 | 说明 |
---|---|---|
customKeysAcquisitionUrlTemplate |
string |
用于向最终用户玩家传送内容密钥的自定义服务的 URL 的模板。 使用 Azure 媒体服务颁发许可证时不需要。 该模板支持可替换的令牌,在运行时,服务将使用特定于请求的值更新这些令牌。 当前支持的令牌值为 {AlternativeMediaId},替换为 StreamingLocatorId.AlternativeMediaId 的值。 |
CommonEncryptionCbcs
CommonEncryptionCbcs 加密方案的类
名称 | 类型 | 说明 |
---|---|---|
clearKeyEncryptionConfiguration |
可选配置,支持 CommonEncryptionCbcs 加密方案中的 ClearKey。 |
|
clearTracks |
表示不应加密的轨迹 |
|
contentKeys |
表示每个加密方案的默认内容密钥,以及特定轨道的单独内容密钥 |
|
drm |
为当前加密方案配置 DRM |
|
enabledProtocols |
表示支持的协议 |
CommonEncryptionCenc
信封加密方案的类
名称 | 类型 | 说明 |
---|---|---|
clearKeyEncryptionConfiguration |
可选配置,支持 CommonEncryptionCenc 加密方案中的 ClearKey。 |
|
clearTracks |
表示不应加密的轨迹 |
|
contentKeys |
表示每个加密方案的默认内容密钥,以及特定轨道的单独内容密钥 |
|
drm |
为 CommonEncryptionCenc 加密方案配置 DRM |
|
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 |
是否启用平滑流式处理协议 |
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 |
错误对象。 |
NoEncryption
NoEncryption 方案的类
名称 | 类型 | 说明 |
---|---|---|
enabledProtocols |
表示支持的协议 |
StreamingPolicy
流式处理策略资源
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如 - /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
用于指定一个跟踪属性条件的类
名称 | 类型 | 说明 |
---|---|---|
operation |
跟踪属性条件操作 |
|
property |
Track 属性类型 |
|
value |
string |
跟踪属性值 |
TrackPropertyType
Track 属性类型
名称 | 类型 | 说明 |
---|---|---|
FourCC |
string |
Track FourCC |
Unknown |
string |
未知轨道属性 |
TrackSelection
用于选择轨道的类
名称 | 类型 | 说明 |
---|---|---|
trackSelections |
TrackSelections 是一个跟踪属性条件列表,可以指定跟踪 () |