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
accountName
path True
  • string

Název Media Services účtu

resourceGroupName
path True
  • string

Název skupiny prostředků v rámci předplatného Azure.

streamingPolicyName
path True
  • string

Název zásady streamování.

subscriptionId
path True
  • string

Jedinečný identifikátor pro Microsoft Azure předplatného.

api-version
query True
  • string

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
  • string

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
Creates a Streaming Policy with commonEncryptionCbcs only
Creates a Streaming Policy with commonEncryptionCenc only
Creates a Streaming Policy with envelopeEncryption only
Creates a Streaming Policy with secure streaming

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

ApiError

Chyba rozhraní API.

CbcsDrmConfiguration

Třída pro určení konfigurací DRM schématu CommonEncryptionCbcs v zásadách streamování

CencDrmConfiguration

Třída pro určení konfigurací DRM schématu CommonEncryptionCenc v zásadách streamování

CommonEncryptionCbcs

Třída pro schéma šifrování CommonEncryptionCbcs

CommonEncryptionCenc

Třída pro schéma šifrování obálky

createdByType

Typ identity, která vytvořila prostředek.

DefaultKey

Třída pro určení vlastností výchozího klíče obsahu pro každé schéma šifrování

EnabledProtocols

Třída určující, které protokoly jsou povolené

EnvelopeEncryption

Třída pro schéma šifrování EnvelopeEncryption

NoEncryption

Třída pro schéma NoEncryption

ODataError

Informace o chybě

StreamingPolicy

Prostředek zásad streamování

StreamingPolicyContentKey

Třída pro určení vlastností klíče obsahu

StreamingPolicyContentKeys

Třída pro určení vlastností všech klíčů obsahu v zásadách streamování

StreamingPolicyFairPlayConfiguration

Třída pro určení konfigurací FairPlay v zásadě streamování

StreamingPolicyPlayReadyConfiguration

Třída pro určení konfigurací PlayReady v zásadách streamování

StreamingPolicyWidevineConfiguration

Třída pro určení konfigurace Widevine v zásadách streamování

systemData

Metadata týkající se vytvoření a poslední úpravy prostředku.

TrackPropertyCompareOperation

Operace sledování podmínky vlastnosti

TrackPropertyCondition

Třída, která určuje jednu podmínku vlastnosti sledování

TrackPropertyType

Sledovat typ vlastnosti

TrackSelection

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
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DefaultKey

Třída pro určení vlastností výchozího klíče obsahu pro každé schéma šifrování

Name Type Description
label
  • string

Popisek lze použít k určení klíče obsahu při vytváření lokátoru streamování.

policyName
  • string

Zásady používané ve výchozím klíči

EnabledProtocols

Třída určující, které protokoly jsou povolené

Name Type Description
dash
  • boolean

Povolení protokolu DASH nebo ne

download
  • boolean

Povolení protokolu stahování nebo ne

hls
  • boolean

Povolení protokolu HLS nebo ne

smoothStreaming
  • boolean

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
  • string

Š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
  • string

Název chyby nezávislý na jazyce.

details

Podrobnosti o chybě

message
  • string

Chybová zpráva

target
  • string

Cíl chyby (například název vlastnosti v chybě).

StreamingPolicy

Prostředek zásad streamování

Name Type Description
id
  • string

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
  • string

Název prostředku

properties.commonEncryptionCbcs

Konfigurace CommonEncryptionCbcs

properties.commonEncryptionCenc

Konfigurace CommonEncryptionCenc

properties.created
  • string

Čas vytvoření zásad streamování

properties.defaultContentKeyPolicyName
  • string

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
  • string

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
  • string

Popisek lze použít k určení klíče obsahu při vytváření lokátoru streamování.

policyName
  • string

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
  • boolean

Veškerá licence, která má být trvalá nebo ne

customLicenseAcquisitionUrlTemplate
  • string

Š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
  • string

Š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
  • string

Vlastní atributy pro PlayReady

StreamingPolicyWidevineConfiguration

Třída pro určení konfigurace Widevine v zásadách streamování

Name Type Description
customLicenseAcquisitionUrlTemplate
  • string

Š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
  • string

Časové razítko vytvoření prostředku (UTC).

createdBy
  • string

Identita, která vytvořila prostředek.

createdByType

Typ identity, která vytvořila prostředek.

lastModifiedAt
  • string

Časové razítko poslední úpravy prostředku (UTC)

lastModifiedBy
  • string

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
  • string

Rovná se operace

Unknown
  • string

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
  • string

Sledování hodnoty vlastnosti

TrackPropertyType

Sledovat typ vlastnosti

Name Type Description
FourCC
  • string

Sledovat FourCC

Unknown
  • string

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.