Delen via


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

string

De naam van het Media Services-account.

contentKeyPolicyName
path True

string

De naam van het inhoudssleutelbeleid.

resourceGroupName
path True

string

De naam van de resourcegroep binnen het Azure-abonnement.

subscriptionId
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

ContentKeyPolicy

OK

Other Status Codes

ErrorResponse

Gedetailleerde foutinformatie.

Voorbeelden

Get a Content Key Policy by name

Sample Request

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

Sample Response

{
  "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
ContentKeyPolicy

Een inhoudssleutelbeleidsresource.

ContentKeyPolicyClearKeyConfiguration

Vertegenwoordigt een configuratie voor niet-DRM-sleutels.

ContentKeyPolicyFairPlayConfiguration

Hiermee geeft u een configuratie voor FairPlay-licenties.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Het type huur- en leasesleutel.

ContentKeyPolicyOpenRestriction

Vertegenwoordigt een open beperking. De licentie of sleutel wordt op elke aanvraag geleverd.

ContentKeyPolicyOption

Vertegenwoordigt een beleidsoptie.

ContentKeyPolicyPlayReadyConfiguration

Hiermee geeft u een configuratie voor PlayReady-licenties.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Hiermee geeft u op dat de inhoudssleutel-id zich in de PlayReady-header bevindt.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Hiermee geeft u op dat de inhoudssleutel-id wordt opgegeven in de PlayReady-configuratie.

ContentKeyPolicyPlayReadyContentType

Het PlayReady-inhoudstype.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Hiermee configureert u de besturingselementbits expliciete analoge televisieuitvoerbeperking. Zie de PlayReady-nalevingsregels voor meer informatie.

ContentKeyPolicyPlayReadyLicense

De PlayReady-licentie

ContentKeyPolicyPlayReadyLicenseType

Het licentietype.

ContentKeyPolicyPlayReadyPlayRight

Hiermee configureert u het play-recht in de PlayReady-licentie.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Hiermee configureert u onbekende uitvoerafhandelingsinstellingen van de licentie.

ContentKeyPolicyRestrictionTokenType

Het type token.

ContentKeyPolicyRsaTokenKey

Hiermee geeft u een RSA-sleutel voor tokenvalidatie op

ContentKeyPolicySymmetricTokenKey

Hiermee geeft u een symmetrische sleutel voor tokenvalidatie.

ContentKeyPolicyTokenClaim

Vertegenwoordigt een tokenclaim.

ContentKeyPolicyTokenRestriction

Vertegenwoordigt een tokenbeperking. Het opgegeven token moet voldoen aan deze vereisten voor een geslaagde licentie- of sleutellevering.

ContentKeyPolicyUnknownConfiguration

Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyUnknownRestriction

Vertegenwoordigt een ContentKeyPolicyRestriction die niet beschikbaar is in de huidige API-versie.

ContentKeyPolicyWidevineConfiguration

Hiermee geeft u een configuratie voor Widevine-licenties.

ContentKeyPolicyX509CertificateTokenKey

Hiermee geeft u een certificaat voor tokenvalidatie.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

SecurityLevel

Het beveiligingsniveau.

systemData

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

ContentKeyPolicyOption[]

De opties voor sleutelbeleid.

properties.policyId

string

De verouderde beleids-id.

systemData

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.Media.ContentKeyPolicyClearKeyConfiguration

De discriminator voor afgeleide typen.

ContentKeyPolicyFairPlayConfiguration

Hiermee geeft u een configuratie voor FairPlay-licenties.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

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

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Offline verhuurbeleid

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

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.Media.ContentKeyPolicyOpenRestriction

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.Media.ContentKeyPolicyPlayReadyConfiguration

De discriminator voor afgeleide typen.

licenses

ContentKeyPolicyPlayReadyLicense[]

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

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

ContentKeyPolicyPlayReadyContentType

Het PlayReady-inhoudstype.

expirationDate

string

De vervaldatum van de licentie.

gracePeriod

string

De respijtperiode van de licentie.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Het licentietype.

playRight

ContentKeyPolicyPlayReadyPlayRight

De licentie PlayRight

relativeBeginDate

string

De relatieve begindatum van de licentie.

relativeExpirationDate

string

De relatieve vervaldatum van de licentie.

securityLevel

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

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

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

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

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.Media.ContentKeyPolicyRsaTokenKey

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.Media.ContentKeyPolicySymmetricTokenKey

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.Media.ContentKeyPolicyTokenRestriction

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

ContentKeyPolicyTokenClaim[]

Een lijst met vereiste tokenclaims.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Het type token.

ContentKeyPolicyUnknownConfiguration

Vertegenwoordigt een ContentKeyPolicyConfiguration die niet beschikbaar is in de huidige API-versie.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

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.Media.ContentKeyPolicyUnknownRestriction

De discriminator voor afgeleide typen.

ContentKeyPolicyWidevineConfiguration

Hiermee geeft u een configuratie voor Widevine-licenties.

Name Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

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.Media.ContentKeyPolicyX509CertificateTokenKey

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

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

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

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

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.