Content Key Policies - Update
Aggiornare i criteri della chiave di contenuto
Aggiornamenti criteri di chiave di contenuto esistenti nell'account Servizi multimediali
PATCH 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. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
properties.options | True |
Le opzioni dei criteri di chiave. |
|
properties.description |
string |
Descrizione dei criteri. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Informazioni dettagliate sull'errore. |
Esempio
Update a Content Key Policy
Esempio di richiesta
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/contentKeyPolicies/PolicyWithClearKeyOptionAndTokenRestriction?api-version=2022-08-01
{
"properties": {
"description": "Updated Policy",
"options": [
{
"name": "ClearKeyOption",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
}
}
]
}
}
Risposta di esempio
{
"name": "PolicyWithClearKeyOptionAndTokenRestriction",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/contentKeyPolicies/PolicyWithClearKeyOptionAndTokenRestriction",
"type": "Microsoft.Media/mediaservices/contentKeyPolicies",
"properties": {
"policyId": "8352435b-ebea-4681-aae7-e19277771f64",
"created": "2017-12-01T00:00:00Z",
"lastModified": "2018-08-08T18:29:30.303Z",
"description": "Updated Policy",
"options": [
{
"policyOptionId": "7d3f4bc1-d2bf-43a3-b02e-a7e31ab15d43",
"name": "ClearKeyOption",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
}
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Content |
Risorsa Criteri chiave simmetrica. |
Content |
Rappresenta una configurazione per le 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 a 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 di token. |
Content |
Rappresenta una restrizione del token. Il token fornito deve corrispondere a questi requisiti per la corretta distribuzione di licenze o chiavi. |
Content |
Rappresenta un oggetto 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 sull'errore di 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 simmetrica.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ad esempio - /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 le chiavi non DRM.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio per i tipi derivati. |
ContentKeyPolicyFairPlayConfiguration
Specifica una configurazione per le licenze FairPlay.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio per i tipi derivati. |
ask |
string |
Chiave che deve essere usata come chiave privata dell'applicazione FairPlay. Deve essere codificato in base64. |
fairPlayPfx |
string |
Rappresentazione base64 del certificato FairPlay in 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 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 simmetrica può essere persistente e la durata valida è limitata dal valore Durata noleggio |
PersistentUnlimited |
string |
La chiave simmetrica può essere mantenuta con una durata illimitata |
Undefined |
string |
La durata della chiave non è specificata. |
Unknown |
string |
Rappresenta un oggetto ContentKeyPolicyFairPlayRentalAndLeaseKeyType non disponibile nella versione corrente dell'API. |
ContentKeyPolicyOpenRestriction
Rappresenta una restrizione aperta. La licenza o la chiave verranno recapitate a ogni richiesta.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio 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 le chiavi con questa configurazione |
ContentKeyPolicyPlayReadyConfiguration
Specifica una configurazione per le licenze PlayReady.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio 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 simmetrica. |
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 oggetto ContentKeyPolicyRestrictionTokenType non disponibile nella versione corrente dell'API. |
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 di token.
Nome | Tipo | Descrizione |
---|---|---|
claimType |
string |
Tipo di attestazione del token. |
claimValue |
string |
Valore attestazione token. |
ContentKeyPolicyTokenRestriction
Rappresenta una restrizione del token. Il token fornito deve corrispondere a questi requisiti per la corretta distribuzione di licenze o chiavi.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio per i tipi derivati. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Elenco di chiavi di verifica alternative. |
audience |
string |
Destinatari del token. |
issuer |
string |
Autorità emittente del token. |
openIdConnectDiscoveryDocument |
string |
Documento di individuazione della connessione OpenID. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Chiave di verifica primaria. |
requiredClaims |
Elenco delle attestazioni di token necessarie. |
|
restrictionTokenType |
Tipo di token. |
ContentKeyPolicyUnknownConfiguration
Rappresenta un oggetto ContentKeyPolicyConfiguration non disponibile nella versione dell'API corrente.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio per i tipi derivati. |
ContentKeyPolicyUnknownRestriction
Rappresenta un oggetto ContentKeyPolicyRestriction non disponibile nella versione dell'API corrente.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio per i tipi derivati. |
ContentKeyPolicyWidevineConfiguration
Specifica una configurazione per le licenze Widevine.
Nome | Tipo | Descrizione |
---|---|---|
@odata.type |
string:
#Microsoft. |
Il discriminatorio 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 sull'errore di 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 volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |