Partager via


Content Key Policies - Get

Obtenir une stratégie de clé de contenu
Obtenir les détails d’une stratégie de clé de contenu dans le compte Media Services

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
path True

string

Nom du compte Media Services.

contentKeyPolicyName
path True

string

Nom de la stratégie de clé de contenu.

resourceGroupName
path True

string

Nom du groupe de ressources au sein de l’abonnement Azure.

subscriptionId
path True

string

Identificateur unique d’un abonnement Microsoft Azure.

api-version
query True

string

Version de l’API à utiliser avec la demande cliente.

Réponses

Nom Type Description
200 OK

ContentKeyPolicy

Ok

Other Status Codes

ErrorResponse

Informations détaillées sur les erreurs.

Exemples

Get a Content Key Policy by name

Exemple de requête

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

Exemple de réponse

{
  "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"
        }
      }
    ]
  }
}

Définitions

Nom Description
ContentKeyPolicy

Une ressource de stratégie de clé de contenu.

ContentKeyPolicyClearKeyConfiguration

Représente une configuration pour les clés non DRM.

ContentKeyPolicyFairPlayConfiguration

Spécifie une configuration pour les licences FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Type de clé de location et de bail.

ContentKeyPolicyOpenRestriction

Représente une restriction ouverte. La licence ou la clé sera remise à chaque demande.

ContentKeyPolicyOption

Représente une option de stratégie.

ContentKeyPolicyPlayReadyConfiguration

Spécifie une configuration pour les licences PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Spécifie que l’ID de clé de contenu se trouve dans l’en-tête PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Spécifie que l’ID de clé de contenu est spécifié dans la configuration PlayReady.

ContentKeyPolicyPlayReadyContentType

Type de contenu PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configure les bits de contrôle De restriction de sortie de la télévision analogique explicite. Pour plus d’informations, consultez les règles de conformité PlayReady.

ContentKeyPolicyPlayReadyLicense

La licence PlayReady

ContentKeyPolicyPlayReadyLicenseType

Type de licence.

ContentKeyPolicyPlayReadyPlayRight

Configure l’option Lire à droite dans la licence PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configure les paramètres de gestion des sorties inconnues de la licence.

ContentKeyPolicyRestrictionTokenType

Type de jeton.

ContentKeyPolicyRsaTokenKey

Spécifie une clé RSA pour la validation des jetons

ContentKeyPolicySymmetricTokenKey

Spécifie une clé symétrique pour la validation des jetons.

ContentKeyPolicyTokenClaim

Représente une revendication de jeton.

ContentKeyPolicyTokenRestriction

Représente une restriction de jeton. Le jeton fourni doit correspondre à ces exigences pour une licence ou une remise de clé réussie.

ContentKeyPolicyUnknownConfiguration

Représente un ContentKeyPolicyConfiguration qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyUnknownRestriction

Représente un ContentKeyPolicyRestriction qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyWidevineConfiguration

Spécifie une configuration pour les licences Widevine.

ContentKeyPolicyX509CertificateTokenKey

Spécifie un certificat pour la validation de jeton.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

SecurityLevel

Niveau de sécurité.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

ContentKeyPolicy

Une ressource de stratégie de clé de contenu.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nom de la ressource.

properties.created

string

Date de création de la stratégie.

properties.description

string

Description de la stratégie.

properties.lastModified

string

Date de la dernière modification de la stratégie.

properties.options

ContentKeyPolicyOption[]

Options de la stratégie de clé.

properties.policyId

string

ID de stratégie hérité.

systemData

systemData

Métadonnées système relatives à cette ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ContentKeyPolicyClearKeyConfiguration

Représente une configuration pour les clés non DRM.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Discriminateur pour les types dérivés.

ContentKeyPolicyFairPlayConfiguration

Spécifie une configuration pour les licences FairPlay.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Discriminateur pour les types dérivés.

ask

string

Clé qui doit être utilisée comme clé secrète d’application FairPlay. Cela doit être encodé en base64.

fairPlayPfx

string

Représentation Base64 du certificat FairPlay au format PKCS 12 (pfx) (clé privée comprise).

fairPlayPfxPassword

string

Mot de passe de chiffrement du certificat FairPlay au format PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Stratégie de location hors connexion

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Type de clé de location et de bail.

rentalDuration

integer

Durée de location. Doit être supérieur ou égal à 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Nom Type Description
playbackDurationSeconds

integer

Durée de lecture

storageDurationSeconds

integer

Durée de stockage

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Type de clé de location et de bail.

Nom Type Description
DualExpiry

string

Double expiration pour la location hors connexion.

PersistentLimited

string

La clé de contenu peut être conservée et la durée valide est limitée par la valeur Durée de location

PersistentUnlimited

string

La clé de contenu peut être conservée avec une durée illimitée

Undefined

string

La durée de la clé n’est pas spécifiée.

Unknown

string

Représente un ContentKeyPolicyFairPlayRentalAndLeaseKeyType qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyOpenRestriction

Représente une restriction ouverte. La licence ou la clé sera remise à chaque demande.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Discriminateur pour les types dérivés.

ContentKeyPolicyOption

Représente une option de stratégie.

Nom Type Description
configuration ContentKeyPolicyConfiguration:

Configuration de remise de clés.

name

string

Description de l’option de stratégie.

policyOptionId

string

ID d’option de stratégie hérité.

restriction ContentKeyPolicyRestriction:

Conditions requises pour fournir des clés avec cette configuration

ContentKeyPolicyPlayReadyConfiguration

Spécifie une configuration pour les licences PlayReady.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Discriminateur pour les types dérivés.

licenses

ContentKeyPolicyPlayReadyLicense[]

Licences PlayReady.

responseCustomData

string

Données de réponse personnalisées.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Spécifie que l’ID de clé de contenu se trouve dans l’en-tête PlayReady.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Discriminateur pour les types dérivés.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Spécifie que l’ID de clé de contenu est spécifié dans la configuration PlayReady.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Discriminateur pour les types dérivés.

keyId

string

ID de clé de contenu.

ContentKeyPolicyPlayReadyContentType

Type de contenu PlayReady.

Nom Type Description
UltraVioletDownload

string

Type de contenu de téléchargement ultraviolet.

UltraVioletStreaming

string

Type de contenu de streaming ultraviolet.

Unknown

string

Représente un ContentKeyPolicyPlayReadyContentType qui n’est pas disponible dans la version actuelle de l’API.

Unspecified

string

Type de contenu non spécifié.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configure les bits de contrôle De restriction de sortie de la télévision analogique explicite. Pour plus d’informations, consultez les règles de conformité PlayReady.

Nom Type Description
bestEffort

boolean

Indique si cette restriction est appliquée sur la base du meilleur effort.

configurationData

integer

Configure les bits de contrôle de restriction. Doit être compris entre 0 et 3 inclus.

ContentKeyPolicyPlayReadyLicense

La licence PlayReady

Nom Type Description
allowTestDevices

boolean

Indicateur indiquant si les appareils de test peuvent utiliser la licence.

beginDate

string

Date de début de la licence

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Emplacement de la clé de contenu.

contentType

ContentKeyPolicyPlayReadyContentType

Type de contenu PlayReady.

expirationDate

string

Date d’expiration de la licence.

gracePeriod

string

Période de grâce de la licence.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Type de licence.

playRight

ContentKeyPolicyPlayReadyPlayRight

La licence PlayRight

relativeBeginDate

string

Date de début relative de la licence.

relativeExpirationDate

string

Date d’expiration relative de la licence.

securityLevel

SecurityLevel

Niveau de sécurité.

ContentKeyPolicyPlayReadyLicenseType

Type de licence.

Nom Type Description
NonPersistent

string

Licence non persistante.

Persistent

string

Licence persistante. Autorise la lecture hors connexion.

Unknown

string

Représente un ContentKeyPolicyPlayReadyLicenseType qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyPlayReadyPlayRight

Configure l’option Lire à droite dans la licence PlayReady.

Nom Type Description
agcAndColorStripeRestriction

integer

Configure le contrôle de gain automatique (AGC) et la bande de couleur dans la licence. Doit être compris entre 0 et 3 inclus.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configure les paramètres de gestion des sorties inconnues de la licence.

analogVideoOpl

integer

Spécifie le niveau de protection de sortie pour l’audio numérique compressé.

compressedDigitalAudioOpl

integer

Spécifie le niveau de protection de sortie pour l’audio numérique compressé.

compressedDigitalVideoOpl

integer

Spécifie le niveau de protection de sortie pour la vidéo numérique compressée.

digitalVideoOnlyContentRestriction

boolean

Active la contrainte image pour la restriction vidéo de composant analogique dans la licence.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configure la restriction de sortie de télévision analogique explicite dans la licence. Les données de configuration doivent être comprises entre 0 et 3 inclus.

firstPlayExpiration

string

Durée de validité de la licence après la première utilisation de la licence pour lire du contenu.

imageConstraintForAnalogComponentVideoRestriction

boolean

Active la contrainte image pour la restriction vidéo de composant analogique dans la licence.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Active la contrainte image pour la restriction vidéo de composant analogique dans la licence.

scmsRestriction

integer

Configure le système de gestion de copie série (SCMS) dans la licence. Doit être compris entre 0 et 3 inclus.

uncompressedDigitalAudioOpl

integer

Spécifie le niveau de protection de sortie pour l’audio numérique non compressé.

uncompressedDigitalVideoOpl

integer

Spécifie le niveau de protection de sortie pour la vidéo numérique non compressée.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configure les paramètres de gestion des sorties inconnues de la licence.

Nom Type Description
Allowed

string

Le passage de la partie vidéo du contenu protégé à une sortie inconnue est autorisé.

AllowedWithVideoConstriction

string

Le passage de la partie vidéo du contenu protégé à une sortie inconnue est autorisé, mais avec une résolution limitée.

NotAllowed

string

La transmission de la partie vidéo du contenu protégé à une sortie inconnue n’est pas autorisée.

Unknown

string

Représente un ContentKeyPolicyPlayReadyUnknownOutputPassingOption qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyRestrictionTokenType

Type de jeton.

Nom Type Description
Jwt

string

Jeton web JSON.

Swt

string

Jeton web simple.

Unknown

string

Représente un ContentKeyPolicyRestrictionTokenType qui n’est pas disponible dans la version actuelle de l’API.

ContentKeyPolicyRsaTokenKey

Spécifie une clé RSA pour la validation des jetons

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Discriminateur pour les types dérivés.

exponent

string

Exposant de paramètre RSA

modulus

string

Module du paramètre RSA

ContentKeyPolicySymmetricTokenKey

Spécifie une clé symétrique pour la validation des jetons.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Discriminateur pour les types dérivés.

keyValue

string

Valeur de clé de la clé

ContentKeyPolicyTokenClaim

Représente une revendication de jeton.

Nom Type Description
claimType

string

Type de revendication de jeton.

claimValue

string

Valeur de revendication de jeton.

ContentKeyPolicyTokenRestriction

Représente une restriction de jeton. Le jeton fourni doit correspondre à ces exigences pour une licence ou une remise de clé réussie.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Discriminateur pour les types dérivés.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Liste des clés de vérification alternatives.

audience

string

Audience du jeton.

issuer

string

Émetteur de jeton.

openIdConnectDiscoveryDocument

string

Document de découverte de connexion OpenID.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Clé de vérification primaire.

requiredClaims

ContentKeyPolicyTokenClaim[]

Liste des revendications de jeton requises.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Type de jeton.

ContentKeyPolicyUnknownConfiguration

Représente un ContentKeyPolicyConfiguration qui n’est pas disponible dans la version actuelle de l’API.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Discriminateur pour les types dérivés.

ContentKeyPolicyUnknownRestriction

Représente un ContentKeyPolicyRestriction qui n’est pas disponible dans la version actuelle de l’API.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Discriminateur pour les types dérivés.

ContentKeyPolicyWidevineConfiguration

Spécifie une configuration pour les licences Widevine.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Discriminateur pour les types dérivés.

widevineTemplate

string

Modèle Widevine.

ContentKeyPolicyX509CertificateTokenKey

Spécifie un certificat pour la validation de jeton.

Nom Type Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Discriminateur pour les types dérivés.

rawBody

string

Champ de données brutes d’un certificat au format PKCS 12 (X509Certificate2 dans .NET)

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

SecurityLevel

Niveau de sécurité.

Nom Type Description
SL150

string

Pour les clients en cours de développement ou de test. Aucune protection contre une utilisation non autorisée.

SL2000

string

Pour les appareils renforcés et les applications qui consomment du contenu commercial. Protection logicielle ou matérielle.

SL3000

string

Pour les appareils renforcés uniquement. Protection matérielle.

Unknown

string

Représente un SecurityLevel qui n’est pas disponible dans la version actuelle de l’API.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la dernière ressource.

lastModifiedByType

createdByType

Type d’identité qui a modifié la dernière ressource.