Streaming Policies - Create

Skapa en direktuppspelningsprincip i Media Services konto

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}?api-version=2020-05-01

URI-parametrar

Name In Required Type Description
accountName
path True
  • string

Namnet Media Services konto.

resourceGroupName
path True
  • string

Namnet på resursgruppen i Azure-prenumerationen.

streamingPolicyName
path True
  • string

Namnet på strömningsprincipen.

subscriptionId
path True
  • string

Unik identifierare för en Microsoft Azure prenumeration.

api-version
query True
  • string

Den version av API:et som ska användas med klientbegäran.

Begärandetext

Name Type Description
properties.commonEncryptionCbcs

Konfiguration av CommonEncryptionCbcs

properties.commonEncryptionCenc

Konfiguration av CommonEncryptionCenc

properties.defaultContentKeyPolicyName
  • string

Standardinnehållsnyckel som används av den aktuella strömningsprincipen

properties.envelopeEncryption

Konfiguration av EnvelopeEncryption

properties.noEncryption

Konfigurationer av NoEncryption

Svar

Name Type Description
201 Created

Skapad

Other Status Codes

Detaljerad felinformation.

Exempel

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
        }
      }
    }
  }
}

Definitioner

ApiError

API-felet.

CbcsDrmConfiguration

Klass för att ange DRM-konfigurationer av CommonEncryptionCbcs-schemat i strömningsprincip

CencDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schemat i strömningsprincip

CommonEncryptionCbcs

Klass för CommonEncryptionCbcs-krypteringsschema

CommonEncryptionCenc

Klass för kuvertkrypteringsschema

createdByType

Den typ av identitet som skapade resursen.

DefaultKey

Klass för att ange egenskaper för standardinnehållsnyckeln för varje krypteringsschema

EnabledProtocols

Klass för att ange vilka protokoll som är aktiverade

EnvelopeEncryption

Klass för kryptografischemat EnvelopeEncryption

NoEncryption

Klass för NoEncryption-schema

ODataError

Information om ett fel.

StreamingPolicy

En resurs för direktuppspelningsprincip

StreamingPolicyContentKey

Klass för att ange egenskaper för innehållsnyckeln

StreamingPolicyContentKeys

Klass för att ange egenskaper för alla innehållsnycklar i strömningsprincip

StreamingPolicyFairPlayConfiguration

Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip

StreamingPolicyPlayReadyConfiguration

Klass för att ange konfigurationer av PlayReady i strömningsprincip

StreamingPolicyWidevineConfiguration

Klass för att ange konfigurationer av Widevine i strömningsprincip

systemData

Metadata som rör skapande och senaste ändring av resursen.

TrackPropertyCompareOperation

Spåra åtgärd för egenskapsvillkor

TrackPropertyCondition

Klass för att ange ett villkor för spåregenskap

TrackPropertyType

Spåra egenskapstyp

TrackSelection

Klass för att välja ett spår

ApiError

API-felet.

Name Type Description
error

Felegenskaperna.

CbcsDrmConfiguration

Klass för att ange DRM-konfigurationer av CommonEncryptionCbcs-schemat i strömningsprincip

Name Type Description
fairPlay

FairPlay-konfigurationer

playReady

PlayReady-konfigurationer

widevine

Widevine-konfigurationer

CencDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schemat i strömningsprincip

Name Type Description
playReady

PlayReady-konfigurationer

widevine

Widevine-konfigurationer

CommonEncryptionCbcs

Klass för CommonEncryptionCbcs-krypteringsschema

Name Type Description
clearTracks

Representerar vilka spår som inte ska krypteras

contentKeys

Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår

drm

Konfiguration av DRM:er för aktuellt krypteringsschema

enabledProtocols

Representerar protokoll som stöds

CommonEncryptionCenc

Klass för kuvertkrypteringsschema

Name Type Description
clearTracks

Representerar vilka spår som inte ska krypteras

contentKeys

Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår

drm

Konfiguration av DRM:er för CommonEncryptionCenc-krypteringsschema

enabledProtocols

Representerar protokoll som stöds

createdByType

Den typ av identitet som skapade resursen.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DefaultKey

Klass för att ange egenskaper för standardinnehållsnyckeln för varje krypteringsschema

Name Type Description
label
  • string

Etikett kan användas för att ange innehållsnyckel när du skapar en positionerare för direktuppspelning

policyName
  • string

Princip som används av standardnyckeln

EnabledProtocols

Klass för att ange vilka protokoll som är aktiverade

