Streaming Policies - List
Auflisten von Streamingrichtlinien
Listen der Streamingrichtlinien im Konto
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-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Media Services-Kontos. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe innerhalb des Azure-Abonnements. |
subscription
|
path | True |
string |
Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement. |
api-version
|
query | True |
string |
Die Version der API, die mit der Clientanforderung verwendet werden soll. |
$filter
|
query |
string |
Schränkt den Satz der zurückgegebenen Elemente ein. |
|
$orderby
|
query |
string |
Gibt den Schlüssel an, nach dem die Ergebnisauflistung sortiert werden soll. |
|
$top
|
query |
integer int32 |
Gibt eine nicht negative ganze Zahl n an, die die Anzahl der aus einer Auflistung zurückgegebenen Elemente begrenzt. Der Dienst gibt die Anzahl der verfügbaren Elemente bis zu zurück, aber nicht größer als der angegebene Wert n. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Detaillierte Fehlerinformationen. |
Beispiele
Lists Streaming Policies
Beispielanforderung
Beispiel für eine Antwort
{
"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"
}
Definitionen
Name | Beschreibung |
---|---|
Cbcs |
Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCbcs-Schemas in der Streamingrichtlinie |
Cenc |
Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCenc-Schemas in der Streamingrichtlinie |
Clear |
Klasse zum Angeben der ClearKey-Konfiguration allgemeiner Verschlüsselungsschemas in der Streamingrichtlinie |
Common |
Klasse für commonEncryptionCbcs-Verschlüsselungsschema |
Common |
Klasse für das Verschlüsselungsschema für Umschläge |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Default |
Klasse zum Angeben der Eigenschaften des Standardinhaltsschlüssels für jedes Verschlüsselungsschema |
Enabled |
Klasse zum Angeben der aktivierten Protokolle |
Envelope |
Klasse für EnvelopeEncryption-Verschlüsselungsschema |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
No |
Klasse für NoEncryption-Schema |
Streaming |
Eine Streamingrichtlinienressource |
Streaming |
Eine Auflistung von StreamingPolicy-Elementen. |
Streaming |
Klasse zum Angeben von Eigenschaften des Inhaltsschlüssels |
Streaming |
Klasse zum Angeben der Eigenschaften aller Inhaltsschlüssel in der Streamingrichtlinie |
Streaming |
Klasse zum Angeben von FairPlay-Konfigurationen in der Streamingrichtlinie |
Streaming |
Klasse zum Angeben von Konfigurationen von PlayReady in der Streamingrichtlinie |
Streaming |
Klasse zum Angeben von Konfigurationen von Widevine in der Streamingrichtlinie |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Track |
Zustandsvorgang der Eigenschaft nachverfolgen |
Track |
Klasse zum Angeben einer Trackeigenschaftsbedingung |
Track |
Eigenschaftentyp nachverfolgen |
Track |
Klasse zum Auswählen eines Titels |
CbcsDrmConfiguration
Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCbcs-Schemas in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
fairPlay |
FairPlay-Konfigurationen |
|
playReady |
PlayReady-Konfigurationen |
|
widevine |
Widevine-Konfigurationen |
CencDrmConfiguration
Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCenc-Schemas in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
playReady |
PlayReady-Konfigurationen |
|
widevine |
Widevine-Konfigurationen |
ClearKeyEncryptionConfiguration
Klasse zum Angeben der ClearKey-Konfiguration allgemeiner Verschlüsselungsschemas in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
customKeysAcquisitionUrlTemplate |
string |
Vorlage für die URL des benutzerdefinierten Diensts, der Inhaltsschlüssel für Endbenutzer-Spieler bereitstellt. Diese ist nicht erforderlich, wenn Sie Azure Media Services für das Ausstellen von Lizenzen verwenden. Die Vorlage unterstützt ersetzbare Token, die der Dienst zur Laufzeit mit dem Wert für die Anforderung aktualisiert. Der derzeit unterstützte Tokenwert ist {AlternativeMediaId}, der durch den Wert streamingLocatorId.AlternativeMediaId ersetzt wird. |
CommonEncryptionCbcs
Klasse für commonEncryptionCbcs-Verschlüsselungsschema
Name | Typ | Beschreibung |
---|---|---|
clearKeyEncryptionConfiguration |
Optionale Konfiguration, die ClearKey im CommonEncryptionCbcs-Verschlüsselungsschema unterstützt. |
|
clearTracks |
Stellt dar, welche Spuren nicht verschlüsselt werden sollen |
|
contentKeys |
Darstellen des Standardinhaltsschlüssels für jedes Verschlüsselungsschema und separate Inhaltsschlüssel für bestimmte Titel |
|
drm |
Konfiguration von DRMs für das aktuelle Verschlüsselungsschema |
|
enabledProtocols |
Darstellen unterstützter Protokolle |
CommonEncryptionCenc
Klasse für das Verschlüsselungsschema für Umschläge
Name | Typ | Beschreibung |
---|---|---|
clearKeyEncryptionConfiguration |
Optionale Konfiguration, die ClearKey im CommonEncryptionCenc-Verschlüsselungsschema unterstützt. |
|
clearTracks |
Stellt dar, welche Spuren nicht verschlüsselt werden sollen |
|
contentKeys |
Darstellen des Standardinhaltsschlüssels für jedes Verschlüsselungsschema und separate Inhaltsschlüssel für bestimmte Titel |
|
drm |
Konfiguration von DRMs für das CommonEncryptionCenc-Verschlüsselungsschema |
|
enabledProtocols |
Darstellen unterstützter Protokolle |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultKey
Klasse zum Angeben der Eigenschaften des Standardinhaltsschlüssels für jedes Verschlüsselungsschema
Name | Typ | Beschreibung |
---|---|---|
label |
string |
Bezeichnung kann verwendet werden, um den Inhaltsschlüssel beim Erstellen eines Streaminglocators anzugeben. |
policyName |
string |
Vom Standardschlüssel verwendete Richtlinie |
EnabledProtocols
Klasse zum Angeben der aktivierten Protokolle
Name | Typ | Beschreibung |
---|---|---|
dash |
boolean |
Aktivieren des DASH-Protokolls |
download |
boolean |
Aktivieren des Downloadprotokolls oder nicht |
hls |
boolean |
HlS-Protokoll aktivieren oder nicht |
smoothStreaming |
boolean |
Aktivieren des SmoothStreaming-Protokolls oder nicht |
EnvelopeEncryption
Klasse für EnvelopeEncryption-Verschlüsselungsschema
Name | Typ | Beschreibung |
---|---|---|
clearTracks |
Stellt dar, welche Spuren nicht verschlüsselt werden sollen |
|
contentKeys |
Darstellen des Standardinhaltsschlüssels für jedes Verschlüsselungsschema und separate Inhaltsschlüssel für bestimmte Titel |
|
customKeyAcquisitionUrlTemplate |
string |
Vorlage für die URL des benutzerdefinierten Diensts, der Schlüssel für Endbenutzer-Spieler bereitstellt. Diese ist nicht erforderlich, wenn Sie Azure Media Services für das Ausstellen von Schlüsseln verwenden. Die Vorlage unterstützt ersetzbare Token, die der Dienst zur Laufzeit mit dem Wert für die Anforderung aktualisiert. Die derzeit unterstützten Werte für Token sind {AlternativeMediaId} (wird durch den Wert von StreamingLocatorId.AlternativeMediaId ersetzt) und {ContentKeyId} (wird durch den Wert des Bezeichners des angeforderten Schlüssels ersetzt). |
enabledProtocols |
Darstellen unterstützter Protokolle |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
NoEncryption
Klasse für NoEncryption-Schema
Name | Typ | Beschreibung |
---|---|---|
enabledProtocols |
Darstellen unterstützter Protokolle |
StreamingPolicy
Eine Streamingrichtlinienressource
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties.commonEncryptionCbcs |
Konfiguration von CommonEncryptionCbcs |
|
properties.commonEncryptionCenc |
Konfiguration von CommonEncryptionCenc |
|
properties.created |
string |
Zeitpunkt der Erstellung der Streamingrichtlinie |
properties.defaultContentKeyPolicyName |
string |
Standardmäßiger ContentKey, der von der aktuellen Streamingrichtlinie verwendet wird. |
properties.envelopeEncryption |
Konfiguration von EnvelopeEncryption |
|
properties.noEncryption |
Konfiguration von NoEncryption |
|
systemData |
Die Systemmetadaten, die sich auf diese Ressource beziehen. |
|
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
StreamingPolicyCollection
Eine Auflistung von StreamingPolicy-Elementen.
Name | Typ | Beschreibung |
---|---|---|
@odata.nextLink |
string |
Ein Link zur nächsten Seite der Auflistung (wenn die Auflistung zu viele Ergebnisse enthält, um in einer Antwort zurückgegeben zu werden). |
value |
Eine Auflistung von StreamingPolicy-Elementen. |
StreamingPolicyContentKey
Klasse zum Angeben von Eigenschaften des Inhaltsschlüssels
Name | Typ | Beschreibung |
---|---|---|
label |
string |
Bezeichnung kann verwendet werden, um den Inhaltsschlüssel beim Erstellen eines Streaminglocators anzugeben. |
policyName |
string |
Vom Inhaltsschlüssel verwendete Richtlinie |
tracks |
Nachverfolgen, die diesen Inhaltsschlüssel verwenden |
StreamingPolicyContentKeys
Klasse zum Angeben der Eigenschaften aller Inhaltsschlüssel in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
defaultKey |
Standardinhaltsschlüssel für ein Verschlüsselungsschema |
|
keyToTrackMappings |
Für die Darstellung von Spuren ist ein separater Inhaltsschlüssel erforderlich. |
StreamingPolicyFairPlayConfiguration
Klasse zum Angeben von FairPlay-Konfigurationen in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
allowPersistentLicense |
boolean |
Alle Lizenzen, die dauerhaft sein sollen oder nicht |
customLicenseAcquisitionUrlTemplate |
string |
Vorlage für die URL des benutzerdefinierten Diensts, der Lizenzen für Endbenutzerplayer bereitstellt. Diese ist nicht erforderlich, wenn Sie Azure Media Services für das Ausstellen von Lizenzen verwenden. Die Vorlage unterstützt ersetzbare Token, die der Dienst zur Laufzeit mit dem Wert für die Anforderung aktualisiert. Die derzeit unterstützten Werte für Token sind {AlternativeMediaId} (wird durch den Wert von StreamingLocatorId.AlternativeMediaId ersetzt) und {ContentKeyId} (wird durch den Wert des Bezeichners des angeforderten Schlüssels ersetzt). |
StreamingPolicyPlayReadyConfiguration
Klasse zum Angeben von Konfigurationen von PlayReady in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Vorlage für die URL des benutzerdefinierten Diensts, der Lizenzen für Endbenutzer-Spieler bereitstellt. Diese ist nicht erforderlich, wenn Sie Azure Media Services für das Ausstellen von Lizenzen verwenden. Die Vorlage unterstützt ersetzbare Token, die der Dienst zur Laufzeit mit dem Wert für die Anforderung aktualisiert. Die derzeit unterstützten Werte für Token sind {AlternativeMediaId} (wird durch den Wert von StreamingLocatorId.AlternativeMediaId ersetzt) und {ContentKeyId} (wird durch den Wert des Bezeichners des angeforderten Schlüssels ersetzt). |
playReadyCustomAttributes |
string |
Benutzerdefinierte Attribute für PlayReady |
StreamingPolicyWidevineConfiguration
Klasse zum Angeben von Konfigurationen von Widevine in der Streamingrichtlinie
Name | Typ | Beschreibung |
---|---|---|
customLicenseAcquisitionUrlTemplate |
string |
Vorlage für die URL des benutzerdefinierten Diensts, der Lizenzen für Endbenutzer-Spieler bereitstellt. Diese ist nicht erforderlich, wenn Sie Azure Media Services für das Ausstellen von Lizenzen verwenden. Die Vorlage unterstützt ersetzbare Token, die der Dienst zur Laufzeit mit dem Wert für die Anforderung aktualisiert. Die derzeit unterstützten Werte für Token sind {AlternativeMediaId} (wird durch den Wert von StreamingLocatorId.AlternativeMediaId ersetzt) und {ContentKeyId} (wird durch den Wert des Bezeichners des angeforderten Schlüssels ersetzt). |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
TrackPropertyCompareOperation
Zustandsvorgang der Eigenschaft nachverfolgen
Name | Typ | Beschreibung |
---|---|---|
Equal |
string |
Gleicher Vorgang |
Unknown |
string |
Vergleichsvorgang für unbekannte Spureigenschaften |
TrackPropertyCondition
Klasse zum Angeben einer Trackeigenschaftsbedingung
Name | Typ | Beschreibung |
---|---|---|
operation |
Nachverfolgen des Bedingungsvorgangs der Eigenschaft |
|
property |
Track-Eigenschaftstyp |
|
value |
string |
Nachverfolgen des Eigenschaftswerts |
TrackPropertyType
Eigenschaftentyp nachverfolgen
Name | Typ | Beschreibung |
---|---|---|
FourCC |
string |
Track FourCC |
Unknown |
string |
Unbekannte Spureigenschaft |
TrackSelection
Klasse zum Auswählen eines Titels
Name | Typ | Beschreibung |
---|---|---|
trackSelections |
TrackSelections ist eine Liste der Track-Eigenschaftenbedingungen, die Die Spur(n) angeben kann. |