Content Key Policies - Get
Abrufen einer Inhaltsschlüsselrichtlinie
Abrufen der Details einer Inhaltsschlüsselrichtlinie im Media Services-Konto
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Media Services-Kontos. |
content
|
path | True |
string |
Der Name der Inhaltsschlüsselrichtlinie. |
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. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Detaillierte Fehlerinformationen. |
Beispiele
Get a Content Key Policy by name
Beispielanforderung
Beispiel für eine Antwort
{
"name": "PolicyWithMultipleOptions",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/contentKeyPolicies/PolicyWithMultipleOptions",
"type": "Microsoft.Media/mediaservices/contentKeyPolicies",
"properties": {
"policyId": "ed7f3d1b-cfa7-4181-b966-e0b3027eec3a",
"created": "2015-12-01T00:00:00Z",
"lastModified": "2016-12-02T00:00:00Z",
"description": "A policy with multiple options.",
"options": [
{
"policyOptionId": "caf1e28c-8288-4301-8c46-c0f9312c512f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyTokenRestriction",
"issuer": "http://testacs",
"audience": "urn:test",
"primaryVerificationKey": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicySymmetricTokenKey",
"keyValue": ""
},
"alternateVerificationKeys": [],
"requiredClaims": [
{
"claimType": "urn:microsoft:azure:mediaservices:contentkeyidentifier"
},
{
"claimType": "DRM",
"claimValue": "Widevine"
}
],
"restrictionTokenType": "Jwt"
}
},
{
"policyOptionId": "da346259-0cd6-4609-89dc-15ac131bd92f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyWidevineConfiguration",
"widevineTemplate": "{\"allowed_track_types\":\"SD_HD\",\"content_key_specs\":[{\"track_type\":\"SD\",\"security_level\":1,\"required_output_protection\":{\"hdcp\":\"HDCP_V2\"}}],\"policy_overrides\":{\"can_play\":true,\"can_persist\":true,\"can_renew\":false}}"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
}
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Content |
Eine Inhaltsschlüsselrichtlinie-Ressource. |
Content |
Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar. |
Content |
Gibt eine Konfiguration für FairPlay-Lizenzen an. |
Content |
|
Content |
Der Miet- und Leaseschlüsseltyp. |
Content |
Stellt eine offene Einschränkung dar. Die Lizenz oder der Schlüssel werden bei jeder Anforderung übermittelt. |
Content |
Stellt eine Richtlinienoption dar. |
Content |
Gibt eine Konfiguration für PlayReady-Lizenzen an. |
Content |
Gibt an, dass sich die Inhaltsschlüssel-ID im PlayReady-Header befindet. |
Content |
Gibt an, dass die Inhaltsschlüssel-ID in der PlayReady-Konfiguration angegeben wird. |
Content |
Der PlayReady-Inhaltstyp. |
Content |
Konfiguriert die Steuerungsbits für explizite analoge Fernsehausgaben. Weitere Informationen finden Sie in den PlayReady-Complianceregeln. |
Content |
Die PlayReady-Lizenz |
Content |
Der Lizenztyp. |
Content |
Konfiguriert das Play Right in der PlayReady-Lizenz. |
Content |
Konfiguriert Unbekannte Ausgabebehandlungseinstellungen der Lizenz. |
Content |
Der Tokentyp. |
Content |
Gibt einen RSA-Schlüssel für die Tokenüberprüfung an. |
Content |
Gibt einen symmetrischen Schlüssel für die Tokenüberprüfung an. |
Content |
Stellt einen Tokenanspruch dar. |
Content |
Stellt eine Tokeneinschränkung dar. Das bereitgestellte Token muss diesen Anforderungen für eine erfolgreiche Lizenz- oder Schlüsselübermittlung entsprechen. |
Content |
Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist. |
Content |
Stellt eine ContentKeyPolicyRestriction dar, die in der aktuellen API-Version nicht verfügbar ist. |
Content |
Gibt eine Konfiguration für Widevine-Lizenzen an. |
Content |
Gibt ein Zertifikat für die Tokenüberprüfung an. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Security |
Die Sicherheitsstufe. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
ContentKeyPolicy
Eine Inhaltsschlüsselrichtlinie-Ressource.
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.created |
string |
Das Erstellungsdatum der Richtlinie. |
properties.description |
string |
Eine Beschreibung der Richtlinie. |
properties.lastModified |
string |
Das Datum der letzten Änderung der Richtlinie. |
properties.options |
Die Optionen für die Schlüsselrichtlinie. |
|
properties.policyId |
string |
Die ID der Legacyrichtlinie. |
systemData |
Die Systemmetadaten, die sich auf diese Ressource beziehen. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
Stellt eine Konfiguration für Nicht-DRM-Schlüssel dar.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyFairPlayConfiguration
Gibt eine Konfiguration für FairPlay-Lizenzen an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ask |
string |
Der Schlüssel, der als FairPlay Application Secret-Schlüssel verwendet werden muss. Dies muss base64-codiert sein. |
fairPlayPfx |
string |
Die Base64-Darstellung des FairPlay-Zertifikats im PKCS 12-Format (pfx) (einschließlich privatem Schlüssel). |
fairPlayPfxPassword |
string |
Das Kennwort, das das FairPlay-Zertifikat im PKCS 12-Format (pfx) verschlüsselt. |
offlineRentalConfiguration |
Offline-Mietrichtlinie |
|
rentalAndLeaseKeyType |
Der Miet- und Leaseschlüsseltyp. |
|
rentalDuration |
integer |
Die Mietdauer. Muss größer als oder gleich 0 sein. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | Typ | Beschreibung |
---|---|---|
playbackDurationSeconds |
integer |
Wiedergabedauer |
storageDurationSeconds |
integer |
Speicherdauer |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Der Miet- und Leaseschlüsseltyp.
Name | Typ | Beschreibung |
---|---|---|
DualExpiry |
string |
Dualer Ablauf für die Offline-Vermietung. |
PersistentLimited |
string |
Der Inhaltsschlüssel kann beibehalten werden, und die gültige Dauer wird durch den Wert der Mietdauer begrenzt. |
PersistentUnlimited |
string |
Der Inhaltsschlüssel kann mit einer unbegrenzten Dauer beibehalten werden. |
Undefined |
string |
Die Schlüsseldauer wird nicht angegeben. |
Unknown |
string |
Stellt einen ContentKeyPolicyFairPlayRentalAndLeaseKeyType dar, der in der aktuellen API-Version nicht verfügbar ist. |
ContentKeyPolicyOpenRestriction
Stellt eine offene Einschränkung dar. Die Lizenz oder der Schlüssel werden bei jeder Anforderung übermittelt.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyOption
Stellt eine Richtlinienoption dar.
Name | Typ | Beschreibung |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Die Schlüsselübermittlungskonfiguration. |
name |
string |
Die Beschreibung der Richtlinienoption. |
policyOptionId |
string |
Die Legacy-Richtlinienoptions-ID. |
restriction | ContentKeyPolicyRestriction: |
Die Anforderungen, die erfüllt werden müssen, um Schlüssel mit dieser Konfiguration bereitzustellen |
ContentKeyPolicyPlayReadyConfiguration
Gibt eine Konfiguration für PlayReady-Lizenzen an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
licenses |
Die PlayReady-Lizenzen. |
|
responseCustomData |
string |
Die benutzerdefinierten Antwortdaten. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Gibt an, dass sich die Inhaltsschlüssel-ID im PlayReady-Header befindet.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Gibt an, dass die Inhaltsschlüssel-ID in der PlayReady-Konfiguration angegeben wird.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
keyId |
string |
Die Inhaltsschlüssel-ID. |
ContentKeyPolicyPlayReadyContentType
Der PlayReady-Inhaltstyp.
Name | Typ | Beschreibung |
---|---|---|
UltraVioletDownload |
string |
Inhaltstyp ultravioletter Download. |
UltraVioletStreaming |
string |
Ultraviolettes Streaminginhaltstyp. |
Unknown |
string |
Stellt einen ContentKeyPolicyPlayReadyContentType dar, der in der aktuellen API-Version nicht verfügbar ist. |
Unspecified |
string |
Nicht angegebener Inhaltstyp. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Konfiguriert die Steuerungsbits für explizite analoge Fernsehausgaben. Weitere Informationen finden Sie in den PlayReady-Complianceregeln.
Name | Typ | Beschreibung |
---|---|---|
bestEffort |
boolean |
Gibt an, ob diese Einschränkung auf Best Effort-Basis erzwungen wird. |
configurationData |
integer |
Konfiguriert die Einschränkungssteuerungsbits. Muss zwischen 0 und 3 inklusive sein. |
ContentKeyPolicyPlayReadyLicense
Die PlayReady-Lizenz
Name | Typ | Beschreibung |
---|---|---|
allowTestDevices |
boolean |
Ein Flag, das angibt, ob Testgeräte die Lizenz verwenden können. |
beginDate |
string |
Das Anfangsdatum der Lizenz |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Der Speicherort des Inhaltsschlüssels. |
contentType |
Der PlayReady-Inhaltstyp. |
|
expirationDate |
string |
Das Ablaufdatum der Lizenz. |
gracePeriod |
string |
Die Nachfrist der Lizenz. |
licenseType |
Der Lizenztyp. |
|
playRight |
Die Lizenz PlayRight |
|
relativeBeginDate |
string |
Das relative Anfangsdatum der Lizenz. |
relativeExpirationDate |
string |
Das relative Ablaufdatum der Lizenz. |
securityLevel |
Die Sicherheitsstufe. |
ContentKeyPolicyPlayReadyLicenseType
Der Lizenztyp.
Name | Typ | Beschreibung |
---|---|---|
NonPersistent |
string |
Nicht persistente Lizenz. |
Persistent |
string |
Persistente Lizenz. Ermöglicht die Offlinewiedergabe. |
Unknown |
string |
Stellt einen ContentKeyPolicyPlayReadyLicenseType dar, der in der aktuellen API-Version nicht verfügbar ist. |
ContentKeyPolicyPlayReadyPlayRight
Konfiguriert das Play Right in der PlayReady-Lizenz.
Name | Typ | Beschreibung |
---|---|---|
agcAndColorStripeRestriction |
integer |
Konfiguriert die automatische Verstärkungssteuerung (Automatic Gain Control, AGC) und Den Farbstreifen in der Lizenz. Muss zwischen 0 und 3 inklusive sein. |
allowPassingVideoContentToUnknownOutput |
Konfiguriert Unbekannte Ausgabebehandlungseinstellungen der Lizenz. |
|
analogVideoOpl |
integer |
Gibt die Ausgabeschutzebene für komprimiertes digitales Audio an. |
compressedDigitalAudioOpl |
integer |
Gibt die Ausgabeschutzebene für komprimiertes digitales Audio an. |
compressedDigitalVideoOpl |
integer |
Gibt die Ausgabeschutzebene für komprimiertes digitales Video an. |
digitalVideoOnlyContentRestriction |
boolean |
Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz. |
explicitAnalogTelevisionOutputRestriction |
Content |
Konfiguriert die Explizite Ausgangsbeschränkung für analoges Fernsehen in der Lizenz. Konfigurationsdaten müssen zwischen 0 und 3 einschließlich liegen. |
firstPlayExpiration |
string |
Die Zeitspanne, in der die Lizenz gültig ist, nachdem die Lizenz zuerst zum Wiedergeben von Inhalten verwendet wird. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Aktiviert die Bildeinschränkung für die Videoeinschränkung analoger Komponenten in der Lizenz. |
scmsRestriction |
integer |
Konfiguriert das Serial Copy Management System (SCMS) in der Lizenz. Muss zwischen 0 und 3 inklusive sein. |
uncompressedDigitalAudioOpl |
integer |
Gibt die Ausgabeschutzebene für nicht komprimiertes digitales Audio an. |
uncompressedDigitalVideoOpl |
integer |
Gibt die Ausgabeschutzebene für nicht komprimiertes digitales Video an. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Konfiguriert Unbekannte Ausgabebehandlungseinstellungen der Lizenz.
Name | Typ | Beschreibung |
---|---|---|
Allowed |
string |
Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist zulässig. |
AllowedWithVideoConstriction |
string |
Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist zulässig, jedoch mit eingeschränkter Auflösung. |
NotAllowed |
string |
Das Übergeben des Videoteils geschützter Inhalte an eine unbekannte Ausgabe ist nicht zulässig. |
Unknown |
string |
Stellt eine ContentKeyPolicyPlayReadyUnknownOutputPassingOption dar, die in der aktuellen API-Version nicht verfügbar ist. |
ContentKeyPolicyRestrictionTokenType
Der Tokentyp.
Name | Typ | Beschreibung |
---|---|---|
Jwt |
string |
JSON-Webtoken. |
Swt |
string |
Einfaches Webtoken. |
Unknown |
string |
Stellt einen ContentKeyPolicyRestrictionTokenType dar, der in der aktuellen API-Version nicht verfügbar ist. |
ContentKeyPolicyRsaTokenKey
Gibt einen RSA-Schlüssel für die Tokenüberprüfung an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
exponent |
string |
Der RSA-Parameterexponent |
modulus |
string |
Das RSA-Parametermodul |
ContentKeyPolicySymmetricTokenKey
Gibt einen symmetrischen Schlüssel für die Tokenüberprüfung an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
keyValue |
string |
Der Schlüsselwert des Schlüssels |
ContentKeyPolicyTokenClaim
Stellt einen Tokenanspruch dar.
Name | Typ | Beschreibung |
---|---|---|
claimType |
string |
Tokenanspruchstyp. |
claimValue |
string |
Tokenanspruchswert. |
ContentKeyPolicyTokenRestriction
Stellt eine Tokeneinschränkung dar. Das bereitgestellte Token muss diesen Anforderungen für eine erfolgreiche Lizenz- oder Schlüsselübermittlung entsprechen.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Eine Liste mit alternativen Überprüfungsschlüsseln. |
audience |
string |
Die Zielgruppe für das Token. |
issuer |
string |
Der Tokenaussteller. |
openIdConnectDiscoveryDocument |
string |
Das OpenID-Verbindungsermittlungsdokument. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Der primäre Überprüfungsschlüssel. |
requiredClaims |
Eine Liste der erforderlichen Tokenansprüche. |
|
restrictionTokenType |
Der Tokentyp. |
ContentKeyPolicyUnknownConfiguration
Stellt eine ContentKeyPolicyConfiguration dar, die in der aktuellen API-Version nicht verfügbar ist.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyUnknownRestriction
Stellt eine ContentKeyPolicyRestriction dar, die in der aktuellen API-Version nicht verfügbar ist.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
ContentKeyPolicyWidevineConfiguration
Gibt eine Konfiguration für Widevine-Lizenzen an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
widevineTemplate |
string |
Die Widevine-Vorlage. |
ContentKeyPolicyX509CertificateTokenKey
Gibt ein Zertifikat für die Tokenüberprüfung an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Der Diskriminator für abgeleitete Typen. |
rawBody |
string |
Das Rohdatenfeld eines Zertifikats im PKCS 12-Format (X509Certificate2 in .NET) |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
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. |
SecurityLevel
Die Sicherheitsstufe.
Name | Typ | Beschreibung |
---|---|---|
SL150 |
string |
Für Clients, die sich in der Entwicklung oder im Test befinden. Kein Schutz vor unbefugter Verwendung. |
SL2000 |
string |
Für gehärtete Geräte und Anwendungen, die kommerzielle Inhalte nutzen. Software- oder Hardwareschutz. |
SL3000 |
string |
Nur für gehärtete Geräte. Hardwareschutz. |
Unknown |
string |
Stellt einen SecurityLevel dar, der in der aktuellen API-Version nicht verfügbar ist. |
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. |