Dela via

Streaming Policies - List

  • Referens
Tjänst:
Media Services
API-version:
2022-08-01

Lista direktuppspelningsprinciper
Listor strömningsprinciperna i kontot

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01
Med valfria parametrar: 
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-parametrar

Name I Obligatorisk Typ Description
accountName
 path True

string

Media Services-kontonamnet.
resourceGroupName
 path True

string

Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId
 path True

string

Den unika identifieraren för en Microsoft Azure-prenumeration.
api-version
 query True

string

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

string

Begränsar den uppsättning objekt som returneras.
$orderby
 query

string

Anger den nyckel som resultatsamlingen ska sorteras efter.
$top
 query

integer

int32

Anger ett icke-negativt heltal n som begränsar antalet objekt som returneras från en samling. Tjänsten returnerar antalet tillgängliga objekt upp till men inte större än det angivna värdet n.

Svar

Name Typ Description
200 OK

StreamingPolicyCollection

OK
Other Status Codes

ErrorResponse

Detaljerad felinformation.

Exempel

Lists Streaming Policies

Exempelbegäran

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies?api-version=2022-08-01

Exempelsvar

Statuskod:
200 
{
  "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"
}

Definitioner

Name Description
CbcsDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCbcs-schema i direktuppspelningsprincip
CencDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schema i direktuppspelningsprincip
ClearKeyEncryptionConfiguration

Klass för att ange ClearKey-konfiguration av vanliga krypteringsscheman i direktuppspelningsprincip
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 krypteringsschemat EnvelopeEncryption
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
NoEncryption

Klass för NoEncryption-schema
StreamingPolicy

En resurs för direktuppspelningsprincip
StreamingPolicyCollection

En samling StreamingPolicy-objekt.
StreamingPolicyContentKey

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

Klass för att ange egenskaper för alla innehållsnycklar i direktuppspelningsprincip
StreamingPolicyFairPlayConfiguration

Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip
StreamingPolicyPlayReadyConfiguration

Klass för att ange konfigurationer av PlayReady i direktuppspelningsprincip
StreamingPolicyWidevineConfiguration

Klass för att ange konfigurationer av Widevine i direktuppspelningsprincip
systemData

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

Spåra egenskapsvillkorsåtgärd
TrackPropertyCondition

Klass för att ange ett egenskapsvillkor för spår
TrackPropertyType

Spåra egenskapstyp
TrackSelection

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

CbcsDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCbcs-schema i direktuppspelningsprincip

Name Typ Description
fairPlay

StreamingPolicyFairPlayConfiguration

FairPlay-konfigurationer
playReady

StreamingPolicyPlayReadyConfiguration

PlayReady-konfigurationer
widevine

StreamingPolicyWidevineConfiguration

Widevine-konfigurationer

CencDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schema i direktuppspelningsprincip

Name Typ Description
playReady

StreamingPolicyPlayReadyConfiguration

PlayReady-konfigurationer
widevine

StreamingPolicyWidevineConfiguration

Widevine-konfigurationer

ClearKeyEncryptionConfiguration

Klass för att ange ClearKey-konfiguration av vanliga krypteringsscheman i direktuppspelningsprincip

Name Typ Description
customKeysAcquisitionUrlTemplate

string

Mall för URL:en för den anpassade tjänsten som levererar innehållsnycklar till slutanvändare. 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 kommer att uppdatera vid körning med det värde som är specifikt för begäran. Tokenvärdet som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId.

CommonEncryptionCbcs

Klass för CommonEncryptionCbcs-krypteringsschema

Name Typ Description
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Valfri konfiguration som stöder ClearKey i CommonEncryptionCbcs-krypteringsschema.
clearTracks

TrackSelection[]

Representerar vilka spår som inte ska krypteras
contentKeys

StreamingPolicyContentKeys

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

CbcsDrmConfiguration

Konfiguration av DRM:er för det aktuella krypteringsschemat
enabledProtocols

EnabledProtocols

Representera protokoll som stöds

CommonEncryptionCenc

Klass för kuvertkrypteringsschema

Name Typ Description
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Valfri konfiguration som stöder ClearKey i CommonEncryptionCenc-krypteringsschema.
clearTracks

