Content Key Policies - Update
Tartalomkulcs-szabályzat frissítése
meglévő tartalomkulcs-szabályzat Frissítések a Media Services-fiókban
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
A Media Services-fiók neve. |
content
|
path | True |
string |
A tartalomkulcs-szabályzat neve. |
resource
|
path | True |
string |
Az Azure-előfizetésen belüli erőforráscsoport neve. |
subscription
|
path | True |
string |
A Microsoft Azure-előfizetés egyedi azonosítója. |
api-version
|
query | True |
string |
Az ügyfélkéréshez használni kívánt API verziója. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
properties.options | True |
A Kulcsszabályzat beállításai. |
|
properties.description |
string |
A szabályzat leírása. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Részletes hibainformációk. |
Példák
Update a Content Key Policy
Sample Request
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"
}
}
]
}
}
Sample Response
{
"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"
}
}
]
}
}
Definíciók
Name | Description |
---|---|
Content |
Tartalomkulcs-házirend-erőforrás. |
Content |
A nem DRM-kulcsok konfigurációját jelöli. |
Content |
A FairPlay-licencek konfigurációját adja meg. |
Content |
|
Content |
A bérleti és bérletkulcs típusa. |
Content |
Nyitott korlátozást jelöl. A licenc vagy kulcs minden kéréskor kézbesítve lesz. |
Content |
Egy szabályzatbeállítást jelöl. |
Content |
A PlayReady-licencek konfigurációját adja meg. |
Content |
Megadja, hogy a tartalomkulcs azonosítója a PlayReady fejlécben legyen. |
Content |
Megadja, hogy a tartalomkulcs azonosítója meg legyen adva a PlayReady konfigurációjában. |
Content |
A PlayReady-tartalomtípus. |
Content |
Konfigurálja az Explicit Analóg televíziókimenet-korlátozás vezérlőbiteket. További részletekért lásd a PlayReady megfelelőségi szabályait. |
Content |
A PlayReady-licenc |
Content |
A licenc típusa. |
Content |
A PlayReady-licencben konfigurálja a lejátszási jogot. |
Content |
A licenc ismeretlen kimeneti kezelési beállításait konfigurálja. |
Content |
A token típusa. |
Content |
RSA-kulcsot ad meg a jogkivonat érvényesítéséhez |
Content |
Szimmetrikus kulcsot ad meg a jogkivonat érvényesítéséhez. |
Content |
Jogkivonat-jogcímet jelöl. |
Content |
Jogkivonat-korlátozást jelöl. A megadott jogkivonatnak meg kell felelnie ezeknek a követelményeknek a sikeres licenc- vagy kulcskézbesítéshez. |
Content |
Olyan ContentKeyPolicyConfiguration értéket jelöl, amely nem érhető el az aktuális API-verzióban. |
Content |
Olyan ContentKeyPolicyRestriction értéket jelöl, amely nem érhető el az aktuális API-verzióban. |
Content |
A Widevine-licencek konfigurációját adja meg. |
Content |
Egy tanúsítványt ad meg a jogkivonat érvényesítéséhez. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Security |
A biztonsági szint. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
ContentKeyPolicy
Tartalomkulcs-házirend-erőforrás.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Az erőforrás neve |
properties.created |
string |
A szabályzat létrehozásának dátuma |
properties.description |
string |
A szabályzat leírása. |
properties.lastModified |
string |
A szabályzat utolsó módosítási dátuma |
properties.options |
A Kulcsszabályzat beállításai. |
|
properties.policyId |
string |
Az örökölt szabályzatazonosító. |
systemData |
Az erőforráshoz kapcsolódó rendszer metaadatai. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
A nem DRM-kulcsok konfigurációját jelöli.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ContentKeyPolicyFairPlayConfiguration
A FairPlay-licencek konfigurációját adja meg.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ask |
string |
A FairPlay alkalmazás titkos kulcsaként használandó kulcs. Ennek base64 kódolásúnak kell lennie. |
fairPlayPfx |
string |
A FairPlay-tanúsítvány Base64-reprezentációja PKCS 12 (pfx) formátumban (beleértve a titkos kulcsot is). |
fairPlayPfxPassword |
string |
A FairPlay-tanúsítvány titkosításának jelszava PKCS 12 (pfx) formátumban. |
offlineRentalConfiguration |
Offline bérleti szabályzat |
|
rentalAndLeaseKeyType |
A bérleti és bérletkulcs típusa. |
|
rentalDuration |
integer |
A bérleti időtartam. Nem lehet kisebb, mint 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | Típus | Description |
---|---|---|
playbackDurationSeconds |
integer |
Lejátszási időtartam |
storageDurationSeconds |
integer |
Tárolási időtartam |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
A bérleti és bérletkulcs típusa.
Name | Típus | Description |
---|---|---|
DualExpiry |
string |
Kettős lejárat offline kölcsönzés esetén. |
PersistentLimited |
string |
A tartalomkulcs megőrizhető, és az érvényes időtartamot a Bérleti időtartam érték korlátozza |
PersistentUnlimited |
string |
A tartalomkulcs korlátlan időtartammal megőrizhető |
Undefined |
string |
A kulcs időtartama nincs megadva. |
Unknown |
string |
Az aktuális API-verzióban nem elérhető ContentKeyPolicyFairPlayRentalAndLeaseKeyType értéket jelöli. |
ContentKeyPolicyOpenRestriction
Nyitott korlátozást jelöl. A licenc vagy kulcs minden kéréskor kézbesítve lesz.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ContentKeyPolicyOption
Egy szabályzatbeállítást jelöl.
Name | Típus | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
A kulcskézbesítési konfiguráció. |
name |
string |
A Házirend beállítás leírása. |
policyOptionId |
string |
Az örökölt szabályzatbeállítás azonosítója. |
restriction | ContentKeyPolicyRestriction: |
Az ezzel a konfigurációval rendelkező kulcsok kézbesítéséhez teljesítendő követelmények |
ContentKeyPolicyPlayReadyConfiguration
A PlayReady-licencek konfigurációját adja meg.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
licenses |
A PlayReady-licencek. |
|
responseCustomData |
string |
Az egyéni válaszadatok. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Megadja, hogy a tartalomkulcs azonosítója a PlayReady fejlécben legyen.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Megadja, hogy a tartalomkulcs azonosítója meg legyen adva a PlayReady konfigurációjában.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
keyId |
string |
A tartalomkulcs azonosítója. |
ContentKeyPolicyPlayReadyContentType
A PlayReady-tartalomtípus.
Name | Típus | Description |
---|---|---|
UltraVioletDownload |
string |
Ultraibolya letöltési tartalomtípus. |
UltraVioletStreaming |
string |
Ultraibolya streamelési tartalomtípus. |
Unknown |
string |
Olyan ContentKeyPolicyPlayReadyContentType típust jelöl, amely nem érhető el az aktuális API-verzióban. |
Unspecified |
string |
Meghatározatlan tartalomtípus. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Konfigurálja az Explicit Analóg televíziókimenet-korlátozás vezérlőbiteket. További részletekért lásd a PlayReady megfelelőségi szabályait.
Name | Típus | Description |
---|---|---|
bestEffort |
boolean |
Azt jelzi, hogy a korlátozás kényszerítve van-e a Legjobb erőfeszítés alapján. |
configurationData |
integer |
Konfigurálja a korlátozásvezérlő biteket. 0 és 3 közötti értéknek kell lennie. |
ContentKeyPolicyPlayReadyLicense
A PlayReady-licenc
Name | Típus | Description |
---|---|---|
allowTestDevices |
boolean |
Egy jelző, amely jelzi, hogy a teszteszközök használhatják-e a licencet. |
beginDate |
string |
A licenc kezdő dátuma |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
A tartalomkulcs helye. |
contentType |
A PlayReady-tartalomtípus. |
|
expirationDate |
string |
A licenc lejárati dátuma. |
gracePeriod |
string |
A licenc türelmi időszaka. |
licenseType |
A licenc típusa. |
|
playRight |
A playRight licenc |
|
relativeBeginDate |
string |
A licenc relatív kezdő dátuma. |
relativeExpirationDate |
string |
A licenc relatív lejárati dátuma. |
securityLevel |
A biztonsági szint. |
ContentKeyPolicyPlayReadyLicenseType
A licenc típusa.
Name | Típus | Description |
---|---|---|
NonPersistent |
string |
Nem állandó licenc. |
Persistent |
string |
Állandó licenc. Engedélyezi az offline lejátszást. |
Unknown |
string |
Olyan ContentKeyPolicyPlayReadyLicenseType típust jelöl, amely nem érhető el az aktuális API-verzióban. |
ContentKeyPolicyPlayReadyPlayRight
A PlayReady-licencben konfigurálja a lejátszási jogot.
Name | Típus | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Konfigurálja az automatikus nyereségvezérlést (AGC) és a színcsíkot a licencben. 0 és 3 közötti értéknek kell lennie. |
allowPassingVideoContentToUnknownOutput |
A licenc ismeretlen kimeneti kezelési beállításait konfigurálja. |
|
analogVideoOpl |
integer |
Meghatározza a tömörített digitális hang kimeneti védelmi szintjét. |
compressedDigitalAudioOpl |
integer |
Meghatározza a tömörített digitális hang kimeneti védelmi szintjét. |
compressedDigitalVideoOpl |
integer |
Meghatározza a tömörített digitális videó kimeneti védelmi szintjét. |
digitalVideoOnlyContentRestriction |
boolean |
Engedélyezi az analóg összetevő videókorlátozásának képkényszerítését a licencben. |
explicitAnalogTelevisionOutputRestriction |
Content |
Konfigurálja az explicit analóg televíziókimeneti korlátozást a licencben. A konfigurációs adatoknak 0 és 3 közöttinek kell lenniük. |
firstPlayExpiration |
string |
Az az idő, amely után a licenc érvényes lesz a tartalom lejátszásához. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Engedélyezi az analóg összetevő videókorlátozásának képkényszerítését a licencben. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Engedélyezi az analóg összetevő videókorlátozásának képkényszerítését a licencben. |
scmsRestriction |
integer |
Konfigurálja a serial copy management system (SCMS) rendszert a licencben. 0 és 3 közötti értéknek kell lennie. |
uncompressedDigitalAudioOpl |
integer |
Meghatározza a tömörítetlen digitális hangkimenet védelmi szintjét. |
uncompressedDigitalVideoOpl |
integer |
Meghatározza a tömörítetlen digitális videók kimeneti védelmi szintjét. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
A licenc ismeretlen kimeneti kezelési beállításait konfigurálja.
Name | Típus | Description |
---|---|---|
Allowed |
string |
A védett tartalom videó részének ismeretlen kimenetnek való átadása engedélyezett. |
AllowedWithVideoConstriction |
string |
A védett tartalom videórészének ismeretlen kimenetnek való átadása engedélyezett, de korlátozott felbontással. |
NotAllowed |
string |
A védett tartalom videó részének ismeretlen kimenetnek való átadása nem engedélyezett. |
Unknown |
string |
A ContentKeyPolicyPlayReadyUnknownOutputPassingOption értéket jelöli, amely nem érhető el az aktuális API-verzióban. |
ContentKeyPolicyRestrictionTokenType
A token típusa.
Name | Típus | Description |
---|---|---|
Jwt |
string |
JSON webes jogkivonat. |
Swt |
string |
Egyszerű webes jogkivonat. |
Unknown |
string |
Olyan ContentKeyPolicyRestrictionTokenType értéket jelöl, amely nem érhető el az AKTUÁLIS API-verzióban. |
ContentKeyPolicyRsaTokenKey
RSA-kulcsot ad meg a jogkivonat érvényesítéséhez
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
exponent |
string |
Az RSA-paraméter kitevője |
modulus |
string |
Az RSA paramétermodulusa |
ContentKeyPolicySymmetricTokenKey
Szimmetrikus kulcsot ad meg a jogkivonat érvényesítéséhez.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
keyValue |
string |
A kulcs kulcsértéke |
ContentKeyPolicyTokenClaim
Jogkivonat-jogcímet jelöl.
Name | Típus | Description |
---|---|---|
claimType |
string |
Jogkivonat jogcímtípusa. |
claimValue |
string |
Jogkivonat jogcímének értéke. |
ContentKeyPolicyTokenRestriction
Jogkivonat-korlátozást jelöl. A megadott jogkivonatnak meg kell felelnie ezeknek a követelményeknek a sikeres licenc- vagy kulcskézbesítéshez.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Az alternatív ellenőrzési kulcsok listája. |
audience |
string |
A jogkivonat célközönsége. |
issuer |
string |
A tokenkibocsátó. |
openIdConnectDiscoveryDocument |
string |
Az OpenID connect discovery dokumentum. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Az elsődleges ellenőrzési kulcs. |
requiredClaims |
A szükséges jogkivonat-jogcímek listája. |
|
restrictionTokenType |
A token típusa. |
ContentKeyPolicyUnknownConfiguration
Olyan ContentKeyPolicyConfiguration értéket jelöl, amely nem érhető el az aktuális API-verzióban.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ContentKeyPolicyUnknownRestriction
Olyan ContentKeyPolicyRestriction értéket jelöl, amely nem érhető el az aktuális API-verzióban.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
ContentKeyPolicyWidevineConfiguration
A Widevine-licencek konfigurációját adja meg.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
widevineTemplate |
string |
A Widevine sablon. |
ContentKeyPolicyX509CertificateTokenKey
Egy tanúsítványt ad meg a jogkivonat érvényesítéséhez.
Name | Típus | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
A származtatott típusok diszkriminatív. |
rawBody |
string |
A tanúsítvány nyers adatmezője PKCS 12 formátumban (X509Certificate2 a .NET-ben) |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
SecurityLevel
A biztonsági szint.
Name | Típus | Description |
---|---|---|
SL150 |
string |
Fejlesztés alatt álló vagy tesztelt ügyfelek esetén. Nincs védelem a jogosulatlan használattal szemben. |
SL2000 |
string |
A kereskedelmi tartalmat használó, edzett eszközök és alkalmazások esetében. Szoftver- vagy hardvervédelem. |
SL3000 |
string |
Csak edzett eszközök esetén. Hardvervédelem. |
Unknown |
string |
Olyan SecurityLevelet jelöl, amely nem érhető el az aktuális API-verzióban. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |