Aracılığıyla paylaş


Content Key Policies - Get

İçerik Anahtarı İlkesi Alma
Media Services hesabında İçerik Anahtarı İlkesinin ayrıntılarını alma

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01

URI Parametreleri

Name İçinde Gerekli Tür Description
accountName
path True

string

Media Services hesap adı.

contentKeyPolicyName
path True

string

İçerik Anahtarı İlkesi adı.

resourceGroupName
path True

string

Azure aboneliğindeki kaynak grubunun adı.

subscriptionId
path True

string

Microsoft Azure aboneliğinin benzersiz tanımlayıcısı.

api-version
query True

string

İstemci isteğiyle kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK

ContentKeyPolicy

Tamam

Other Status Codes

ErrorResponse

Ayrıntılı hata bilgileri.

Örnekler

Get a Content Key Policy by name

Örnek isteği

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

Örnek yanıt

{
  "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"
        }
      }
    ]
  }
}

Tanımlar

Name Description
ContentKeyPolicy

İçerik Anahtarı İlkesi kaynağı.

ContentKeyPolicyClearKeyConfiguration

DRM olmayan anahtarlar için bir yapılandırmayı temsil eder.

ContentKeyPolicyFairPlayConfiguration

FairPlay lisansları için bir yapılandırma belirtir.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Kiralama ve kira anahtarı türü.

ContentKeyPolicyOpenRestriction

Açık bir kısıtlamayı temsil eder. Lisans veya anahtar her istekte teslim edilecek.

ContentKeyPolicyOption

İlke seçeneğini temsil eder.

ContentKeyPolicyPlayReadyConfiguration

PlayReady lisansları için bir yapılandırma belirtir.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

İçerik anahtarı kimliğinin PlayReady üst bilgisinde olduğunu belirtir.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

İçerik anahtarı kimliğinin PlayReady yapılandırmasında belirtildiğini belirtir.

ContentKeyPolicyPlayReadyContentType

PlayReady içerik türü.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Açık Analog Televizyon Çıkış Kısıtlaması denetim bitlerini yapılandırır. Diğer ayrıntılar için bkz. PlayReady Uyumluluk Kuralları.

ContentKeyPolicyPlayReadyLicense

PlayReady lisansı

ContentKeyPolicyPlayReadyLicenseType

Lisans türü.

ContentKeyPolicyPlayReadyPlayRight

PlayReady lisansında Play Right'ı yapılandırır.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Lisansın Bilinmeyen çıkış işleme ayarlarını yapılandırır.

ContentKeyPolicyRestrictionTokenType

Belirtecin türü.

ContentKeyPolicyRsaTokenKey

Belirteç doğrulaması için bir RSA anahtarı belirtir

ContentKeyPolicySymmetricTokenKey

Belirteç doğrulaması için simetrik bir anahtar belirtir.

ContentKeyPolicyTokenClaim

Belirteç talebi temsil eder.

ContentKeyPolicyTokenRestriction

Belirteç kısıtlamayı temsil eder. Sağlanan belirteç, başarılı lisans veya anahtar teslimi için bu gereksinimlerle eşleşmelidir.

ContentKeyPolicyUnknownConfiguration

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyConfiguration'ı temsil eder.

ContentKeyPolicyUnknownRestriction

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyRestriction'ı temsil eder.

ContentKeyPolicyWidevineConfiguration

Widevine lisansları için bir yapılandırma belirtir.

ContentKeyPolicyX509CertificateTokenKey

Belirteç doğrulaması için bir sertifika belirtir.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

SecurityLevel

Güvenlik düzeyi.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

ContentKeyPolicy

İçerik Anahtarı İlkesi kaynağı.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Kaynağın adı

properties.created

string

İlkenin oluşturulma tarihi

properties.description

string

İlke için bir açıklama.

properties.lastModified

string

İlkenin son değiştirilme tarihi

properties.options

ContentKeyPolicyOption[]

Anahtar İlkesi seçenekleri.

properties.policyId

string

Eski İlke Kimliği.

systemData

systemData

Bu kaynakla ilgili sistem meta verileri.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ContentKeyPolicyClearKeyConfiguration

DRM olmayan anahtarlar için bir yapılandırmayı temsil eder.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Türetilmiş türler için ayrımcı.

ContentKeyPolicyFairPlayConfiguration

FairPlay lisansları için bir yapılandırma belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Türetilmiş türler için ayrımcı.

ask

string

FairPlay Uygulama Gizli Anahtarı olarak kullanılması gereken anahtar. Bunun base64 kodlanmış olması gerekir.

fairPlayPfx

string

FairPlay sertifikasının PKCS 12 (pfx) biçiminde (özel anahtar dahil) Base64 gösterimi.

fairPlayPfxPassword

string

FairPlay sertifikasını PKCS 12 (pfx) biçiminde şifreleyen parola.

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Çevrimdışı kiralama ilkesi

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Kiralama ve kira anahtarı türü.

