Content Key Policies - Get
Een inhoudssleutelbeleid ophalen
De details van een inhoudssleutelbeleid ophalen in het Media Services-account
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
De naam van het Media Services-account. |
content
|
path | True |
string |
De naam van het inhoudssleutelbeleid. |
resource
|
path | True |
string |
De naam van de resourcegroep binnen het Azure-abonnement. |
subscription
|
path | True |
string |
De unieke id voor een Microsoft Azure-abonnement. |
api-version
|
query | True |
string |
De versie van de API die moet worden gebruikt met de clientaanvraag. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Gedetailleerde foutinformatie. |
Voorbeelden
Get a Content Key Policy by name
Voorbeeldaanvraag
Voorbeeldrespons
{
"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"
}
}
]
}
}
Definities
Name | Description |
---|---|
Content |
Een inhoudssleutelbeleidsresource. |
Content |
Vertegenwoordigt een configuratie voor niet-DRM-sleutels. |
Content |
Hiermee geeft u een configuratie voor FairPlay-licenties. |
Content |
|
Content |
Het type huur- en leasesleutel. |
Content |
Vertegenwoordigt een open beperking. De licentie of sleutel wordt op elke aanvraag geleverd. |
Content |
Vertegenwoordigt een beleidsoptie. |
Content |
Hiermee geeft u een configuratie voor PlayReady-licenties. |
Content |
Hiermee geeft u op dat de inhoudssleutel-id zich in de PlayReady-header bevindt. |
Content |
Hiermee geeft u op dat de inhoudssleutel-id wordt opgegeven in de PlayReady-configuratie. |
Content |
Het PlayReady-inhoudstype. |
Content |
Hiermee configureert u de besturingselementbits expliciete analoge televisieuitvoerbeperking. Zie de PlayReady-nalevingsregels voor meer informatie. |
Content |
De PlayReady-licentie |
Content |
Het licentietype. |
Content |
Hiermee configureert u het play-recht in de PlayReady-licentie. |
Content |
Hiermee configureert u onbekende uitvoerafhandelingsinstellingen van de licentie. |
Content |
Het type token. |
Content |
Hiermee geeft u een RSA-sleutel voor tokenvalidatie op |
Content |
Hiermee geeft u een symmetrische sleutel voor tokenvalidatie. |
Content |
Vertegenwoordigt een tokenclaim. |
Content |
Vertegenwoordigt een tokenbeperking. Het opgegeven token moet voldoen aan deze vereisten voor een geslaagde licentie- of sleutellevering. |
Content |
Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie. |
Content |
Vertegenwoordigt een ContentKeyPolicyRestriction die niet beschikbaar is in de huidige API-versie. |
Content |
Hiermee geeft u een configuratie voor Widevine-licenties. |
Content |
Hiermee geeft u een certificaat voor tokenvalidatie. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Security |
Het beveiligingsniveau. |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
ContentKeyPolicy
Een inhoudssleutelbeleidsresource.
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
De naam van de resource |
properties.created |
string |
De aanmaakdatum van het beleid |
properties.description |
string |
Een beschrijving voor het beleid. |
properties.lastModified |
string |
De laatste wijzigingsdatum van het beleid |
properties.options |
De opties voor sleutelbeleid. |
|
properties.policyId |
string |
De verouderde beleids-id. |
systemData |
De systeemmetagegevens met betrekking tot deze resource. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
ContentKeyPolicyClearKeyConfiguration
Vertegenwoordigt een configuratie voor niet-DRM-sleutels.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ContentKeyPolicyFairPlayConfiguration
Hiermee geeft u een configuratie voor FairPlay-licenties.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ask |
string |
De sleutel die moet worden gebruikt als FairPlay-toepassingsgeheimsleutel. Dit moet base64 gecodeerd zijn. |
fairPlayPfx |
string |
De Base64-weergave van het FairPlay-certificaat in PKCS 12-indeling (pfx) (inclusief persoonlijke sleutel). |
fairPlayPfxPassword |
string |
Het fairplay-certificaat voor wachtwoordversleuteling in PKCS 12-indeling (pfx). |
offlineRentalConfiguration |
Offline verhuurbeleid |
|
rentalAndLeaseKeyType |
Het type huur- en leasesleutel. |
|
rentalDuration |
integer |
De huurduur. Moet groter dan of gelijk aan 0 zijn. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | Type | Description |
---|---|---|
playbackDurationSeconds |
integer |
Afspeelduur |
storageDurationSeconds |
integer |
Opslagduur |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Het type huur- en leasesleutel.
Name | Type | Description |
---|---|---|
DualExpiry |
string |
Dubbele vervaldatum voor offline verhuur. |
PersistentLimited |
string |
De inhoudssleutel kan worden bewaard en de geldige duur wordt beperkt door de waarde van de huurduur |
PersistentUnlimited |
string |
Inhoudssleutel kan worden bewaard met een onbeperkte duur |
Undefined |
string |
Sleutelduur is niet opgegeven. |
Unknown |
string |
Vertegenwoordigt een ContentKeyPolicyFairPlayRentalAndLeaseKeyType die niet beschikbaar is in de huidige API-versie. |
ContentKeyPolicyOpenRestriction
Vertegenwoordigt een open beperking. De licentie of sleutel wordt op elke aanvraag geleverd.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ContentKeyPolicyOption
Vertegenwoordigt een beleidsoptie.
Name | Type | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
De sleutelleveringsconfiguratie. |
name |
string |
De beschrijving van de beleidsoptie. |
policyOptionId |
string |
De id van de verouderde beleidsoptie. |
restriction | ContentKeyPolicyRestriction: |
De vereisten waaraan moet worden voldaan om sleutels te leveren met deze configuratie |
ContentKeyPolicyPlayReadyConfiguration
Hiermee geeft u een configuratie voor PlayReady-licenties.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
licenses |
De PlayReady-licenties. |
|
responseCustomData |
string |
De aangepaste antwoordgegevens. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Hiermee geeft u op dat de inhoudssleutel-id zich in de PlayReady-header bevindt.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Hiermee geeft u op dat de inhoudssleutel-id wordt opgegeven in de PlayReady-configuratie.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyId |
string |
De id van de inhoudssleutel. |
ContentKeyPolicyPlayReadyContentType
Het PlayReady-inhoudstype.
Name | Type | Description |
---|---|---|
UltraVioletDownload |
string |
Ultraviolet downloaden inhoudstype. |
UltraVioletStreaming |
string |
Ultraviolet streaming inhoudstype. |
Unknown |
string |
Vertegenwoordigt een ContentKeyPolicyPlayReadyContentType dat niet beschikbaar is in de huidige API-versie. |
Unspecified |
string |
Niet-opgegeven inhoudstype. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Hiermee configureert u de besturingselementbits expliciete analoge televisieuitvoerbeperking. Zie de PlayReady-nalevingsregels voor meer informatie.
Name | Type | Description |
---|---|---|
bestEffort |
boolean |
Geeft aan of deze beperking wordt afgedwongen op basis van best effort. |
configurationData |
integer |
Hiermee configureert u de bits voor beperkingsbeheer. Moet tussen 0 en 3 zijn. |
ContentKeyPolicyPlayReadyLicense
De PlayReady-licentie
Name | Type | Description |
---|---|---|
allowTestDevices |
boolean |
Een vlag die aangeeft of testapparaten de licentie kunnen gebruiken. |
beginDate |
string |
De begindatum van de licentie |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
De locatie van de inhoudssleutel. |
contentType |
Het PlayReady-inhoudstype. |
|
expirationDate |
string |
De vervaldatum van de licentie. |
gracePeriod |
string |
De respijtperiode van de licentie. |
licenseType |
Het licentietype. |
|
playRight |
De licentie PlayRight |
|
relativeBeginDate |
string |
De relatieve begindatum van de licentie. |
relativeExpirationDate |
string |
De relatieve vervaldatum van de licentie. |
securityLevel |
Het beveiligingsniveau. |
ContentKeyPolicyPlayReadyLicenseType
Het licentietype.
Name | Type | Description |
---|---|---|
NonPersistent |
string |
Niet-permanente licentie. |
Persistent |
string |
Permanente licentie. Hiermee staat u offline afspelen toe. |
Unknown |
string |
Vertegenwoordigt een ContentKeyPolicyPlayReadyLicenseType dat niet beschikbaar is in de huidige API-versie. |
ContentKeyPolicyPlayReadyPlayRight
Hiermee configureert u het play-recht in de PlayReady-licentie.
Name | Type | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Hiermee configureert u AGC (Automatic Gain Control) en Color Stripe in de licentie. Moet tussen 0 en 3 zijn. |
allowPassingVideoContentToUnknownOutput |
Hiermee configureert u onbekende uitvoerafhandelingsinstellingen van de licentie. |
|
analogVideoOpl |
integer |
Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale audio op. |
compressedDigitalAudioOpl |
integer |
Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale audio op. |
compressedDigitalVideoOpl |
integer |
Hiermee geeft u het uitvoerbeveiligingsniveau voor gecomprimeerde digitale video op. |
digitalVideoOnlyContentRestriction |
boolean |
Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in. |
explicitAnalogTelevisionOutputRestriction |
Content |
Configureert de expliciete analoge televisieuitvoerbeperking in de licentie. Configuratiegegevens moeten tussen 0 en 3 zijn. |
firstPlayExpiration |
string |
De tijdsduur dat de licentie geldig is nadat de licentie voor het eerst is gebruikt om inhoud af te spelen. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Hiermee schakelt u de afbeeldingsbeperking voor videobeperking voor analoge onderdelen in de licentie in. |
scmsRestriction |
integer |
Hiermee configureert u het SCMS (Serial Copy Management System) in de licentie. Moet tussen 0 en 3 zijn. |
uncompressedDigitalAudioOpl |
integer |
Hiermee geeft u het uitvoerbeveiligingsniveau voor niet-gecomprimeerde digitale audio op. |
uncompressedDigitalVideoOpl |
integer |
Hiermee geeft u het uitvoerbeveiligingsniveau voor niet-gecomprimeerde digitale video op. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Hiermee configureert u onbekende uitvoerafhandelingsinstellingen van de licentie.
Name | Type | Description |
---|---|---|
Allowed |
string |
Het videogedeelte van beveiligde inhoud doorgeven aan een onbekende uitvoer is toegestaan. |
AllowedWithVideoConstriction |
string |
Het doorgeven van het videogedeelte van beveiligde inhoud aan een onbekende uitvoer is toegestaan, maar met beperkte resolutie. |
NotAllowed |
string |
Het videogedeelte van beveiligde inhoud doorgeven aan een onbekende uitvoer is niet toegestaan. |
Unknown |
string |
Vertegenwoordigt een ContentKeyPolicyPlayReadyUnknownOutputPassingOption die niet beschikbaar is in de huidige API-versie. |
ContentKeyPolicyRestrictionTokenType
Het type token.
Name | Type | Description |
---|---|---|
Jwt |
string |
JSON-webtoken. |
Swt |
string |
Eenvoudig webtoken. |
Unknown |
string |
Vertegenwoordigt een ContentKeyPolicyRestrictionTokenType dat niet beschikbaar is in de huidige API-versie. |
ContentKeyPolicyRsaTokenKey
Hiermee geeft u een RSA-sleutel voor tokenvalidatie op
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
exponent |
string |
De exponent van de RSA-parameter |
modulus |
string |
De RSA-parametermodulatie |
ContentKeyPolicySymmetricTokenKey
Hiermee geeft u een symmetrische sleutel voor tokenvalidatie.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyValue |
string |
De sleutelwaarde van de sleutel |
ContentKeyPolicyTokenClaim
Vertegenwoordigt een tokenclaim.
Name | Type | Description |
---|---|---|
claimType |
string |
Tokenclaimtype. |
claimValue |
string |
Waarde van tokenclaim. |
ContentKeyPolicyTokenRestriction
Vertegenwoordigt een tokenbeperking. Het opgegeven token moet voldoen aan deze vereisten voor een geslaagde licentie- of sleutellevering.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Een lijst met alternatieve verificatiesleutels. |
audience |
string |
De doelgroep voor het token. |
issuer |
string |
De verlener van het token. |
openIdConnectDiscoveryDocument |
string |
Het openID connect-detectiedocument. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
De primaire verificatiesleutel. |
requiredClaims |
Een lijst met vereiste tokenclaims. |
|
restrictionTokenType |
Het type token. |
ContentKeyPolicyUnknownConfiguration
Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ContentKeyPolicyUnknownRestriction
Vertegenwoordigt een ContentKeyPolicyRestriction die niet beschikbaar is in de huidige API-versie.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
ContentKeyPolicyWidevineConfiguration
Hiermee geeft u een configuratie voor Widevine-licenties.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
widevineTemplate |
string |
De Widevine-sjabloon. |
ContentKeyPolicyX509CertificateTokenKey
Hiermee geeft u een certificaat voor tokenvalidatie.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
rawBody |
string |
Het onbewerkte gegevensveld van een certificaat in PKCS 12-indeling (X509Certificate2 in .NET) |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
Aanvullende informatie over de fout. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
SecurityLevel
Het beveiligingsniveau.
Name | Type | Description |
---|---|---|
SL150 |
string |
Voor clients in ontwikkeling of test. Geen bescherming tegen onbevoegd gebruik. |
SL2000 |
string |
Voor beveiligde apparaten en toepassingen die commerciƫle inhoud verbruiken. Software- of hardwarebeveiliging. |
SL3000 |
string |
Alleen voor beveiligde apparaten. Hardwarebeveiliging. |
Unknown |
string |
Vertegenwoordigt een SecurityLevel dat niet beschikbaar is in de huidige API-versie. |
systemData
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
Het tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource het laatst heeft gewijzigd. |