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 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
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 的可用項目數目。 |
回應
名稱 | 類型 | Description |
---|---|---|
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"
}
定義
CbcsDrmConfiguration
類別,指定串流原則中 CommonEncryptionCbcs 配置的DRM組態
名稱 | 類型 | Description |
---|---|---|
fairPlay |
FairPlay 設定 |
|
playReady |
PlayReady 設定 |
|
widevine |
Widevine 組態 |
CencDrmConfiguration
類別,指定串流原則中 CommonEncryptionCenc 配置的DRM組態
名稱 | 類型 | Description |
---|---|---|
playReady |
PlayReady 設定 |
|
widevine |
Widevine 組態 |
ClearKeyEncryptionConfiguration
類別,指定串流原則中通用加密配置的 ClearKey 組態
名稱 | 類型 | Description |
---|---|---|
customKeysAcquisitionUrlTemplate |
string |
自訂服務的 URL 範本,將內容金鑰傳遞給使用者播放機。 使用 Azure 媒體服務發出授權時不需要。 此範本支援可更換的權杖,服務將在執行階段將權杖更新為要求的特定值。 目前支援的令牌值為 {AlternativeMediaId},其會取代為 StreamingLocatorId.AlternativeMediaId 的值。 |
CommonEncryptionCbcs
CommonEncryptionCbcs 加密配置的類別
名稱 | 類型 | Description |
---|---|---|
clearKeyEncryptionConfiguration |
在 CommonEncryptionCbcs 加密配置中支援 ClearKey 的選擇性設定。 |
|
clearTracks |
表示不應該加密哪些追蹤 |
|
contentKeys |
代表每個加密配置的預設內容密鑰,以及特定追蹤的不同內容金鑰 |
|
drm |
目前加密配置的DRM設定 |
|
enabledProtocols |
表示支援的通訊協定 |
CommonEncryptionCenc
信封加密配置的類別
名稱 | 類型 | Description |
---|---|---|
clearKeyEncryptionConfiguration |
在 CommonEncryptionCenc 加密配置中支援 ClearKey 的選擇性設定。 |
|
clearTracks |
表示不應該加密哪些追蹤 |
|
contentKeys |
代表每個加密配置的預設內容密鑰,以及特定追蹤的不同內容金鑰 |
|
drm |
CommonEncryptionCenc 加密配置的DRM設定 |
|
enabledProtocols |
表示支援的通訊協定 |
createdByType
建立資源的身分識別類型。
名稱 | 類型 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultKey
類別,指定每個加密配置的預設內容密鑰屬性
名稱 | 類型 | Description |
---|---|---|
label |
string |
建立串流定位器時,可以使用標籤來指定內容密鑰 |
policyName |
string |
預設金鑰所使用的原則 |
EnabledProtocols
類別,指定要啟用哪些通訊協定
名稱 | 類型 | Description |
---|---|---|
dash |
boolean |
啟用 DASH 通訊協定或未啟用 |
download |
boolean |
啟用下載通訊協定 |
hls |
boolean |
啟用 HLS 通訊協定或不啟用 |
smoothStreaming |
boolean |
啟用 SmoothStreaming 通訊協定或未啟用 |
EnvelopeEncryption
EnvelopeEncryption 加密配置的類別
名稱 | 類型 | Description |
---|---|---|
clearTracks |
表示不應該加密哪些追蹤 |
|
contentKeys |
代表每個加密配置的預設內容密鑰,以及特定追蹤的不同內容金鑰 |
|
customKeyAcquisitionUrlTemplate |
string |
自訂服務 URL 的範本,將金鑰傳遞給使用者播放機。 使用 Azure 媒體服務發出金鑰時不需要。 此範本支援可更換的權杖,服務將在執行階段將權杖更新為要求的特定值。 目前支援的令牌值為 {AlternativeMediaId},其會取代為 StreamingLocatorId.AlternativeMediaId 和 {ContentKeyId}的值,其會取代為所要求密鑰的標識符值。 |
enabledProtocols |
表示支援的通訊協定 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
NoEncryption
NoEncryption 配置的類別
名稱 | 類型 | Description |
---|---|---|
enabledProtocols |
表示支援的通訊協定 |
StreamingPolicy
串流原則資源
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源識別碼。 Ex - /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 |
Nocompression 的設定 |
|
systemData |
與此資源相關的系統元數據。 |
|
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
StreamingPolicyCollection
StreamingPolicy 專案的集合。
名稱 | 類型 | Description |
---|---|---|
@odata.nextLink |
string |
當集合包含太多結果,無法傳回一個回應) 時,集合 (下一頁的連結。 |
value |
StreamingPolicy 專案的集合。 |
StreamingPolicyContentKey
指定內容索引鍵屬性的類別
名稱 | 類型 | Description |
---|---|---|
label |
string |
建立串流定位器時,可以使用標籤來指定內容密鑰 |
policyName |
string |
內容金鑰使用的原則 |
tracks |
追蹤使用此內容金鑰的索引鍵 |
StreamingPolicyContentKeys
類別,指定串流原則中所有內容索引鍵的屬性
名稱 | 類型 | Description |
---|---|---|
defaultKey |
加密配置的預設內容金鑰 |
|
keyToTrackMappings |
代表曲目需要個別的內容密鑰 |
StreamingPolicyFairPlayConfiguration
在串流原則中指定 FairPlay 設定的類別
名稱 | 類型 | Description |
---|---|---|
allowPersistentLicense |
boolean |
所有要永續性的授權 |
customLicenseAcquisitionUrlTemplate |
string |
自訂服務的 URL 範本,會將授權傳遞給終端使用者播放程式。 使用 Azure 媒體服務來發行授權時不需要。 此範本支援可更換的權杖,服務將在執行階段將權杖更新為要求的特定值。 目前支援的令牌值為 {AlternativeMediaId},此值會取代為 StreamingLocatorId.AlternativeMediaId 和 {ContentKeyId}的值,此值會取代為所要求密鑰的標識符值。 |
StreamingPolicyPlayReadyConfiguration
類別,指定串流原則中 PlayReady 的組態
名稱 | 類型 | Description |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
自訂服務 URL 的範本,將授權傳遞給使用者播放機。 使用 Azure 媒體服務發出授權時不需要。 此範本支援可更換的權杖,服務將在執行階段將權杖更新為要求的特定值。 目前支援的令牌值為 {AlternativeMediaId},其會取代為 StreamingLocatorId.AlternativeMediaId 和 {ContentKeyId}的值,其會取代為所要求密鑰的標識符值。 |
playReadyCustomAttributes |
string |
PlayReady 的自定義屬性 |
StreamingPolicyWidevineConfiguration
類別,指定串流原則中的Widevine組態
名稱 | 類型 | Description |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
自訂服務 URL 的範本,將授權傳遞給使用者播放機。 使用 Azure 媒體服務發出授權時不需要。 此範本支援可更換的權杖,服務將在執行階段將權杖更新為要求的特定值。 目前支援的令牌值為 {AlternativeMediaId},此值會取代為 StreamingLocatorId.AlternativeMediaId 和 {ContentKeyId}的值,此值會取代為所要求密鑰的標識符值。 |
systemData
與建立和上次修改資源相關的元數據。
名稱 | 類型 | Description |
---|---|---|
createdAt |
string |
資源建立的時間戳 (UTC) 。 |
createdBy |
string |
建立資源的身分識別。 |
createdByType |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |
TrackPropertyCompareOperation
追蹤屬性條件作業
名稱 | 類型 | Description |
---|---|---|
Equal |
string |
相等運算 |
Unknown |
string |
未知的追蹤屬性比較作業 |
TrackPropertyCondition
指定一個追蹤屬性條件的類別
名稱 | 類型 | Description |
---|---|---|
operation |
追蹤屬性條件作業 |
|
property |
追蹤屬性類型 |
|
value |
string |
追蹤屬性值 |
TrackPropertyType
追蹤屬性類型
名稱 | 類型 | Description |
---|---|---|
FourCC |
string |
追蹤FourCC |
Unknown |
string |
未知的追蹤屬性 |
TrackSelection
要選取追蹤的類別
名稱 | 類型 | Description |
---|---|---|
trackSelections |
TrackSelections 是追蹤屬性條件清單,可指定追蹤 (s) |