rentalDuration

integer

Kiralama süresi. 0 değerinden büyük veya 0 değerine eşit olmalıdır.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Tür Description
playbackDurationSeconds

integer

Kayıttan yürütme süresi

storageDurationSeconds

integer

Depolama süresi

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Kiralama ve kira anahtarı türü.

Name Tür Description
DualExpiry

string

Çevrimdışı kiralama için ikili süre sonu.

PersistentLimited

string

İçerik anahtarı kalıcı hale getirilebilir ve geçerli süre Kiralama Süresi değeriyle sınırlıdır

PersistentUnlimited

string

İçerik anahtarı sınırsız süreyle kalıcı hale gelebilir

Undefined

string

Anahtar süresi belirtilmedi.

Unknown

string

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyFairPlayRentalAndLeaseKeyType değerini temsil eder.

ContentKeyPolicyOpenRestriction

Açık bir kısıtlamayı temsil eder. Lisans veya anahtar her istekte teslim edilecek.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Türetilmiş türler için ayrımcı.

ContentKeyPolicyOption

İlke seçeneğini temsil eder.

Name Tür Description
configuration ContentKeyPolicyConfiguration:

Anahtar teslim yapılandırması.

name

string

İlke Seçeneği açıklaması.

policyOptionId

string

Eski İlke Seçenek Kimliği.

restriction ContentKeyPolicyRestriction:

Bu yapılandırmayla anahtarları teslim etmek için karşılanması gereken gereksinimler

ContentKeyPolicyPlayReadyConfiguration

PlayReady lisansları için bir yapılandırma belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Türetilmiş türler için ayrımcı.

licenses

ContentKeyPolicyPlayReadyLicense[]

PlayReady lisansları.

responseCustomData

string

Özel yanıt verileri.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

İçerik anahtarı kimliğinin PlayReady üst bilgisinde olduğunu belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Türetilmiş türler için ayrımcı.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

İçerik anahtarı kimliğinin PlayReady yapılandırmasında belirtildiğini belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Türetilmiş türler için ayrımcı.

keyId

string

İçerik anahtarı kimliği.

ContentKeyPolicyPlayReadyContentType

PlayReady içerik türü.

Name Tür Description
UltraVioletDownload

string

Ultraviyole indirme içerik türü.

UltraVioletStreaming

string

Ultraviyole akış içerik türü.

Unknown

string

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyPlayReadyContentType değerini temsil eder.

Unspecified

string

Belirtilmemiş içerik türü.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Açık Analog Televizyon Çıkış Kısıtlaması denetim bitlerini yapılandırır. Diğer ayrıntılar için bkz. PlayReady Uyumluluk Kuralları.

Name Tür Description
bestEffort

boolean

Bu kısıtlamanın En İyi Çaba temelinde uygulanıp uygulanmadığını gösterir.

configurationData

integer

Kısıtlama denetimi bitlerini yapılandırıyor. 0 ile 3 (dahil) arasında olmalıdır.

ContentKeyPolicyPlayReadyLicense

PlayReady lisansı

Name Tür Description
allowTestDevices

boolean

Test cihazlarının lisansı kullanıp kullanamayacağını gösteren bir bayrak.

beginDate

string

Lisans başlangıç tarihi

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

İçerik anahtarı konumu.

contentType

ContentKeyPolicyPlayReadyContentType

PlayReady içerik türü.

expirationDate

string

Lisansın son kullanma tarihi.

gracePeriod

string

Lisansın yetkisiz kullanım süresi.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Lisans türü.

playRight

ContentKeyPolicyPlayReadyPlayRight

PlayRight lisansı

relativeBeginDate

string

Göreli lisans başlangıç tarihi.

relativeExpirationDate

string

Lisansın göreli son kullanma tarihi.

securityLevel

SecurityLevel

Güvenlik düzeyi.

ContentKeyPolicyPlayReadyLicenseType

Lisans türü.

Name Tür Description
NonPersistent

string

Kalıcı olmayan lisans.

Persistent

string

Kalıcı lisans. Çevrimdışı kayıttan yürütmeye izin verir.

Unknown

string

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyPlayReadyLicenseType değerini temsil eder.

ContentKeyPolicyPlayReadyPlayRight

PlayReady lisansında Play Right'ı yapılandırır.

Name Tür Description
agcAndColorStripeRestriction

integer

Lisansta Otomatik Kazanç Denetimi (AGC) ve Renk Şeridi'ni yapılandırıyor. 0 ile 3 (dahil) arasında olmalıdır.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Lisansın Bilinmeyen çıkış işleme ayarlarını yapılandırır.

analogVideoOpl

integer

Sıkıştırılmış dijital ses için çıkış koruma düzeyini belirtir.

compressedDigitalAudioOpl

integer

Sıkıştırılmış dijital ses için çıkış koruma düzeyini belirtir.

compressedDigitalVideoOpl

integer

Sıkıştırılmış dijital video için çıkış koruma düzeyini belirtir.

