Sdílet prostřednictvím


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
accountName
path True

string

Název účtu služby Media Services.

contentKeyPolicyName
path True

string

Název zásady klíče obsahu.

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného Azure.

subscriptionId
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

ContentKeyPolicy

OK

Other Status Codes

ErrorResponse

Podrobné informace o chybě

Příklady

Get a Content Key Policy by name

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/contentKeyPolicies/PolicyWithMultipleOptions?api-version=2022-08-01

Sample Response

{
  "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
ContentKeyPolicy

Prostředek zásad klíče obsahu.

ContentKeyPolicyClearKeyConfiguration

Představuje konfiguraci pro jiné klíče než DRM.

ContentKeyPolicyFairPlayConfiguration

Určuje konfiguraci licencí FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klíče zapůjčení a zapůjčení

ContentKeyPolicyOpenRestriction

Představuje otevřené omezení. Licence nebo klíč budou doručeny při každé žádosti.

ContentKeyPolicyOption

Představuje možnost zásad.

ContentKeyPolicyPlayReadyConfiguration

Určuje konfiguraci pro licence PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Určuje, že ID klíče obsahu je v hlavičce PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Určuje, že ID klíče obsahu je zadáno v konfiguraci PlayReady.

ContentKeyPolicyPlayReadyContentType

Typ obsahu PlayReady.

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.

ContentKeyPolicyPlayReadyLicense

Licence PlayReady

ContentKeyPolicyPlayReadyLicenseType

Typ licence.

ContentKeyPolicyPlayReadyPlayRight

Nakonfiguruje v licenci PlayReady možnost Přehrát vpravo.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Nakonfiguruje nastavení neznámého zpracování výstupu licence.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyRsaTokenKey

Určuje klíč RSA pro ověření tokenu.

ContentKeyPolicySymmetricTokenKey

Určuje symetrický klíč pro ověření tokenu.

ContentKeyPolicyTokenClaim

Představuje deklaraci identity tokenu.

ContentKeyPolicyTokenRestriction

Představuje omezení tokenu. Zadaný token musí splňovat tyto požadavky pro úspěšné doručení licence nebo klíče.

ContentKeyPolicyUnknownConfiguration

Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyUnknownRestriction

Představuje ContentKeyPolicyRestriction, která není k dispozici v aktuální verzi rozhraní API.

ContentKeyPolicyWidevineConfiguration

Určuje konfiguraci pro licence Widevine.

ContentKeyPolicyX509CertificateTokenKey

Určuje certifikát pro ověření tokenu.

createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

SecurityLevel

Úroveň zabezpečení.

systemData

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

ContentKeyPolicyOption[]

Možnosti zásad klíče.

properties.policyId

string

ID starší verze zásad.

systemData

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.Media.ContentKeyPolicyClearKeyConfiguration

Diskriminátor pro odvozené typy.

ContentKeyPolicyFairPlayConfiguration

Určuje konfiguraci licencí FairPlay.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

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

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Zásady offline pronájmu

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

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.Media.ContentKeyPolicyOpenRestriction

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.Media.ContentKeyPolicyPlayReadyConfiguration

Diskriminátor pro odvozené typy.

licenses

ContentKeyPolicyPlayReadyLicense[]

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

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.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

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

ContentKeyPolicyPlayReadyContentType

Typ obsahu PlayReady.

expirationDate

string

Datum vypršení platnosti licence.

gracePeriod

string

Období odkladu licence.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Typ licence.

playRight

ContentKeyPolicyPlayReadyPlayRight

Licence PlayRight

relativeBeginDate

string

Relativní počáteční datum licence.

relativeExpirationDate

string

Relativní datum vypršení platnosti licence.

securityLevel

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

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

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

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

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.Media.ContentKeyPolicyRsaTokenKey

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.Media.ContentKeyPolicySymmetricTokenKey

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.Media.ContentKeyPolicyTokenRestriction

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

ContentKeyPolicyTokenClaim[]

Seznam požadovaných deklarací identity tokenů

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyUnknownConfiguration

Představuje ContentKeyPolicyConfiguration, která není k dispozici v aktuální verzi rozhraní API.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

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.Media.ContentKeyPolicyUnknownRestriction

Diskriminátor pro odvozené typy.

ContentKeyPolicyWidevineConfiguration

Určuje konfiguraci pro licence Widevine.

Name Typ Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

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.Media.ContentKeyPolicyX509CertificateTokenKey

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

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

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

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

createdByType

Typ identity, která naposledy změnila prostředek.