Content Key Policies - Get
Ottenere un criterio chiave di contenuto
Ottenere i dettagli di un criterio della chiave di contenuto nell'account Servizi multimediali
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di Servizi multimediali. |
content
|
path | True |
string |
Nome criterio chiave contenuto. |
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione di Azure. |
subscription
|
path | True |
string |
Identificatore univoco per una sottoscrizione di Microsoft Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Informazioni dettagliate sull'errore. |
Esempio
Get a Content Key Policy by name
Esempio di richiesta
Risposta di esempio
{
"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"
}
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Content |
Risorsa Criteri chiave contenuto. |
Content |
Rappresenta una configurazione per chiavi non DRM. |
Content |
Specifica una configurazione per le licenze FairPlay. |
Content |
|
Content |
Tipo di chiave di noleggio e lease. |
Content |
Rappresenta una restrizione aperta. La licenza o la chiave verranno recapitate in ogni richiesta. |
Content |
Rappresenta un'opzione di criteri. |
Content |
Specifica una configurazione per le licenze PlayReady. |
Content |
Specifica che l'ID chiave di contenuto si trova nell'intestazione PlayReady. |
Content |
Specifica che l'ID chiave di contenuto viene specificato nella configurazione PlayReady. |
Content |
Tipo di contenuto PlayReady. |
Content |
Configura i bit di restrizione dell'output analogico esplicito. Per ulteriori dettagli, vedere Le regole di conformità PlayReady. |
Content |
Licenza PlayReady |
Content |
Tipo di licenza. |
Content |
Configura Play Right nella licenza PlayReady. |
Content |
Configura le impostazioni di gestione dell'output sconosciute della licenza. |
Content |
Tipo di token. |
Content |
Specifica una chiave RSA per la convalida del token |
Content |
Specifica una chiave simmetrica per la convalida del token. |
Content |
Rappresenta un'attestazione del token. |
Content |
Rappresenta una restrizione del token. Il token specificato deve corrispondere a questi requisiti per il recapito di licenze o chiavi riuscite. |
Content |
Rappresenta un ContentKeyPolicyConfiguration non disponibile nella versione dell'API corrente. |
Content |
Rappresenta un oggetto ContentKeyPolicyRestriction non disponibile nella versione dell'API corrente. |
Content |
Specifica una configurazione per le licenze Widevine. |
Content |
Specifica un certificato per la convalida del token. |
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Security |
Livello di sicurezza. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
ContentKeyPolicy
Risorsa Criteri chiave contenuto.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nome della risorsa. |
properties.created |
string |
Data di creazione dei criteri |
properties.description |
string |
Descrizione dei criteri. |
properties.lastModified |
string |
Data dell'ultima modifica dei criteri |
properties.options |
Le opzioni dei criteri di chiave. |
|
properties.policyId |
string |
L'ID dei criteri legacy. |
systemData |
Metadati di sistema relativi a questa risorsa. |
|
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
Rappresenta una configurazione per chiavi non DRM.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ContentKeyPolicyFairPlayConfiguration
Specifica una configurazione per le licenze FairPlay.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ask |
string |
Chiave che deve essere usata come chiave segreta dell'applicazione FairPlay. Questa operazione deve essere codificata in base64. |
fairPlayPfx |
string |
Rappresentazione base64 del certificato FairPlay nel formato PKCS 12 (pfx) (inclusa la chiave privata). |
fairPlayPfxPassword |
string |
Password che crittografa il certificato FairPlay in formato PKCS 12 (pfx). |
offlineRentalConfiguration |
Criteri di noleggio offline |
|
rentalAndLeaseKeyType |
Tipo di chiave di noleggio e lease. |
|
rentalDuration |
integer |
Durata del noleggio. Deve essere maggiore o uguale a 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Nome | Tipo | Descrizione |
---|---|---|
playbackDurationSeconds |
integer |
Durata della riproduzione |
storageDurationSeconds |
integer |
Durata dell'archiviazione |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Tipo di chiave di noleggio e lease.
Nome | Tipo | Descrizione |
---|---|---|
DualExpiry |
string |
Scadenza doppia per il noleggio offline. |
PersistentLimited |
string |
La chiave di contenuto può essere persistente e la durata valida è limitata dal valore di durata del noleggio |
PersistentUnlimited |
string |
La chiave di contenuto può essere mantenuta con una durata illimitata |
Undefined |
string |
La durata della chiave non è specificata. |
Unknown |
string |
Rappresenta un ContentKeyPolicyFairPlayRentalAndLeaseKeyType non disponibile nella versione dell'API corrente. |
ContentKeyPolicyOpenRestriction
Rappresenta una restrizione aperta. La licenza o la chiave verranno recapitate in ogni richiesta.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ContentKeyPolicyOption
Rappresenta un'opzione di criteri.
Nome | Tipo | Descrizione |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Configurazione del recapito delle chiavi. |
name |
string |
Descrizione dell'opzione criteri. |
policyOptionId |
string |
ID opzione criteri legacy. |
restriction | ContentKeyPolicyRestriction: |
Requisiti che devono essere soddisfatti per recapitare chiavi con questa configurazione |
ContentKeyPolicyPlayReadyConfiguration
Specifica una configurazione per le licenze PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
licenses |
Licenze PlayReady. |
|
responseCustomData |
string |
Dati di risposta personalizzati. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Specifica che l'ID chiave di contenuto si trova nell'intestazione PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Specifica che l'ID chiave di contenuto viene specificato nella configurazione PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
keyId |
string |
ID chiave di contenuto. |
ContentKeyPolicyPlayReadyContentType
Tipo di contenuto PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
UltraVioletDownload |
string |
Tipo di contenuto di download ultravioletto. |
UltraVioletStreaming |
string |
Tipo di contenuto di streaming ultravioletto. |
Unknown |
string |
Rappresenta un contentKeyPolicyPlayReadyContentType non disponibile nella versione dell'API corrente. |
Unspecified |
string |
Tipo di contenuto non specificato. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Configura i bit di restrizione dell'output analogico esplicito. Per ulteriori dettagli, vedere Le regole di conformità PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
bestEffort |
boolean |
Indica se questa restrizione viene applicata su base consigliata. |
configurationData |
integer |
Configura i bit di controllo di restrizione. Deve essere compreso tra 0 e 3 inclusi. |
ContentKeyPolicyPlayReadyLicense
Licenza PlayReady
Nome | Tipo | Descrizione |
---|---|---|
allowTestDevices |
boolean |
Flag che indica se i dispositivi di test possono usare la licenza. |
beginDate |
string |
Data di inizio della licenza |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Percorso della chiave di contenuto. |
contentType |
Tipo di contenuto PlayReady. |
|
expirationDate |
string |
Data di scadenza della licenza. |
gracePeriod |
string |
Periodo di tolleranza della licenza. |
licenseType |
Tipo di licenza. |
|
playRight |
Licenza PlayRight |
|
relativeBeginDate |
string |
Data di inizio relativa della licenza. |
relativeExpirationDate |
string |
Data di scadenza relativa della licenza. |
securityLevel |
Livello di sicurezza. |
ContentKeyPolicyPlayReadyLicenseType
Tipo di licenza.
Nome | Tipo | Descrizione |
---|---|---|
NonPersistent |
string |
Licenza non persistente. |
Persistent |
string |
Licenza persistente. Consente la riproduzione offline. |
Unknown |
string |
Rappresenta un contentKeyPolicyPlayReadyLicenseType non disponibile nella versione dell'API corrente. |
ContentKeyPolicyPlayReadyPlayRight
Configura Play Right nella licenza PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
agcAndColorStripeRestriction |
integer |
Configura il controllo del guadagno automatico (AGC) e La striscia colore nella licenza. Deve essere compreso tra 0 e 3 inclusi. |
allowPassingVideoContentToUnknownOutput |
Configura le impostazioni di gestione dell'output sconosciute della licenza. |
|
analogVideoOpl |
integer |
Specifica il livello di protezione di output per l'audio digitale compresso. |
compressedDigitalAudioOpl |
integer |
Specifica il livello di protezione di output per l'audio digitale compresso. |
compressedDigitalVideoOpl |
integer |
Specifica il livello di protezione di output per il video digitale compresso. |
digitalVideoOnlyContentRestriction |
boolean |
Abilita il vincolo immagine per la restrizione video del componente analogico nella licenza. |
explicitAnalogTelevisionOutputRestriction |
Content |
Configura la restrizione esplicita dell'output della televisione analogica nella licenza. I dati di configurazione devono essere compresi tra 0 e 3. |
firstPlayExpiration |
string |
Tempo di validità della licenza dopo che la licenza viene usata per la prima volta per riprodurre il contenuto. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Abilita il vincolo immagine per la restrizione video del componente analogico nella licenza. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Abilita il vincolo immagine per la restrizione video del componente analogico nella licenza. |
scmsRestriction |
integer |
Configura il sistema di gestione della copia seriale (SCMS) nella licenza. Deve essere compreso tra 0 e 3 inclusi. |
uncompressedDigitalAudioOpl |
integer |
Specifica il livello di protezione di output per l'audio digitale non compresso. |
uncompressedDigitalVideoOpl |
integer |
Specifica il livello di protezione di output per il video digitale non compresso. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Configura le impostazioni di gestione dell'output sconosciute della licenza.
Nome | Tipo | Descrizione |
---|---|---|
Allowed |
string |
È consentito passare la parte video del contenuto protetto a un output sconosciuto. |
AllowedWithVideoConstriction |
string |
Il passaggio della parte video del contenuto protetto a un output sconosciuto è consentito ma con risoluzione vincolata. |
NotAllowed |
string |
Non è consentito passare la parte video del contenuto protetto a un output sconosciuto. |
Unknown |
string |
Rappresenta un oggetto ContentKeyPolicyPlayReadyUnknownOutputPassingOption non disponibile nella versione dell'API corrente. |
ContentKeyPolicyRestrictionTokenType
Tipo di token.
Nome | Tipo | Descrizione |
---|---|---|
Jwt |
string |
Token Web JSON. |
Swt |
string |
Token Web semplice. |
Unknown |
string |
Rappresenta un ContentKeyPolicyRestrictionTokenType non disponibile nella versione dell'API corrente. |
ContentKeyPolicyRsaTokenKey
Specifica una chiave RSA per la convalida del token
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
exponent |
string |
Esponente del parametro RSA |
modulus |
string |
Modulo del parametro RSA |
ContentKeyPolicySymmetricTokenKey
Specifica una chiave simmetrica per la convalida del token.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
keyValue |
string |
Valore chiave della chiave |
ContentKeyPolicyTokenClaim
Rappresenta un'attestazione del token.
Nome | Tipo | Descrizione |
---|---|---|
claimType |
string |
Tipo di attestazione del token. |
claimValue |
string |
Valore attestazione token. |
ContentKeyPolicyTokenRestriction
Rappresenta una restrizione del token. Il token specificato deve corrispondere a questi requisiti per il recapito di licenze o chiavi riuscite.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Elenco di chiavi di verifica alternative. |
audience |
string |
Destinatari del token. |
issuer |
string |
Autorità di certificazione del token. |
openIdConnectDiscoveryDocument |
string |
Documento di individuazione di OpenID connect. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Chiave di verifica primaria. |
requiredClaims |
Elenco delle attestazioni di token necessarie. |
|
restrictionTokenType |
Tipo di token. |
ContentKeyPolicyUnknownConfiguration
Rappresenta un ContentKeyPolicyConfiguration non disponibile nella versione dell'API corrente.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ContentKeyPolicyUnknownRestriction
Rappresenta un oggetto ContentKeyPolicyRestriction non disponibile nella versione dell'API corrente.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
ContentKeyPolicyWidevineConfiguration
Specifica una configurazione per le licenze Widevine.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
widevineTemplate |
string |
Modello Widevine. |
ContentKeyPolicyX509CertificateTokenKey
Specifica un certificato per la convalida del token.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminazione per i tipi derivati. |
rawBody |
string |
Campo dati non elaborato di un certificato in formato PKCS 12 (X509Certificate2 in .NET) |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
SecurityLevel
Livello di sicurezza.
Nome | Tipo | Descrizione |
---|---|---|
SL150 |
string |
Per i client in fase di sviluppo o test. Nessuna protezione contro l'uso non autorizzato. |
SL2000 |
string |
Per dispositivi e applicazioni con protezione avanzata che usano contenuto commerciale. Protezione software o hardware. |
SL3000 |
string |
Solo per i dispositivi con protezione avanzata. Protezione hardware. |
Unknown |
string |
Rappresenta un valore SecurityLevel non disponibile nella versione dell'API corrente. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima risorsa. |