Content Key Policies - Get
Obtener una directiva de clave de contenido
Obtener los detalles de una directiva de clave de contenido en la cuenta de Media Services
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Media Services. |
content
|
path | True |
string |
Nombre de la directiva de clave de contenido. |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Identificador único de una suscripción de Microsoft Azure. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Información detallada del error. |
Ejemplos
Get a Content Key Policy by name
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
}
]
}
}
Definiciones
Nombre | Description |
---|---|
Content |
Un recurso de directiva de clave de contenido. |
Content |
Representa una configuración para claves que no son DRM. |
Content |
Especifica una configuración para las licencias de FairPlay. |
Content |
|
Content |
Tipo de clave de alquiler y concesión. |
Content |
Representa una restricción abierta. La licencia o la clave se entregarán en cada solicitud. |
Content |
Representa una opción de directiva. |
Content |
Especifica una configuración para las licencias de PlayReady. |
Content |
Especifica que el identificador de clave de contenido está en el encabezado PlayReady. |
Content |
Especifica que el identificador de clave de contenido se especifica en la configuración de PlayReady. |
Content |
Tipo de contenido PlayReady. |
Content |
Configura los bits de control Explicit Analog Television Output Restriction. Para obtener más información, consulte Reglas de cumplimiento de PlayReady. |
Content |
La licencia de PlayReady |
Content |
Tipo de licencia. |
Content |
Configura la opción Play Right en la licencia de PlayReady. |
Content |
Configura los valores de control de salida desconocidos de la licencia. |
Content |
Tipo de token. |
Content |
Especifica una clave RSA para la validación de tokens. |
Content |
Especifica una clave simétrica para la validación de tokens. |
Content |
Representa una notificación de token. |
Content |
Representa una restricción de token. El token proporcionado debe coincidir con estos requisitos para la entrega correcta de licencias o claves. |
Content |
Representa una contentKeyPolicyConfiguration que no está disponible en la versión actual de la API. |
Content |
Representa una contentKeyPolicyRestriction que no está disponible en la versión actual de la API. |
Content |
Especifica una configuración para las licencias de Widevine. |
Content |
Especifica un certificado para la validación de tokens. |
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Security |
Nivel de seguridad. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
ContentKeyPolicy
Un recurso de directiva de clave de contenido.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso. |
properties.created |
string |
Fecha de creación de la directiva |
properties.description |
string |
Descripción de la directiva. |
properties.lastModified |
string |
Fecha de la última modificación de la directiva |
properties.options |
Opciones de la directiva de clave. |
|
properties.policyId |
string |
Identificador de directiva heredado. |
systemData |
Metadatos del sistema relacionados con este recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
Representa una configuración para claves que no son DRM.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ContentKeyPolicyFairPlayConfiguration
Especifica una configuración para las licencias de FairPlay.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ask |
string |
Clave que se debe usar como clave secreta de aplicación de FairPlay. Esto debe estar codificado en base64. |
fairPlayPfx |
string |
Representación en Base64 del certificado FairPlay en formato PKCS 12 (pfx) (incluida la clave privada). |
fairPlayPfxPassword |
string |
Contraseña que cifra el certificado FairPlay en formato PKCS 12 (pfx). |
offlineRentalConfiguration |
Directiva de alquiler sin conexión |
|
rentalAndLeaseKeyType |
Tipo de clave de alquiler y concesión. |
|
rentalDuration |
integer |
Duración del alquiler. Debe ser mayor o igual que 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Nombre | Tipo | Description |
---|---|---|
playbackDurationSeconds |
integer |
Duración de la reproducción |
storageDurationSeconds |
integer |
Duración del almacenamiento |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Tipo de clave de alquiler y concesión.
Nombre | Tipo | Description |
---|---|---|
DualExpiry |
string |
Expiración dual para el alquiler sin conexión. |
PersistentLimited |
string |
La clave de contenido se puede conservar y la duración válida está limitada por el valor de Duración del alquiler. |
PersistentUnlimited |
string |
La clave de contenido se puede conservar con una duración ilimitada |
Undefined |
string |
No se especifica la duración de la clave. |
Unknown |
string |
Representa un ContentKeyPolicyFairPlayRentalAndLeaseKeyType que no está disponible en la versión actual de la API. |
ContentKeyPolicyOpenRestriction
Representa una restricción abierta. La licencia o la clave se entregarán en cada solicitud.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ContentKeyPolicyOption
Representa una opción de directiva.
Nombre | Tipo | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Configuración de entrega de claves. |
name |
string |
Descripción de la opción de directiva. |
policyOptionId |
string |
Identificador de opción de directiva heredado. |
restriction | ContentKeyPolicyRestriction: |
Requisitos que se deben cumplir para entregar claves con esta configuración |
ContentKeyPolicyPlayReadyConfiguration
Especifica una configuración para las licencias de PlayReady.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
licenses |
Las licencias de PlayReady. |
|
responseCustomData |
string |
Datos de respuesta personalizados. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Especifica que el identificador de clave de contenido está en el encabezado PlayReady.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Especifica que el identificador de clave de contenido se especifica en la configuración de PlayReady.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
keyId |
string |
Identificador de clave de contenido. |
ContentKeyPolicyPlayReadyContentType
Tipo de contenido PlayReady.
Nombre | Tipo | Description |
---|---|---|
UltraVioletDownload |
string |
Tipo de contenido de descarga ultravioleta. |
UltraVioletStreaming |
string |
Tipo de contenido de streaming ultravioleta. |
Unknown |
string |
Representa un ContentKeyPolicyPlayReadyContentType que no está disponible en la versión actual de la API. |
Unspecified |
string |
Tipo de contenido no especificado. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Configura los bits de control Explicit Analog Television Output Restriction. Para obtener más información, consulte Reglas de cumplimiento de PlayReady.
Nombre | Tipo | Description |
---|---|---|
bestEffort |
boolean |
Indica si esta restricción se aplica según el mejor esfuerzo. |
configurationData |
integer |
Configura los bits de control de restricción. Debe estar comprendido entre 0 y 3 inclusive. |
ContentKeyPolicyPlayReadyLicense
La licencia de PlayReady
Nombre | Tipo | Description |
---|---|---|
allowTestDevices |
boolean |
Marca que indica si los dispositivos de prueba pueden usar la licencia. |
beginDate |
string |
La fecha de inicio de la licencia |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Ubicación de la clave de contenido. |
contentType |
Tipo de contenido de PlayReady. |
|
expirationDate |
string |
Fecha de expiración de la licencia. |
gracePeriod |
string |
Período de gracia de licencia. |
licenseType |
Tipo de licencia. |
|
playRight |
La licencia PlayRight |
|
relativeBeginDate |
string |
Fecha de inicio relativa de la licencia. |
relativeExpirationDate |
string |
Fecha de expiración relativa de la licencia. |
securityLevel |
Nivel de seguridad. |
ContentKeyPolicyPlayReadyLicenseType
Tipo de licencia.
Nombre | Tipo | Description |
---|---|---|
NonPersistent |
string |
Licencia no persistente. |
Persistent |
string |
Licencia persistente. Permite la reproducción sin conexión. |
Unknown |
string |
Representa un ContentKeyPolicyPlayReadyLicenseType que no está disponible en la versión actual de la API. |
ContentKeyPolicyPlayReadyPlayRight
Configura la opción Play Right en la licencia de PlayReady.
Nombre | Tipo | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Configura Control de ganancia automática (AGC) y Franja de color en la licencia. Debe estar comprendido entre 0 y 3 inclusive. |
allowPassingVideoContentToUnknownOutput |
Configura los valores de control de salida desconocidos de la licencia. |
|
analogVideoOpl |
integer |
Especifica el nivel de protección de salida para el audio digital comprimido. |
compressedDigitalAudioOpl |
integer |
Especifica el nivel de protección de salida para el audio digital comprimido. |
compressedDigitalVideoOpl |
integer |
Especifica el nivel de protección de salida para el vídeo digital comprimido. |
digitalVideoOnlyContentRestriction |
boolean |
Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia. |
explicitAnalogTelevisionOutputRestriction |
Content |
Configura la restricción explícita de salida de televisión analógica en la licencia. Los datos de configuración deben estar comprendidos entre 0 y 3 incluidos. |
firstPlayExpiration |
string |
Cantidad de tiempo que la licencia es válida después de que la licencia se use por primera vez para reproducir contenido. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Habilita la restricción image para la restricción de vídeo de componente analógico en la licencia. |
scmsRestriction |
integer |
Configura el Sistema de administración de copias serie (SCMS) en la licencia. Debe estar comprendido entre 0 y 3 inclusive. |
uncompressedDigitalAudioOpl |
integer |
Especifica el nivel de protección de salida para el audio digital sin comprimir. |
uncompressedDigitalVideoOpl |
integer |
Especifica el nivel de protección de salida para el vídeo digital sin comprimir. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Configura los valores de control de salida desconocidos de la licencia.
Nombre | Tipo | Description |
---|---|---|
Allowed |
string |
Se permite pasar la parte de vídeo del contenido protegido a una salida desconocida. |
AllowedWithVideoConstriction |
string |
Se permite pasar la parte de vídeo del contenido protegido a una salida desconocida, pero con una resolución restringida. |
NotAllowed |
string |
No se permite pasar la parte de vídeo del contenido protegido a una salida desconocida. |
Unknown |
string |
Representa un ContentKeyPolicyPlayReadyUnknownOutputPassingOption que no está disponible en la versión actual de la API. |
ContentKeyPolicyRestrictionTokenType
Tipo de token.
Nombre | Tipo | Description |
---|---|---|
Jwt |
string |
JSON Web Token. |
Swt |
string |
Token web simple. |
Unknown |
string |
Representa un ContentKeyPolicyRestrictionTokenType que no está disponible en la versión actual de la API. |
ContentKeyPolicyRsaTokenKey
Especifica una clave RSA para la validación de tokens.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
exponent |
string |
Exponente de parámetros RSA |
modulus |
string |
Módulo de parámetros RSA |
ContentKeyPolicySymmetricTokenKey
Especifica una clave simétrica para la validación de tokens.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
keyValue |
string |
Valor de clave de la clave |
ContentKeyPolicyTokenClaim
Representa una notificación de token.
Nombre | Tipo | Description |
---|---|---|
claimType |
string |
Tipo de notificación de token. |
claimValue |
string |
Valor de notificación de token. |
ContentKeyPolicyTokenRestriction
Representa una restricción de token. El token proporcionado debe coincidir con estos requisitos para la entrega correcta de licencias o claves.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Lista de claves de verificación alternativas. |
audience |
string |
Audiencia del token. |
issuer |
string |
Emisor del token. |
openIdConnectDiscoveryDocument |
string |
Documento de detección de Conexión de OpenID. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Clave de comprobación principal. |
requiredClaims |
Lista de notificaciones de token necesarias. |
|
restrictionTokenType |
Tipo de token. |
ContentKeyPolicyUnknownConfiguration
Representa una contentKeyPolicyConfiguration que no está disponible en la versión actual de la API.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ContentKeyPolicyUnknownRestriction
Representa una contentKeyPolicyRestriction que no está disponible en la versión actual de la API.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
ContentKeyPolicyWidevineConfiguration
Especifica una configuración para las licencias de Widevine.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
widevineTemplate |
string |
Plantilla de Widevine. |
ContentKeyPolicyX509CertificateTokenKey
Especifica un certificado para la validación de tokens.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
rawBody |
string |
El campo de datos sin procesar de un certificado en formato PKCS 12 (X509Certificate2 en .NET) |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
SecurityLevel
Nivel de seguridad.
Nombre | Tipo | Description |
---|---|---|
SL150 |
string |
Para los clientes en desarrollo o pruebas. Sin protección contra el uso no autorizado. |
SL2000 |
string |
Para dispositivos y aplicaciones protegidos que consumen contenido comercial. Protección de software o hardware. |
SL3000 |
string |
Solo para dispositivos protegidos. Protección de hardware. |
Unknown |
string |
Representa un securityLevel que no está disponible en la versión actual de la API. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |