Freigeben über


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

string

Der Name des Media Services-Kontos.

resourceGroupName
path True

string

Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.

subscriptionId
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

StreamingPolicyCollection

OK

Other Status Codes

ErrorResponse

Detaillierte Fehlerinformationen.

Beispiele

Lists Streaming Policies

Beispielanforderung

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

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
CbcsDrmConfiguration

Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCbcs-Schemas in der Streamingrichtlinie

CencDrmConfiguration

Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCenc-Schemas in der Streamingrichtlinie

ClearKeyEncryptionConfiguration

Klasse zum Angeben der ClearKey-Konfiguration allgemeiner Verschlüsselungsschemas in der Streamingrichtlinie

CommonEncryptionCbcs

Klasse für commonEncryptionCbcs-Verschlüsselungsschema

CommonEncryptionCenc

Klasse für das Verschlüsselungsschema für Umschläge

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DefaultKey

Klasse zum Angeben der Eigenschaften des Standardinhaltsschlüssels für jedes Verschlüsselungsschema

EnabledProtocols

Klasse zum Angeben der aktivierten Protokolle

EnvelopeEncryption

Klasse für EnvelopeEncryption-Verschlüsselungsschema

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

NoEncryption

Klasse für NoEncryption-Schema

StreamingPolicy

Eine Streamingrichtlinienressource

StreamingPolicyCollection

Eine Auflistung von StreamingPolicy-Elementen.

StreamingPolicyContentKey

Klasse zum Angeben von Eigenschaften des Inhaltsschlüssels

StreamingPolicyContentKeys

Klasse zum Angeben der Eigenschaften aller Inhaltsschlüssel in der Streamingrichtlinie

StreamingPolicyFairPlayConfiguration

Klasse zum Angeben von FairPlay-Konfigurationen in der Streamingrichtlinie

StreamingPolicyPlayReadyConfiguration

Klasse zum Angeben von Konfigurationen von PlayReady in der Streamingrichtlinie

StreamingPolicyWidevineConfiguration

Klasse zum Angeben von Konfigurationen von Widevine in der Streamingrichtlinie

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

TrackPropertyCompareOperation

Zustandsvorgang der Eigenschaft nachverfolgen

TrackPropertyCondition

Klasse zum Angeben einer Trackeigenschaftsbedingung

TrackPropertyType

Eigenschaftentyp nachverfolgen

TrackSelection

Klasse zum Auswählen eines Titels

CbcsDrmConfiguration

Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCbcs-Schemas in der Streamingrichtlinie

Name Typ Beschreibung
fairPlay

StreamingPolicyFairPlayConfiguration

FairPlay-Konfigurationen

playReady

StreamingPolicyPlayReadyConfiguration

PlayReady-Konfigurationen

widevine

StreamingPolicyWidevineConfiguration

Widevine-Konfigurationen

CencDrmConfiguration

Klasse zum Angeben von DRM-Konfigurationen des CommonEncryptionCenc-Schemas in der Streamingrichtlinie

Name Typ Beschreibung
playReady

StreamingPolicyPlayReadyConfiguration

PlayReady-Konfigurationen

widevine

StreamingPolicyWidevineConfiguration

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

ClearKeyEncryptionConfiguration

Optionale Konfiguration, die ClearKey im CommonEncryptionCbcs-Verschlüsselungsschema unterstützt.

clearTracks

TrackSelection[]

Stellt dar, welche Spuren nicht verschlüsselt werden sollen

contentKeys

StreamingPolicyContentKeys

Darstellen des Standardinhaltsschlüssels für jedes Verschlüsselungsschema und separate Inhaltsschlüssel für bestimmte Titel

drm

CbcsDrmConfiguration

Konfiguration von DRMs für das aktuelle Verschlüsselungsschema

enabledProtocols

EnabledProtocols

Darstellen unterstützter Protokolle

CommonEncryptionCenc

Klasse für das Verschlüsselungsschema für Umschläge

Name Typ Beschreibung
clearKeyEncryptionConfiguration

ClearKeyEncryptionConfiguration

Optionale Konfiguration, die ClearKey im CommonEncryptionCenc-Verschlüsselungsschema unterstützt.

clearTracks

TrackSelection[]

Stellt dar, welche Spuren nicht verschlüsselt werden sollen

contentKeys

StreamingPolicyContentKeys

Darstellen des Standardinhaltsschlüssels für jedes Verschlüsselungsschema und separate Inhaltsschlüssel für bestimmte Titel

drm

CencDrmConfiguration

Konfiguration von DRMs für das CommonEncryptionCenc-Verschlüsselungsschema

enabledProtocols

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

TrackSelection[]

Stellt dar, welche Spuren nicht verschlüsselt werden sollen

contentKeys

StreamingPolicyContentKeys

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

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

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

NoEncryption

Klasse für NoEncryption-Schema

Name Typ Beschreibung
enabledProtocols

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

CommonEncryptionCbcs

Konfiguration von CommonEncryptionCbcs

properties.commonEncryptionCenc

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

EnvelopeEncryption

Konfiguration von EnvelopeEncryption

properties.noEncryption

NoEncryption

Konfiguration von NoEncryption

systemData

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

StreamingPolicy[]

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

TrackSelection[]

Nachverfolgen, die diesen Inhaltsschlüssel verwenden

StreamingPolicyContentKeys

Klasse zum Angeben der Eigenschaften aller Inhaltsschlüssel in der Streamingrichtlinie

Name Typ Beschreibung
defaultKey

DefaultKey

Standardinhaltsschlüssel für ein Verschlüsselungsschema

keyToTrackMappings

StreamingPolicyContentKey[]

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

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

createdByType

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

TrackPropertyCompareOperation

Nachverfolgen des Bedingungsvorgangs der Eigenschaft

property

TrackPropertyType

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

TrackPropertyCondition[]

TrackSelections ist eine Liste der Track-Eigenschaftenbedingungen, die Die Spur(n) angeben kann.