Name Type Description
dash
  • boolean

Aktivera DASH-protokollet eller inte

download
  • boolean

Aktivera hämtningsprotokoll eller inte

hls
  • boolean

Aktivera HLS-protokollet eller inte

smoothStreaming
  • boolean

Aktivera SmoothStreaming-protokollet eller inte

EnvelopeEncryption

Klass för kryptografischemat EnvelopeEncryption

Name Type Description
clearTracks

Representerar vilka spår som inte ska krypteras

contentKeys

Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår

customKeyAcquisitionUrlTemplate
  • string

Mall för URL:en för den anpassade tjänsten som levererar nycklar till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda nycklar. Mallen stöder utbytbara token som tjänsten uppdaterar vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet för StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

enabledProtocols

Representerar protokoll som stöds

NoEncryption

Klass för NoEncryption-schema

Name Type Description
enabledProtocols

Representerar protokoll som stöds

ODataError

Information om ett fel.

Name Type Description
code
  • string

Ett språkoberoende felnamn.

details

Felinformationen.

message
  • string

Felmeddelandet.

target
  • string

Målet för felet (till exempel namnet på egenskapen i fel).

StreamingPolicy

En resurs för direktuppspelningsprincip

Name Type Description
id
  • string

Fullständigt kvalificerat resurs-ID för resursen. Exempel : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Namnet på resursen

properties.commonEncryptionCbcs

Konfiguration av CommonEncryptionCbcs

properties.commonEncryptionCenc

Konfiguration av CommonEncryptionCenc

properties.created
  • string

Skapandetid för direktuppspelningsprincip

properties.defaultContentKeyPolicyName
  • string

Standardinnehållsnyckel som används av den aktuella strömningsprincipen

properties.envelopeEncryption

Konfiguration av EnvelopeEncryption

properties.noEncryption

Konfigurationer av NoEncryption

systemData

Systemmetadata som rör den här resursen.

type
  • string

Typen av resurs. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts"

StreamingPolicyContentKey

Klass för att ange egenskaper för innehållsnyckeln

Name Type Description
label
  • string

Etikett kan användas för att ange innehållsnyckel när du skapar en positionerare för direktuppspelning

policyName
  • string

Princip som används av innehållsnyckeln

tracks

Spårar som använder den här innehållsnyckeln

StreamingPolicyContentKeys

Klass för att ange egenskaper för alla innehållsnycklar i strömningsprincip

Name Type Description
defaultKey

Standardinnehållsnyckel för ett krypteringsschema

keyToTrackMappings

För att representera spår behöver du en separat innehållsnyckel

StreamingPolicyFairPlayConfiguration

Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip

Name Type Description
allowPersistentLicense
  • boolean

Alla licenser ska vara beständiga eller inte

customLicenseAcquisitionUrlTemplate
  • string

Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten uppdaterar vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet för StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

StreamingPolicyPlayReadyConfiguration

Klass för att ange konfigurationer av PlayReady i strömningsprincip

Name Type Description
customLicenseAcquisitionUrlTemplate
  • string

Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten uppdaterar vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet för StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

playReadyCustomAttributes
  • string

Anpassade attribut för PlayReady

StreamingPolicyWidevineConfiguration

Klass för att ange konfigurationer av Widevine i strömningsprincip

Name Type Description
customLicenseAcquisitionUrlTemplate
  • string

Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten uppdaterar vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet för StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Type Description
createdAt
  • string

Tidsstämpeln för resursskapande (UTC).

createdBy
  • string

Den identitet som skapade resursen.

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt
  • string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy
  • string

Den identitet som senast ändrade resursen.

lastModifiedByType

Den typ av identitet som senast ändrade resursen.

TrackPropertyCompareOperation

Spåra åtgärd för egenskapsvillkor

Name Type Description
Equal
  • string

Lika med-åtgärd

Unknown
  • string

Jämförelseåtgärd för okänd track-egenskap

TrackPropertyCondition

Klass för att ange ett villkor för spåregenskap

Name Type Description
operation

Spåra åtgärden för egenskapsvillkor

property

Spåra egenskapstyp

value
  • string

Spåra egenskapsvärde

TrackPropertyType

Spåra egenskapstyp

Name Type Description
FourCC
  • string

Spåra FourCC

Unknown
  • string

Okänd spåregenskap

TrackSelection

Klass för att välja ett spår

Name Type Description
trackSelections

TrackSelections är en villkorslista för spåregenskap som kan ange spår