digitalVideoOnlyContentRestriction

boolean

Lisanstaki Analog Bileşen Video Kısıtlaması için Görüntü Kısıtlamasını etkinleştirir.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Lisanstaki Açık Analog Televizyon Çıkış Kısıtlamasını yapılandırır. Yapılandırma verileri 0 ile 3 arasında olmalıdır.

firstPlayExpiration

string

İçeriği oynatmak için lisans ilk kez kullanıldıktan sonra lisansın geçerli olduğu süre.

imageConstraintForAnalogComponentVideoRestriction

boolean

Lisanstaki Analog Bileşen Video Kısıtlaması için Görüntü Kısıtlamasını etkinleştirir.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Lisanstaki Analog Bileşen Video Kısıtlaması için Görüntü Kısıtlamasını etkinleştirir.

scmsRestriction

integer

Lisanstaki Seri Kopya Yönetim Sistemi'ni (SCMS) yapılandırılır. 0 ile 3 (dahil) arasında olmalıdır.

uncompressedDigitalAudioOpl

integer

Sıkıştırılmamış dijital ses için çıkış koruma düzeyini belirtir.

uncompressedDigitalVideoOpl

integer

Sıkıştırılmamış dijital video için çıkış koruma düzeyini belirtir.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Lisansın Bilinmeyen çıkış işleme ayarlarını yapılandırır.

Name Tür Description
Allowed

string

Korumalı içeriğin video bölümünün Bilinmeyen Çıkışa geçirilmesine izin verilir.

AllowedWithVideoConstriction

string

Korumalı içeriğin video bölümünün Bilinmeyen Çıkışa geçirilmesine izin verilir, ancak çözünürlük kısıtlanır.

NotAllowed

string

Korumalı içeriğin video bölümünün Bilinmeyen Çıkışa geçirilmesine izin verilmez.

Unknown

string

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyPlayReadyUnknownOutputPassingOption öğesini temsil eder.

ContentKeyPolicyRestrictionTokenType

Belirtecin türü.

Name Tür Description
Jwt

string

JSON Web Belirteci.

Swt

string

Basit Web Belirteci.

Unknown

string

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyRestrictionTokenType'ı temsil eder.

ContentKeyPolicyRsaTokenKey

Belirteç doğrulaması için bir RSA anahtarı belirtir

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Türetilmiş türler için ayrımcı.

exponent

string

RSA Parametresi üssü

modulus

string

RSA Parametresi modulus

ContentKeyPolicySymmetricTokenKey

Belirteç doğrulaması için simetrik bir anahtar belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Türetilmiş türler için ayrımcı.

keyValue

string

Anahtarın anahtar değeri

ContentKeyPolicyTokenClaim

Belirteç talebi temsil eder.

Name Tür Description
claimType

string

Belirteç talep türü.

claimValue

string

Belirteç talep değeri.

ContentKeyPolicyTokenRestriction

Belirteç kısıtlamayı temsil eder. Sağlanan belirteç, başarılı lisans veya anahtar teslimi için bu gereksinimlerle eşleşmelidir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Türetilmiş türler için ayrımcı.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Alternatif doğrulama anahtarlarının listesi.

audience

string

Belirtecin hedef kitlesi.

issuer

string

Belirteç veren.

openIdConnectDiscoveryDocument

string

OpenID connect bulma belgesi.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Birincil doğrulama anahtarı.

requiredClaims

ContentKeyPolicyTokenClaim[]

Gerekli belirteç taleplerinin listesi.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Belirtecin türü.

ContentKeyPolicyUnknownConfiguration

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyConfiguration'ı temsil eder.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Türetilmiş türler için ayrımcı.

ContentKeyPolicyUnknownRestriction

Geçerli API sürümünde kullanılamayan bir ContentKeyPolicyRestriction'ı temsil eder.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Türetilmiş türler için ayrımcı.

ContentKeyPolicyWidevineConfiguration

Widevine lisansları için bir yapılandırma belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Türetilmiş türler için ayrımcı.

widevineTemplate

string

Widevine şablonu.

ContentKeyPolicyX509CertificateTokenKey

Belirteç doğrulaması için bir sertifika belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Türetilmiş türler için ayrımcı.

rawBody

string

BIR sertifikanın PKCS 12 biçimindeki ham veri alanı (.NET'te X509Certificate2)

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

SecurityLevel

Güvenlik düzeyi.

Name Tür Description
SL150

string

Geliştirme veya test aşamasında olan istemciler için. Yetkisiz kullanıma karşı koruma yoktur.

SL2000

string

Ticari içerik kullanan sağlamlaştırılmış cihazlar ve uygulamalar için. Yazılım veya donanım koruması.

SL3000

string

Yalnızca sağlamlaştırılmış cihazlar için. Donanım koruması.

Unknown

string

Geçerli API sürümünde kullanılamayan bir SecurityLevel'i temsil eder.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimliğin türü.