Content Key Policies - Update
Uppdatera en innehållsnyckelprincip
Uppdateringar en befintlig innehållsnyckelprincip i Media Services-kontot
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Namnet på Media Services-kontot. |
content
|
path | True |
string |
Namn på innehållsnyckelprincip. |
resource
|
path | True |
string |
Namnet på resursgruppen i Azure-prenumerationen. |
subscription
|
path | True |
string |
Den unika identifieraren för en Microsoft Azure-prenumeration. |
api-version
|
query | True |
string |
Den version av API:et som ska användas med klientbegäran. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
properties.options | True |
Alternativen för nyckelprincip. |
|
properties.description |
string |
En beskrivning av principen. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Detaljerad felinformation. |
Exempel
Update a Content Key Policy
Exempelbegäran
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"
}
}
]
}
}
Exempelsvar
{
"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"
}
}
]
}
}
Definitioner
Name | Description |
---|---|
Content |
En principresurs för innehållsnyckel. |
Content |
Representerar en konfiguration för icke-DRM-nycklar. |
Content |
Anger en konfiguration för FairPlay-licenser. |
Content |
|
Content |
Nyckeltypen för uthyrning och lån. |
Content |
Representerar en öppen begränsning. Licens eller nyckel levereras på varje begäran. |
Content |
Representerar ett principalternativ. |
Content |
Anger en konfiguration för PlayReady-licenser. |
Content |
Anger att innehållsnyckelns ID finns i PlayReady-huvudet. |
Content |
Anger att innehållsnyckelns ID anges i PlayReady-konfigurationen. |
Content |
Innehållstypen PlayReady. |
Content |
Konfigurerar kontrollbitarna explicit analog tv-utdatabegränsning. Mer information finns i Efterlevnadsregler för PlayReady. |
Content |
PlayReady-licensen |
Content |
Licenstypen. |
Content |
Konfigurerar Uppspelningsrätt i PlayReady-licensen. |
Content |
Konfigurerar inställningar för okänd utdatahantering för licensen. |
Content |
Typ av token. |
Content |
Anger en RSA-nyckel för tokenverifiering |
Content |
Anger en symmetrisk nyckel för tokenvalidering. |
Content |
Representerar ett tokenanspråk. |
Content |
Representerar en tokenbegränsning. Den angivna token måste matcha dessa krav för lyckad licens eller nyckelleverans. |
Content |
Representerar en ContentKeyPolicyConfiguration som inte är tillgänglig i den aktuella API-versionen. |
Content |
Representerar en ContentKeyPolicyRestriction som inte är tillgänglig i den aktuella API-versionen. |
Content |
Anger en konfiguration för Widevine-licenser. |
Content |
Anger ett certifikat för tokenverifiering. |
created |
Den typ av identitet som skapade resursen. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Security |
Säkerhetsnivån. |
system |
Metadata som rör skapande och senaste ändring av resursen. |
ContentKeyPolicy
En principresurs för innehållsnyckel.
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Namnet på resursen |
properties.created |
string |
Datumet då principen skapades |
properties.description |
string |
En beskrivning av principen. |
properties.lastModified |
string |
Det senast ändrade datumet för principen |
properties.options |
Alternativen för nyckelprincip. |
|
properties.policyId |
string |
Det äldre princip-ID:t. |
systemData |
Systemmetadata som är relaterade till den här resursen. |
|
type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
Representerar en konfiguration för icke-DRM-nycklar.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
ContentKeyPolicyFairPlayConfiguration
Anger en konfiguration för FairPlay-licenser.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
ask |
string |
Nyckeln som måste användas som FairPlay Application Secret-nyckel. Detta måste vara base64-kodat. |
fairPlayPfx |
string |
Base64-representationen av FairPlay-certifikatet i PKCS 12-format (pfx) (inklusive privat nyckel). |
fairPlayPfxPassword |
string |
Lösenordet som krypterar FairPlay-certifikatet i PKCS 12-format (pfx). |
offlineRentalConfiguration |
Offlineuthyrningsprincip |
|
rentalAndLeaseKeyType |
Nyckeltypen för uthyrning och lån. |
|
rentalDuration |
integer |
Hyrestiden. Måste vara större än eller lika med 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | Typ | Description |
---|---|---|
playbackDurationSeconds |
integer |
Uppspelningstid |
storageDurationSeconds |
integer |
Lagringstid |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Nyckeltypen för uthyrning och lån.
Name | Typ | Description |
---|---|---|
DualExpiry |
string |
Dubbel förfallodatum för offlineuthyrning. |
PersistentLimited |
string |
Innehållsnyckeln kan bevaras och den giltiga varaktigheten begränsas av värdet för hyresvaraktighet |
PersistentUnlimited |
string |
Innehållsnyckeln kan sparas med obegränsad varaktighet |
Undefined |
string |
Nyckelvaraktighet har inte angetts. |
Unknown |
string |
Representerar en ContentKeyPolicyFairPlayRentalAndLeaseKeyType som inte är tillgänglig i den aktuella API-versionen. |
ContentKeyPolicyOpenRestriction
Representerar en öppen begränsning. Licens eller nyckel levereras på varje begäran.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
ContentKeyPolicyOption
Representerar ett principalternativ.
Name | Typ | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Konfiguration av nyckelleverans. |
name |
string |
Beskrivning av principalternativ. |
policyOptionId |
string |
Det äldre principalternativ-ID:t. |
restriction | ContentKeyPolicyRestriction: |
De krav som måste uppfyllas för att leverera nycklar med den här konfigurationen |
ContentKeyPolicyPlayReadyConfiguration
Anger en konfiguration för PlayReady-licenser.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
licenses |
PlayReady-licenserna. |
|
responseCustomData |
string |
Anpassade svarsdata. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Anger att innehållsnyckelns ID finns i PlayReady-huvudet.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator för härledda typer. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Anger att innehållsnyckelns ID anges i PlayReady-konfigurationen.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator för härledda typer. |
keyId |
string |
Innehållsnyckelns ID. |
ContentKeyPolicyPlayReadyContentType
Innehållstypen PlayReady.
Name | Typ | Description |
---|---|---|
UltraVioletDownload |
string |
Ultraviolett nedladdningsinnehållstyp. |
UltraVioletStreaming |
string |
Ultraviolett strömmande innehållstyp. |
Unknown |
string |
Representerar en ContentKeyPolicyPlayReadyContentType som inte är tillgänglig i den aktuella API-versionen. |
Unspecified |
string |
Ospecificerad innehållstyp. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Konfigurerar kontrollbitarna explicit analog tv-utdatabegränsning. Mer information finns i Efterlevnadsregler för PlayReady.
Name | Typ | Description |
---|---|---|
bestEffort |
boolean |
Anger om den här begränsningen tillämpas enligt bästa förmåga. |
configurationData |
integer |
Konfigurerar bitarna för begränsningskontroll. Måste vara mellan 0 och 3 inklusiv. |
ContentKeyPolicyPlayReadyLicense
PlayReady-licensen
Name | Typ | Description |
---|---|---|
allowTestDevices |
boolean |
En flagga som anger om testenheter kan använda licensen. |
beginDate |
string |
Licensens startdatum |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Platsen för innehållsnyckeln. |
contentType |
Innehållstypen PlayReady. |
|
expirationDate |
string |
Förfallodatumet för licensen. |
gracePeriod |
string |
Respitperioden för licensen. |
licenseType |
Licenstypen. |
|
playRight |
Licensen PlayRight |
|
relativeBeginDate |
string |
Det relativa startdatumet för licensen. |
relativeExpirationDate |
string |
Det relativa förfallodatumet för licensen. |
securityLevel |
Säkerhetsnivån. |
ContentKeyPolicyPlayReadyLicenseType
Licenstypen.
Name | Typ | Description |
---|---|---|
NonPersistent |
string |
Icke-beständig licens. |
Persistent |
string |
Beständiga licenser. Tillåter offlineuppspelning. |
Unknown |
string |
Representerar en ContentKeyPolicyPlayReadyLicenseType som inte är tillgänglig i den aktuella API-versionen. |
ContentKeyPolicyPlayReadyPlayRight
Konfigurerar Uppspelningsrätt i PlayReady-licensen.
Name | Typ | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Konfigurerar AGC (Automatic Gain Control) och Color Stripe i licensen. Måste vara mellan 0 och 3 inklusiv. |
allowPassingVideoContentToUnknownOutput |
Konfigurerar inställningar för okänd utdatahantering för licensen. |
|
analogVideoOpl |
integer |
Anger utdataskyddsnivån för komprimerat digitalt ljud. |
compressedDigitalAudioOpl |
integer |
Anger utdataskyddsnivån för komprimerat digitalt ljud. |
compressedDigitalVideoOpl |
integer |
Anger utdataskyddsnivån för komprimerad digital video. |
digitalVideoOnlyContentRestriction |
boolean |
Aktiverar bildvillkoret för analog komponentvideobegränsning i licensen. |
explicitAnalogTelevisionOutputRestriction |
Content |
Konfigurerar den explicita utdatabegränsningen för analog tv i licensen. Konfigurationsdata måste vara mellan 0 och 3. |
firstPlayExpiration |
string |
Hur lång tid licensen är giltig efter att licensen först används för att spela upp innehåll. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Aktiverar bildvillkoret för analog komponentvideobegränsning i licensen. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Aktiverar bildvillkoret för analog komponentvideobegränsning i licensen. |
scmsRestriction |
integer |
Konfigurerar SCMS (Serial Copy Management System) i licensen. Måste vara mellan 0 och 3 inklusiv. |
uncompressedDigitalAudioOpl |
integer |
Anger utdataskyddsnivån för okomprimerat digitalt ljud. |
uncompressedDigitalVideoOpl |
integer |
Anger utdataskyddsnivån för okomprimerad digital video. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Konfigurerar inställningar för okänd utdatahantering för licensen.
Name | Typ | Description |
---|---|---|
Allowed |
string |
Det är tillåtet att skicka videodelen av skyddat innehåll till okända utdata. |
AllowedWithVideoConstriction |
string |
Det är tillåtet att skicka videodelen av skyddat innehåll till okända utdata, men med begränsad upplösning. |
NotAllowed |
string |
Det är inte tillåtet att skicka videodelen av skyddat innehåll till okända utdata. |
Unknown |
string |
Representerar ett ContentKeyPolicyPlayReadyUnknownOutputPassingOption som inte är tillgängligt i den aktuella API-versionen. |
ContentKeyPolicyRestrictionTokenType
Typ av token.
Name | Typ | Description |
---|---|---|
Jwt |
string |
JSON-webbtoken. |
Swt |
string |
Enkel webbtoken. |
Unknown |
string |
Representerar en ContentKeyPolicyRestrictionTokenType som inte är tillgänglig i den aktuella API-versionen. |
ContentKeyPolicyRsaTokenKey
Anger en RSA-nyckel för tokenverifiering
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator för härledda typer. |
exponent |
string |
RSA-parameterns exponent |
modulus |
string |
RSA-parametermodulen |
ContentKeyPolicySymmetricTokenKey
Anger en symmetrisk nyckel för tokenvalidering.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator för härledda typer. |
keyValue |
string |
Nyckelvärdet för nyckeln |
ContentKeyPolicyTokenClaim
Representerar ett tokenanspråk.
Name | Typ | Description |
---|---|---|
claimType |
string |
Typ av tokenanspråk. |
claimValue |
string |
Tokenanspråkvärde. |
ContentKeyPolicyTokenRestriction
Representerar en tokenbegränsning. Den angivna token måste matcha dessa krav för lyckad licens eller nyckelleverans.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
En lista över alternativa verifieringsnycklar. |
audience |
string |
Målgruppen för token. |
issuer |
string |
Token-utfärdaren. |
openIdConnectDiscoveryDocument |
string |
OpenID Connect-identifieringsdokumentet. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Den primära verifieringsnyckeln. |
requiredClaims |
En lista över nödvändiga tokenanspråk. |
|
restrictionTokenType |
Typ av token. |
ContentKeyPolicyUnknownConfiguration
Representerar en ContentKeyPolicyConfiguration som inte är tillgänglig i den aktuella API-versionen.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
ContentKeyPolicyUnknownRestriction
Representerar en ContentKeyPolicyRestriction som inte är tillgänglig i den aktuella API-versionen.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
ContentKeyPolicyWidevineConfiguration
Anger en konfiguration för Widevine-licenser.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskrimineringen för härledda typer. |
widevineTemplate |
string |
Widevine-mallen. |
ContentKeyPolicyX509CertificateTokenKey
Anger ett certifikat för tokenverifiering.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator för härledda typer. |
rawBody |
string |
Rådatafältet för ett certifikat i PKCS 12-format (X509Certificate2 i .NET) |
createdByType
Den typ av identitet som skapade resursen.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Den ytterligare informationstypen. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
SecurityLevel
Säkerhetsnivån.
Name | Typ | Description |
---|---|---|
SL150 |
string |
För klienter under utveckling eller testning. Inget skydd mot obehörig användning. |
SL2000 |
string |
För härdade enheter och program som använder kommersiellt innehåll. Program- eller maskinvaruskydd. |
SL3000 |
string |
Endast för härdade enheter. Maskinvaruskydd. |
Unknown |
string |
Representerar en SecurityLevel som inte är tillgänglig i den aktuella API-versionen. |
systemData
Metadata som rör skapande och senaste ändring av resursen.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Tidsstämpeln för resursskapande (UTC). |
createdBy |
string |
Identiteten som skapade resursen. |
createdByType |
Den typ av identitet som skapade resursen. |
|
lastModifiedAt |
string |
Tidsstämpeln för resursens senaste ändring (UTC) |
lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |