Streaming Policies - Create
Vytvoření zásady streamování v účtu Media Services streamování
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}?api-version=2020-05-01
Parametry identifikátoru URI
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
account
|
path | True |
|
Název Media Services účtu |
|
resource
|
path | True |
|
Název skupiny prostředků v rámci předplatného Azure. |
|
streaming
|
path | True |
|
Název zásady streamování. |
|
subscription
|
path | True |
|
Jedinečný identifikátor pro Microsoft Azure předplatného. |
|
api-version
|
query | True |
|
Verze rozhraní API, která se má použít s požadavkem klienta. |
Text požadavku
| Name | Type | Description |
|---|---|---|
| properties.commonEncryptionCbcs |
Konfigurace CommonEncryptionCbcs |
|
| properties.commonEncryptionCenc |
Konfigurace CommonEncryptionCenc |
|
| properties.defaultContentKeyPolicyName |
|
Výchozí klíč obsahu používaný aktuálními zásadami streamování |
| properties.envelopeEncryption |
Konfigurace obálkyŠifrování |
|
| properties.noEncryption |
Konfigurace NoEncryption |
Odpovědi
| Name | Type | Description |
|---|---|---|
| 201 Created |
Vytvořeno |
|
| Other Status Codes |
Podrobné informace o chybě. |
Příklady
Creates a Streaming Policy with clear streaming
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/UserCreatedClearStreamingPolicy?api-version=2020-05-01
{
"properties": {
"noEncryption": {
"enabledProtocols": {
"download": true,
"dash": true,
"hls": true,
"smoothStreaming": true
}
}
}
}
Sample Response
{
"name": "UserCreatedClearStreamingPolicy",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/UserCreatedClearStreamingPolicy",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:31.1535417Z",
"noEncryption": {
"enabledProtocols": {
"download": true,
"dash": true,
"hls": true,
"smoothStreaming": true
}
}
}
}
Creates a Streaming Policy with commonEncryptionCbcs only
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithCommonEncryptionCbcsOnly?api-version=2020-05-01
{
"properties": {
"defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
"commonEncryptionCbcs": {
"enabledProtocols": {
"download": false,
"dash": false,
"hls": true,
"smoothStreaming": false
},
"contentKeys": {
"defaultKey": {
"label": "cbcsDefaultKey"
}
},
"drm": {
"fairPlay": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
"allowPersistentLicense": true
}
}
}
}
}
Sample Response
{
"name": "UserCreatedSecureStreamingPolicyWithCommonEncryptionCbcsOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithCommonEncryptionCbcsOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:31.6197199Z",
"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
}
}
}
}
}
Creates a Streaming Policy with commonEncryptionCenc only
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithCommonEncryptionCencOnly?api-version=2020-05-01
{
"properties": {
"defaultContentKeyPolicyName": "PolicyWithPlayReadyOptionAndOpenRestriction",
"commonEncryptionCenc": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": false,
"smoothStreaming": true
},
"clearTracks": [
{
"trackSelections": [
{
"property": "FourCC",
"operation": "Equal",
"value": "hev1"
}
]
}
],
"contentKeys": {
"defaultKey": {
"label": "cencDefaultKey"
}
},
"drm": {
"playReady": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/playready/{ContentKeyId}",
"playReadyCustomAttributes": "PlayReady CustomAttributes"
},
"widevine": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/widevine/{ContentKeyId"
}
}
}
}
}
Sample Response
{
"name": "UserCreatedSecureStreamingPolicyWithCommonEncryptionCencOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithCommonEncryptionCencOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:31.4678543Z",
"defaultContentKeyPolicyName": "PolicyWithPlayReadyOptionAndOpenRestriction",
"commonEncryptionCenc": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": false,
"smoothStreaming": true
},
"clearTracks": [
{
"trackSelections": [
{
"property": "FourCC",
"operation": "Equal",
"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"
}
}
}
}
}
Creates a Streaming Policy with envelopeEncryption only
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithEnvelopeEncryptionOnly?api-version=2020-05-01
{
"properties": {
"defaultContentKeyPolicyName": "PolicyWithClearKeyOptionAndTokenRestriction",
"envelopeEncryption": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": true,
"smoothStreaming": true
},
"contentKeys": {
"defaultKey": {
"label": "aesDefaultKey"
}
},
"customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
}
}
}
Sample Response
{
"name": "UserCreatedSecureStreamingPolicyWithEnvelopeEncryptionOnly",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicyWithEnvelopeEncryptionOnly",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:31.3055712Z",
"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}"
}
}
}
Creates a Streaming Policy with secure streaming
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicy?api-version=2020-05-01
{
"properties": {
"defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
"envelopeEncryption": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": true,
"smoothStreaming": true
},
"contentKeys": {
"defaultKey": {
"label": "aesDefaultKey"
}
},
"customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
},
"commonEncryptionCenc": {
"enabledProtocols": {
"download": false,
"dash": true,
"hls": false,
"smoothStreaming": true
},
"clearTracks": [
{
"trackSelections": [
{
"property": "FourCC",
"operation": "Equal",
"value": "hev1"
}
]
}
],
"contentKeys": {
"defaultKey": {
"label": "cencDefaultKey"
}
},
"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
},
"contentKeys": {
"defaultKey": {
"label": "cbcsDefaultKey"
}
},
"drm": {
"fairPlay": {
"customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
"allowPersistentLicense": true
}
}
}
}
}
Sample Response
{
"name": "UserCreatedSecureStreamingPolicy",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/UserCreatedSecureStreamingPolicy",
"type": "Microsoft.Media/mediaservices/streamingPolicies",
"properties": {
"created": "2018-08-08T18:29:31.7715696Z",
"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": "Equal",
"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
}
}
}
}
}
Definice
|
Api |
Chyba rozhraní API. |
|
Cbcs |
Třída pro určení konfigurací DRM schématu CommonEncryptionCbcs v zásadách streamování |
|
Cenc |
Třída pro určení konfigurací DRM schématu CommonEncryptionCenc v zásadách streamování |
|
Common |
Třída pro schéma šifrování CommonEncryptionCbcs |
|
Common |
Třída pro schéma šifrování obálky |
|
created |
Typ identity, která vytvořila prostředek. |
|
Default |
Třída pro určení vlastností výchozího klíče obsahu pro každé schéma šifrování |
|
Enabled |
Třída určující, které protokoly jsou povolené |
|
Envelope |
Třída pro schéma šifrování EnvelopeEncryption |
|
No |
Třída pro schéma NoEncryption |
|
OData |
Informace o chybě |
|
Streaming |
Prostředek zásad streamování |
|
Streaming |
Třída pro určení vlastností klíče obsahu |
|
Streaming |
Třída pro určení vlastností všech klíčů obsahu v zásadách streamování |
|
Streaming |
Třída pro určení konfigurací FairPlay v zásadě streamování |
|
Streaming |
Třída pro určení konfigurací PlayReady v zásadách streamování |
|
Streaming |
Třída pro určení konfigurace Widevine v zásadách streamování |
|
system |
Metadata týkající se vytvoření a poslední úpravy prostředku. |
|
Track |
Operace sledování podmínky vlastnosti |
|
Track |
Třída, která určuje jednu podmínku vlastnosti sledování |
|
Track |
Sledovat typ vlastnosti |
|
Track |
Třída pro výběr stopy |
ApiError
Chyba rozhraní API.
| Name | Type | Description |
|---|---|---|
| error |
Vlastnosti chyby |
CbcsDrmConfiguration
Třída pro určení konfigurací DRM schématu CommonEncryptionCbcs v zásadách streamování
| Name | Type | Description |
|---|---|---|
| fairPlay |
Konfigurace FairPlay |
|
| playReady |
Konfigurace PlayReady |
|
| widevine |
Konfigurace Widevine |
CencDrmConfiguration
Třída pro určení konfigurací DRM schématu CommonEncryptionCenc v zásadách streamování
| Name | Type | Description |
|---|---|---|
| playReady |
Konfigurace PlayReady |
|
| widevine |
Konfigurace Widevine |
CommonEncryptionCbcs
Třída pro schéma šifrování CommonEncryptionCbcs
| Name | Type | Description |
|---|---|---|
| clearTracks |
Představuje, které stopy by neměly být šifrovány. |
|
| contentKeys |
Reprezentace výchozího klíče obsahu pro každé schéma šifrování a samostatné klíče obsahu pro konkrétní stopy |
|
| drm |
Konfigurace DRM pro aktuální schéma šifrování |
|
| enabledProtocols |
Reprezentace podporovaných protokolů |
CommonEncryptionCenc
Třída pro schéma šifrování obálky
| Name | Type | Description |
|---|---|---|
| clearTracks |
Představuje, které stopy by neměly být šifrovány. |
|
| contentKeys |
Reprezentace výchozího klíče obsahu pro každé schéma šifrování a samostatné klíče obsahu pro konkrétní stopy |
|
| drm |
Konfigurace DRM pro schéma šifrování CommonEncryptionCenc |
|
| enabledProtocols |
Reprezentace podporovaných protokolů |
createdByType
Typ identity, která vytvořila prostředek.
| Name | Type | Description |
|---|---|---|
| Application |
|
|
| Key |
|
|
| ManagedIdentity |
|
|
| User |
|
DefaultKey
Třída pro určení vlastností výchozího klíče obsahu pro každé schéma šifrování
| Name | Type | Description |
|---|---|---|
| label |
|
Popisek lze použít k určení klíče obsahu při vytváření lokátoru streamování. |
| policyName |
|
Zásady používané ve výchozím klíči |
EnabledProtocols
Třída určující, které protokoly jsou povolené
| Name | Type | Description |
|---|---|---|
| dash |
|
Povolení protokolu DASH nebo ne |
| download |
|
Povolení protokolu stahování nebo ne |
| hls |
|
Povolení protokolu HLS nebo ne |
| smoothStreaming |
|
Povolení protokolu SmoothStreaming nebo ne |
EnvelopeEncryption
Třída pro schéma šifrování EnvelopeEncryption
| Name | Type | Description |
|---|---|---|
| clearTracks |
Představuje, které stopy by neměly být šifrovány. |
|
| contentKeys |
Reprezentace výchozího klíče obsahu pro každé schéma šifrování a samostatné klíče obsahu pro konkrétní stopy |
|
| customKeyAcquisitionUrlTemplate |
|
Šablona pro adresu URL vlastní služby doručované klíče koncovým uživatelům Nevyžaduje se při použití Azure Media Services pro vydávání klíčů. Šablona podporuje nahraditelné tokeny, které bude služba aktualizovat za běhu s hodnotou specifickou pro požadavek. Aktuálně podporované hodnoty tokenu jsou {AlternativeMediaId}, které se nahradí hodnotou StreamingLocatorId.AlternativeMediaId a {ContentKeyId}, která se nahradí hodnotou identifikátoru požadovaného klíče. |
| enabledProtocols |
Reprezentace podporovaných protokolů |
NoEncryption
Třída pro schéma NoEncryption
| Name | Type | Description |
|---|---|---|
| enabledProtocols |
Reprezentace podporovaných protokolů |
ODataError
Informace o chybě
| Name | Type | Description |
|---|---|---|
| code |
|
Název chyby nezávislý na jazyce. |
| details |
Podrobnosti o chybě |
|
| message |
|
Chybová zpráva |
| target |
|
Cíl chyby (například název vlastnosti v chybě). |
StreamingPolicy
Prostředek zásad streamování
| Name | Type | Description |
|---|---|---|
| id |
|
Plně kvalifikované ID prostředku. Např. /subscriptions/{ID_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
| name |
|
Název prostředku |
| properties.commonEncryptionCbcs |
Konfigurace CommonEncryptionCbcs |
|
| properties.commonEncryptionCenc |
Konfigurace CommonEncryptionCenc |
|
| properties.created |
|
Čas vytvoření zásad streamování |
| properties.defaultContentKeyPolicyName |
|
Výchozí klíč obsahu používaný aktuálními zásadami streamování |
| properties.envelopeEncryption |
Konfigurace obálkyŠifrování |
|
| properties.noEncryption |
Konfigurace NoEncryption |
|
| systemData |
Systémová metadata týkající se tohoto prostředku. |
|
| type |
|
Typ prostředku. Například "Microsoft.Compute/virtualMachines" nebo "Microsoft. Storage/storageAccounts" |
StreamingPolicyContentKey
Třída pro určení vlastností klíče obsahu
| Name | Type | Description |
|---|---|---|
| label |
|
Popisek lze použít k určení klíče obsahu při vytváření lokátoru streamování. |
| policyName |
|
Zásady používané klíčem k obsahu |
| tracks |
Sleduje, které používají tento klíč obsahu. |
StreamingPolicyContentKeys
Třída pro určení vlastností všech klíčů obsahu v zásadách streamování
| Name | Type | Description |
|---|---|---|
| defaultKey |
Výchozí klíč obsahu pro schéma šifrování |
|
| keyToTrackMappings |
Reprezentace stop vyžaduje samostatný klíč obsahu |
StreamingPolicyFairPlayConfiguration
Třída pro určení konfigurací FairPlay v zásadě streamování
| Name | Type | Description |
|---|---|---|
| allowPersistentLicense |
|
Veškerá licence, která má být trvalá nebo ne |
| customLicenseAcquisitionUrlTemplate |
|
Šablona pro adresu URL vlastní služby, která doručuje licence pro přehrávače koncových uživatelů. nepožadováno při použití Azure Media Services k vystavování licencí. Šablona podporuje nahraditelné tokeny, které služba aktualizuje za běhu s hodnotou specifickou pro požadavek. Aktuálně podporované hodnoty tokenu jsou {AlternativeMediaId}, které se nahradí hodnotou StreamingLocatorId. AlternativeMediaId a {ContentKeyId}, která je nahrazena hodnotou identifikátoru požadovaného klíče. |
StreamingPolicyPlayReadyConfiguration
Třída pro určení konfigurací PlayReady v zásadách streamování
| Name | Type | Description |
|---|---|---|
| customLicenseAcquisitionUrlTemplate |
|
Šablona pro adresu URL vlastní služby, která dodává licence koncovým uživatelům Nevyžaduje se při Azure Media Services pro vydávání licencí. Šablona podporuje nahraditelné tokeny, které bude služba aktualizovat za běhu s hodnotou specifickou pro požadavek. Aktuálně podporované hodnoty tokenu jsou {AlternativeMediaId}, které se nahradí hodnotou StreamingLocatorId.AlternativeMediaId a {ContentKeyId}, která se nahradí hodnotou identifikátoru požadovaného klíče. |
| playReadyCustomAttributes |
|
Vlastní atributy pro PlayReady |
StreamingPolicyWidevineConfiguration
Třída pro určení konfigurace Widevine v zásadách streamování
| Name | Type | Description |
|---|---|---|
| customLicenseAcquisitionUrlTemplate |
|
Šablona pro adresu URL vlastní služby, která dodává licence koncovým uživatelům Nevyžaduje se při Azure Media Services pro vydávání licencí. Šablona podporuje nahraditelné tokeny, které bude služba aktualizovat za běhu s hodnotou specifickou pro požadavek. Aktuálně podporované hodnoty tokenu jsou {AlternativeMediaId}, které se nahradí hodnotou StreamingLocatorId. AlternativeMediaId a {ContentKeyId}, která je nahrazena hodnotou identifikátoru požadovaného klíče. |
systemData
Metadata týkající se vytvoření a poslední úpravy prostředku.
| Name | Type | Description |
|---|---|---|
| createdAt |
|
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
|
Identita, která vytvořila prostředek. |
| createdByType |
Typ identity, která vytvořila prostředek. |
|
| lastModifiedAt |
|
Časové razítko poslední úpravy prostředku (UTC) |
| lastModifiedBy |
|
Identita, která prostředek naposledy upravila. |
| lastModifiedByType |
Typ identity, která prostředek naposledy upravila. |
TrackPropertyCompareOperation
Operace sledování podmínky vlastnosti
| Name | Type | Description |
|---|---|---|
| Equal |
|
Rovná se operace |
| Unknown |
|
Neznámá operace Compare vlastnosti Track |
TrackPropertyCondition
Třída, která určuje jednu podmínku vlastnosti sledování
| Name | Type | Description |
|---|---|---|
| operation |
Sledování operace podmínky vlastnosti |
|
| property |
Sledování typu vlastnosti |
|
| value |
|
Sledování hodnoty vlastnosti |
TrackPropertyType
Sledovat typ vlastnosti
| Name | Type | Description |
|---|---|---|
| FourCC |
|
Sledovat FourCC |
| Unknown |
|
Neznámá vlastnost Track |
TrackSelection
Třída pro výběr stopy
| Name | Type | Description |
|---|---|---|
| trackSelections |
TrackSelections je seznam podmínek vlastností pro sledování, který může specifikovat stopy. |