TrackSelection[]

Representerar vilka spår som inte ska krypteras
contentKeys

StreamingPolicyContentKeys

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

CencDrmConfiguration

Konfiguration av DRM:er för CommonEncryptionCenc-krypteringsschema
enabledProtocols

EnabledProtocols

Representera protokoll som stöds

createdByType

Den typ av identitet som skapade resursen.

Name Typ 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 Typ Description
label

string

Etiketten 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 Typ Description
dash

boolean

Aktivera DASH-protokoll eller inte
download

boolean

Aktivera nedladdningsprotokollet eller inte
hls

boolean

Aktivera HLS-protokoll eller inte
smoothStreaming

boolean

Aktivera SmoothStreaming-protokollet eller inte

EnvelopeEncryption

Klass för krypteringsschemat EnvelopeEncryption

Name Typ Description
clearTracks

TrackSelection[]

Representerar vilka spår som inte ska krypteras
contentKeys

StreamingPolicyContentKeys

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ändare. 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 kommer att uppdatera vid körning med det värde som är specifikt för begäran. Tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.
enabledProtocols

EnabledProtocols

Representera protokoll som stöds

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Den ytterligare informationen.
type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

NoEncryption

Klass för NoEncryption-schema

Name Typ Description
enabledProtocols

EnabledProtocols

Representera protokoll som stöds

StreamingPolicy

En resurs för direktuppspelningsprincip

Name Typ 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

CommonEncryptionCbcs

Konfiguration av CommonEncryptionCbcs
properties.commonEncryptionCenc

CommonEncryptionCenc

Konfiguration av CommonEncryptionCenc
properties.created

string

Skapandetid för direktuppspelningsprincip
properties.defaultContentKeyPolicyName

string

Standard-ContentKey som används av aktuell direktuppspelningsprincip
properties.envelopeEncryption

EnvelopeEncryption

Konfiguration av EnvelopeEncryption
properties.noEncryption

NoEncryption

Konfigurationer av NoEncryption
systemData

systemData

Systemmetadata som är relaterade till den här resursen.
type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

StreamingPolicyCollection

En samling StreamingPolicy-objekt.

Name Typ Description
@odata.nextLink

string

En länk till nästa sida i samlingen (när samlingen innehåller för många resultat för att returnera i ett svar).
value

StreamingPolicy[]

En samling StreamingPolicy-objekt.

StreamingPolicyContentKey

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

Name Typ Description
label

string

Etiketten 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ållsnyckel
tracks

TrackSelection[]

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

StreamingPolicyContentKeys

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

Name Typ Description
defaultKey

DefaultKey

Standardinnehållsnyckel för ett krypteringsschema
keyToTrackMappings

StreamingPolicyContentKey[]

Det krävs en separat innehållsnyckel för att representera spår

StreamingPolicyFairPlayConfiguration

Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip

Name Typ 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 kommer att uppdatera 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 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 direktuppspelningsprincip

Name Typ 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 kommer att uppdatera vid körning med det värde som är specifikt för begäran. Tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet 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 direktuppspelningsprincip

Name Typ 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 kommer att uppdatera 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 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 Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).
createdBy

string

Identiteten som skapade resursen.
createdByType

createdByType

Den typ av identitet som skapade resursen.
lastModifiedAt

string

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

string

Identiteten som senast ändrade resursen.
lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

TrackPropertyCompareOperation

Spåra egenskapsvillkorsåtgärd

Name Typ Description
Equal

string

Lika med åtgärd
Unknown

string

Jämförelseåtgärd för okänd spårningsegenskap

TrackPropertyCondition

Klass för att ange ett egenskapsvillkor för spår

Name Typ Description
operation

TrackPropertyCompareOperation

Spåra egenskapsvillkorsåtgärd
property

TrackPropertyType

Spåra egenskapstyp
value

string

Spåra egenskapsvärde

TrackPropertyType

Spåra egenskapstyp

Name Typ Description
FourCC

string

Spåra FourCC
Unknown

string

Okänd spåregenskap

TrackSelection

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

Name Typ Description
trackSelections

TrackPropertyCondition[]

TrackSelections är en lista med villkor för spåregenskaper som kan ange spår