Content Key Policies - Get
Získání zásad klíče obsahu
Získání podrobností o zásadách klíče obsahu v účtu Media Services
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu služby Media Services. |
content
|
path | True |
string |
Název zásady klíče obsahu. |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure. |
subscription
|
path | True |
string |
Jedinečný identifikátor předplatného Microsoft Azure. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít s žádostí klienta. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Podrobné informace o chybě |
Příklady
Get a Content Key Policy by name
Ukázkový požadavek
Ukázková odpověď
{
"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"
}
}
]
}
}
Definice
Name | Description |
---|---|
Content |
Prostředek zásad klíče obsahu. |
Content |
Představuje konfiguraci pro jiné klíče než DRM. |
Content |
Určuje konfiguraci licencí FairPlay. |
Content |
|
Content |
Typ klíče zapůjčení a zapůjčení |
Content |
Představuje otevřené omezení. Licence nebo klíč budou doručeny při každé žádosti. |
Content |
Představuje možnost zásad. |
Content |
Určuje konfiguraci pro licence PlayReady. |
Content |
Určuje, že ID klíče obsahu je v hlavičce PlayReady. |
Content |
Určuje, že ID klíče obsahu je zadáno v konfiguraci PlayReady. |
Content |
Typ obsahu PlayReady. |
Content |
Konfiguruje bity ovládacího prvku Explicit Analog Television Output Restriction. Další podrobnosti najdete v tématu Pravidla dodržování předpisů PlayReady. |
Content |
Licence PlayReady |
Content |
Typ licence. |
Content |
Nakonfiguruje v licenci PlayReady možnost Přehrát vpravo. |
Content |
Nakonfiguruje nastavení neznámého zpracování výstupu licence. |
Content |
Typ tokenu. |
Content |
Určuje klíč RSA pro ověření tokenu. |
Content |
Určuje symetrický klíč pro ověření tokenu. |
Content |
Představuje deklaraci identity tokenu. |
Content |
Představuje omezení tokenu. Zadaný token musí splňovat tyto požadavky pro úspěšné doručení licence nebo klíče. |
Content |
Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API. |
Content |
Představuje ContentKeyPolicyRestriction, která není k dispozici v aktuální verzi rozhraní API. |
Content |
Určuje konfiguraci pro licence Widevine. |
Content |
Určuje certifikát pro ověření tokenu. |
created |
Typ identity, která prostředek vytvořila. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Security |
Úroveň zabezpečení. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
ContentKeyPolicy
Prostředek zásad klíče obsahu.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
name |
string |
Název prostředku |
properties.created |
string |
Datum vytvoření zásad |
properties.description |
string |
Popis zásad. |
properties.lastModified |
string |
Datum poslední změny zásad |
properties.options |
Možnosti zásad klíče. |
|
properties.policyId |
string |
ID starší verze zásad. |
systemData |
Systémová metadata vztahující se k tomuto prostředku. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
ContentKeyPolicyClearKeyConfiguration
Představuje konfiguraci pro jiné klíče než DRM.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ContentKeyPolicyFairPlayConfiguration
Určuje konfiguraci licencí FairPlay.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ask |
string |
Klíč, který se musí použít jako tajný klíč aplikace FairPlay. Musí být zakódovaný jako base64. |
fairPlayPfx |
string |
Reprezentace certifikátu FairPlay v base64 ve formátu PKCS 12 (pfx) (včetně privátního klíče). |
fairPlayPfxPassword |
string |
Heslo šifrující certifikát FairPlay ve formátu PKCS 12 (pfx). |
offlineRentalConfiguration |
Zásady offline pronájmu |
|
rentalAndLeaseKeyType |
Typ klíče zapůjčení a zapůjčení |
|
rentalDuration |
integer |
Doba trvání pronájmu. Musí být větší než nebo rovno 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | Typ | Description |
---|---|---|
playbackDurationSeconds |
integer |
Doba přehrávání |
storageDurationSeconds |
integer |
Doba trvání úložiště |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Typ klíče zapůjčení a zapůjčení
Name | Typ | Description |
---|---|---|
DualExpiry |
string |
Duální vypršení platnosti pro offline zapůjčení |
PersistentLimited |
string |
Klíč obsahu může být trvalý a platná doba trvání je omezená hodnotou Doba trvání pronájmu. |
PersistentUnlimited |
string |
Klíč obsahu je možné zachovat s neomezenou dobou trvání. |
Undefined |
string |
Doba trvání klíče není zadána. |
Unknown |
string |
Představuje ContentKeyPolicyFairPlayRentalAndLeaseKeyType, který není v aktuální verzi rozhraní API k dispozici. |
ContentKeyPolicyOpenRestriction
Představuje otevřené omezení. Licence nebo klíč budou doručeny při každé žádosti.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ContentKeyPolicyOption
Představuje možnost zásad.
Name | Typ | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Konfigurace doručování klíčů. |
name |
string |
Popis možnosti zásad |
policyOptionId |
string |
ID možnosti starší verze zásad. |
restriction | ContentKeyPolicyRestriction: |
Požadavky, které musí být splněny, aby bylo možné doručit klíče s touto konfigurací |
ContentKeyPolicyPlayReadyConfiguration
Určuje konfiguraci pro licence PlayReady.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
licenses |
Licence PlayReady. |
|
responseCustomData |
string |
Vlastní data odpovědi. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Určuje, že ID klíče obsahu je v hlavičce PlayReady.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Určuje, že ID klíče obsahu je zadáno v konfiguraci PlayReady.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyId |
string |
ID klíče obsahu. |
ContentKeyPolicyPlayReadyContentType
Typ obsahu PlayReady.
Name | Typ | Description |
---|---|---|
UltraVioletDownload |
string |
Ultrafialový typ obsahu ke stažení. |
UltraVioletStreaming |
string |
Typ ultrafialového streamovaného obsahu. |
Unknown |
string |
Představuje ContentKeyPolicyPlayReadyContentType, který není k dispozici v aktuální verzi rozhraní API. |
Unspecified |
string |
Nespecifikovaný typ obsahu. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Konfiguruje bity ovládacího prvku Explicit Analog Television Output Restriction. Další podrobnosti najdete v tématu Pravidla dodržování předpisů PlayReady.
Name | Typ | Description |
---|---|---|
bestEffort |
boolean |
Určuje, zda je toto omezení vynuceno na základě maximálního úsilí. |
configurationData |
integer |
Konfiguruje bity řízení omezení. Musí být mezi 0 a 3 včetně. |
ContentKeyPolicyPlayReadyLicense
Licence PlayReady
Name | Typ | Description |
---|---|---|
allowTestDevices |
boolean |
Příznak označující, jestli testovací zařízení můžou používat licenci. |
beginDate |
string |
Počáteční datum licence |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Umístění klíče obsahu. |
contentType |
Typ obsahu PlayReady. |
|
expirationDate |
string |
Datum vypršení platnosti licence. |
gracePeriod |
string |
Období odkladu licence. |
licenseType |
Typ licence. |
|
playRight |
Licence PlayRight |
|
relativeBeginDate |
string |
Relativní počáteční datum licence. |
relativeExpirationDate |
string |
Relativní datum vypršení platnosti licence. |
securityLevel |
Úroveň zabezpečení. |
ContentKeyPolicyPlayReadyLicenseType
Typ licence.
Name | Typ | Description |
---|---|---|
NonPersistent |
string |
Netrvání licence. |
Persistent |
string |
Trvalá licence. Umožňuje offline přehrávání. |
Unknown |
string |
Představuje ContentKeyPolicyPlayReadyLicenseType, který není k dispozici v aktuální verzi rozhraní API. |
ContentKeyPolicyPlayReadyPlayRight
Nakonfiguruje v licenci PlayReady možnost Přehrát vpravo.
Name | Typ | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Nakonfiguruje automatické řízení získání (AGC) a barevný pruh v licenci. Musí být mezi 0 a 3 včetně. |
allowPassingVideoContentToUnknownOutput |
Nakonfiguruje nastavení neznámého zpracování výstupu licence. |
|
analogVideoOpl |
integer |
Určuje úroveň ochrany výstupu pro komprimovaný digitální zvuk. |
compressedDigitalAudioOpl |
integer |
Určuje úroveň ochrany výstupu pro komprimovaný digitální zvuk. |
compressedDigitalVideoOpl |
integer |
Určuje úroveň ochrany výstupu pro komprimované digitální video. |
digitalVideoOnlyContentRestriction |
boolean |
Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci. |
explicitAnalogTelevisionOutputRestriction |
Content |
Nakonfiguruje omezení explicitního výstupu analogové televize v licenci. Konfigurační data musí být mezi 0 a 3 včetně. |
firstPlayExpiration |
string |
Doba, po kterou je licence platná po prvním použití licence k přehrávání obsahu. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Povolí omezení obrázku pro analogovou komponentu Video Omezení v licenci. |
scmsRestriction |
integer |
Nakonfiguruje systém správy sériového kopírování (SCMS) v licenci. Musí být mezi 0 a 3 včetně. |
uncompressedDigitalAudioOpl |
integer |
Určuje úroveň ochrany výstupu pro nekomprimovaný digitální zvuk. |
uncompressedDigitalVideoOpl |
integer |
Určuje úroveň ochrany výstupu pro nekomprimované digitální video. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Nakonfiguruje nastavení neznámého zpracování výstupu licence.
Name | Typ | Description |
---|---|---|
Allowed |
string |
Předání části chráněného obsahu videa neznámému výstupu je povoleno. |
AllowedWithVideoConstriction |
string |
Předání části chráněného obsahu videa neznámému výstupu je povoleno, ale s omezeným rozlišením. |
NotAllowed |
string |
Předání části chráněného obsahu videa neznámému výstupu není povoleno. |
Unknown |
string |
Představuje ContentKeyPolicyPlayReadyUnknownOutputPassingOption, který není k dispozici v aktuální verzi rozhraní API. |
ContentKeyPolicyRestrictionTokenType
Typ tokenu.
Name | Typ | Description |
---|---|---|
Jwt |
string |
Webový token JSON. |
Swt |
string |
Jednoduchý webový token. |
Unknown |
string |
Představuje ContentKeyPolicyRestrictionTokenType, který není k dispozici v aktuální verzi rozhraní API. |
ContentKeyPolicyRsaTokenKey
Určuje klíč RSA pro ověření tokenu.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
exponent |
string |
Exponent parametru RSA |
modulus |
string |
Modul parametrů RSA |
ContentKeyPolicySymmetricTokenKey
Určuje symetrický klíč pro ověření tokenu.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyValue |
string |
Hodnota klíče |
ContentKeyPolicyTokenClaim
Představuje deklaraci identity tokenu.
Name | Typ | Description |
---|---|---|
claimType |
string |
Typ deklarace identity tokenu. |
claimValue |
string |
Hodnota deklarace tokenu |
ContentKeyPolicyTokenRestriction
Představuje omezení tokenu. Zadaný token musí splňovat tyto požadavky pro úspěšné doručení licence nebo klíče.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Seznam alternativních ověřovacích klíčů. |
audience |
string |
Cílová skupina tokenu. |
issuer |
string |
Vystavitel tokenu. |
openIdConnectDiscoveryDocument |
string |
Dokument ke zjišťování OpenID Connect. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Primární ověřovací klíč. |
requiredClaims |
Seznam požadovaných deklarací identity tokenů |
|
restrictionTokenType |
Typ tokenu. |
ContentKeyPolicyUnknownConfiguration
Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ContentKeyPolicyUnknownRestriction
Představuje ContentKeyPolicyRestriction, která není k dispozici v aktuální verzi rozhraní API.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
ContentKeyPolicyWidevineConfiguration
Určuje konfiguraci pro licence Widevine.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
widevineTemplate |
string |
Šablona Widevine |
ContentKeyPolicyX509CertificateTokenKey
Určuje certifikát pro ověření tokenu.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
rawBody |
string |
Nezpracované datové pole certifikátu ve formátu PKCS 12 (X509Certificate2 v .NET) |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
SecurityLevel
Úroveň zabezpečení.
Name | Typ | Description |
---|---|---|
SL150 |
string |
Pro klienty ve vývoji nebo testování. Žádná ochrana proti neoprávněnému použití. |
SL2000 |
string |
Pro posílená zařízení a aplikace využívající komerční obsah. Ochrana softwaru nebo hardwaru. |
SL3000 |
string |
Pouze pro posílená zařízení. Ochrana hardwaru. |
Unknown |
string |
Představuje úroveň zabezpečení, která není k dispozici v aktuální verzi rozhraní API. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |