Content Key Policies - Get

Mendapatkan Kebijakan Kunci Konten
Mendapatkan detail Kebijakan Kunci Konten di akun Media Services

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
accountName
path True

string

Nama akun Media Services.

contentKeyPolicyName
path True

string

Nama Kebijakan Kunci Konten.

resourceGroupName
path True

string

Nama grup sumber daya dalam langganan Azure.

subscriptionId
path True

string

Pengidentifikasi unik untuk langganan Microsoft Azure.

api-version
query True

string

Versi API yang akan digunakan dengan permintaan klien.

Respons

Nama Jenis Deskripsi
200 OK

ContentKeyPolicy

OK

Other Status Codes

ErrorResponse

Informasi kesalahan terperinci.

Contoh

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

Definisi

Nama Deskripsi
ContentKeyPolicy

Sumber daya Kebijakan Kunci Konten.

ContentKeyPolicyClearKeyConfiguration

Mewakili konfigurasi untuk kunci non-DRM.

ContentKeyPolicyFairPlayConfiguration

Menentukan konfigurasi untuk lisensi FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Jenis kunci sewa dan sewa.

ContentKeyPolicyOpenRestriction

Mewakili pembatasan terbuka. Lisensi atau kunci akan dikirimkan pada setiap permintaan.

ContentKeyPolicyOption

Mewakili opsi kebijakan.

ContentKeyPolicyPlayReadyConfiguration

Menentukan konfigurasi untuk lisensi PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Menentukan bahwa ID kunci konten berada di header PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Menentukan bahwa ID kunci konten ditentukan dalam konfigurasi PlayReady.

ContentKeyPolicyPlayReadyContentType

Tipe konten PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Mengonfigurasi bit kontrol Pembatasan Output Televisi Analog Eksplisit. Untuk detail lebih lanjut lihat Aturan Kepatuhan PlayReady.

ContentKeyPolicyPlayReadyLicense

Lisensi PlayReady

ContentKeyPolicyPlayReadyLicenseType

Jenis lisensi.

ContentKeyPolicyPlayReadyPlayRight

Mengonfigurasi Play Right di lisensi PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Mengonfigurasi pengaturan penanganan output lisensi yang tidak diketahui.

ContentKeyPolicyRestrictionTokenType

Jenis token.

ContentKeyPolicyRsaTokenKey

Menentukan kunci RSA untuk validasi token

ContentKeyPolicySymmetricTokenKey

Menentukan kunci konten untuk validasi token.

ContentKeyPolicyTokenClaim

Mewakili klaim token.

ContentKeyPolicyTokenRestriction

Mewakili pembatasan token. Token yang disediakan harus sesuai dengan persyaratan ini agar lisensi atau pengiriman kunci berhasil.

ContentKeyPolicyUnknownConfiguration

Mewakili ContentKeyPolicyConfiguration yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyUnknownRestriction

Mewakili ContentKeyPolicyRestriction yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyWidevineConfiguration

Menentukan konfigurasi untuk lisensi Widevine.

ContentKeyPolicyX509CertificateTokenKey

Menentukan sertifikat untuk validasi token.

createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

SecurityLevel

Tingkat keamanan.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

ContentKeyPolicy

Sumber daya Kebijakan Kunci Konten.

Nama Jenis Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nama sumber daya.

properties.created

string

Tanggal pembuatan Kebijakan

properties.description

string

Deskripsi untuk Kebijakan.

properties.lastModified

string

Tanggal terakhir dimodifikasi dari Kebijakan

properties.options

ContentKeyPolicyOption[]

Opsi Kebijakan Kunci.

properties.policyId

string

ID Kebijakan warisan.

systemData

systemData

Metadata sistem yang berkaitan dengan sumber daya ini.

type

string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ContentKeyPolicyClearKeyConfiguration

Mewakili konfigurasi untuk kunci non-DRM.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Diskriminator untuk jenis turunan.

ContentKeyPolicyFairPlayConfiguration

Menentukan konfigurasi untuk lisensi FairPlay.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Diskriminator untuk jenis turunan.

ask

string

Kunci yang harus digunakan sebagai kunci Rahasia Aplikasi FairPlay. Ini perlu dikodekan base64.

fairPlayPfx

string

Representasi Base64 dari sertifikat FairPlay dalam format PKCS 12 (pfx) (termasuk kunci privat).

fairPlayPfxPassword

string

Kata sandi mengenkripsi sertifikat FairPlay dalam format PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Kebijakan penyewaan offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Jenis kunci sewa dan sewa.

rentalDuration

integer

Durasi penyewaan. Harus lebih besar dari atau sama dengan 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Nama Jenis Deskripsi
playbackDurationSeconds

integer

Durasi pemutaran

storageDurationSeconds

integer

Durasi penyimpanan

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Jenis kunci sewa dan sewa.

Nama Jenis Deskripsi
DualExpiry

string

Kedaluwarsa ganda untuk penyewaan offline.

PersistentLimited

string

Kunci konten dapat dipertahankan dan durasi yang valid dibatasi oleh nilai Durasi Sewa

PersistentUnlimited

string

Kunci konten dapat dipertahankan dengan durasi tak terbatas

Undefined

string

Durasi kunci tidak ditentukan.

Unknown

string

Mewakili ContentKeyPolicyFairPlayRentalAndLeaseKeyType yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyOpenRestriction

Mewakili pembatasan terbuka. Lisensi atau kunci akan dikirimkan pada setiap permintaan.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Diskriminator untuk jenis turunan.

ContentKeyPolicyOption

Mewakili opsi kebijakan.

Nama Jenis Deskripsi
configuration ContentKeyPolicyConfiguration:

Konfigurasi pengiriman utama.

name

string

Deskripsi Opsi Kebijakan.

policyOptionId

string

ID Opsi Kebijakan warisan.

restriction ContentKeyPolicyRestriction:

Persyaratan yang harus dipenuhi untuk memberikan kunci dengan konfigurasi ini

ContentKeyPolicyPlayReadyConfiguration

Menentukan konfigurasi untuk lisensi PlayReady.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Diskriminator untuk jenis turunan.

licenses

ContentKeyPolicyPlayReadyLicense[]

Lisensi PlayReady.

responseCustomData

string

Data respons kustom.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Menentukan bahwa ID kunci konten berada di header PlayReady.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Diskriminator untuk jenis turunan.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Menentukan bahwa ID kunci konten ditentukan dalam konfigurasi PlayReady.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Diskriminator untuk jenis turunan.

keyId

string

ID kunci konten.

ContentKeyPolicyPlayReadyContentType

Tipe konten PlayReady.

Nama Jenis Deskripsi
UltraVioletDownload

string

Jenis konten unduhan ultraviolet.

UltraVioletStreaming

string

Jenis konten streaming ultraviolet.

Unknown

string

Mewakili ContentKeyPolicyPlayReadyContentType yang tidak tersedia dalam versi API saat ini.

Unspecified

string

Tipe isi yang tidak ditentukan.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Mengonfigurasi bit kontrol Pembatasan Output Televisi Analog Eksplisit. Untuk detail lebih lanjut lihat Aturan Kepatuhan PlayReady.

Nama Jenis Deskripsi
bestEffort

boolean

Menunjukkan apakah pembatasan ini diberlakukan berdasarkan Upaya Terbaik.

configurationData

integer

Mengonfigurasi bit kontrol pembatasan. Harus antara 0 dan 3 inklusif.

ContentKeyPolicyPlayReadyLicense

Lisensi PlayReady

Nama Jenis Deskripsi
allowTestDevices

boolean

Bendera yang menunjukkan apakah perangkat pengujian dapat menggunakan lisensi.

beginDate

string

Tanggal mulai lisensi

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Lokasi kunci konten.

contentType

ContentKeyPolicyPlayReadyContentType

Tipe konten PlayReady.

expirationDate

string

Tanggal kedaluwarsa lisensi.

gracePeriod

string

Masa tenggang lisensi.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Jenis lisensi.

playRight

ContentKeyPolicyPlayReadyPlayRight

Lisensi PlayRight

relativeBeginDate

string

Tanggal mulai lisensi relatif.

relativeExpirationDate

string

Tanggal kedaluwarsa relatif lisensi.

securityLevel

SecurityLevel

Tingkat keamanan.

ContentKeyPolicyPlayReadyLicenseType

Jenis lisensi.

Nama Jenis Deskripsi
NonPersistent

string

Lisensi tidak persisten.

Persistent

string

Lisensi persisten. Perbolehkan pemutaran offline.

Unknown

string

Mewakili ContentKeyPolicyPlayReadyLicenseType yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyPlayReadyPlayRight

Mengonfigurasi Play Right di lisensi PlayReady.

Nama Jenis Deskripsi
agcAndColorStripeRestriction

integer

Mengonfigurasi Kontrol Keuntungan Otomatis (AGC) dan Stripe Warna dalam lisensi. Harus antara 0 dan 3 inklusif.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Mengonfigurasi pengaturan penanganan output lisensi yang tidak diketahui.

analogVideoOpl

integer

Menentukan tingkat perlindungan output untuk audio digital terkompresi.

compressedDigitalAudioOpl

integer

Menentukan tingkat perlindungan output untuk audio digital terkompresi.

compressedDigitalVideoOpl

integer

Menentukan tingkat perlindungan output untuk video digital terkompresi.

digitalVideoOnlyContentRestriction

boolean

Mengaktifkan Batasan Gambar Untuk Pembatasan Video Komponen Analog dalam lisensi.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Mengonfigurasi Pembatasan Output Televisi Analog Eksplisit dalam lisensi. Data konfigurasi harus antara 0 dan 3 inklusif.

firstPlayExpiration

string

Jumlah waktu lisensi valid setelah lisensi pertama kali digunakan untuk memutar konten.

imageConstraintForAnalogComponentVideoRestriction

boolean

Mengaktifkan Batasan Gambar Untuk Pembatasan Video Komponen Analog dalam lisensi.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Mengaktifkan Batasan Gambar Untuk Pembatasan Video Komponen Analog dalam lisensi.

scmsRestriction

integer

Mengonfigurasi Serial Copy Management System (SCMS) dalam lisensi. Harus antara 0 dan 3 inklusif.

uncompressedDigitalAudioOpl

integer

Menentukan tingkat perlindungan output untuk audio digital yang tidak dikompresi.

uncompressedDigitalVideoOpl

integer

Menentukan tingkat perlindungan output untuk video digital yang tidak dikompresi.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Mengonfigurasi pengaturan penanganan output lisensi yang tidak diketahui.

Nama Jenis Deskripsi
Allowed

string

Meneruskan bagian video dari konten yang dilindungi ke Output Yang Tidak Diketahui diizinkan.

AllowedWithVideoConstriction

string

Meneruskan bagian video konten yang dilindungi ke Output Yang Tidak Diketahui diizinkan tetapi dengan resolusi yang dibatasi.

NotAllowed

string

Meneruskan bagian video dari konten yang dilindungi ke Output Yang Tidak Diketahui tidak diizinkan.

Unknown

string

Mewakili ContentKeyPolicyPlayReadyUnknownOutputPassingOption yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyRestrictionTokenType

Jenis token.

Nama Jenis Deskripsi
Jwt

string

JSON Web Token.

Swt

string

Token Web Sederhana.

Unknown

string

Mewakili ContentKeyPolicyRestrictionTokenType yang tidak tersedia dalam versi API saat ini.

ContentKeyPolicyRsaTokenKey

Menentukan kunci RSA untuk validasi token

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Diskriminator untuk jenis turunan.

exponent

string

Eksponen Parameter RSA

modulus

string

Modul Parameter RSA

ContentKeyPolicySymmetricTokenKey

Menentukan kunci konten untuk validasi token.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Diskriminator untuk jenis turunan.

keyValue

string

Nilai kunci kunci

ContentKeyPolicyTokenClaim

Mewakili klaim token.

Nama Jenis Deskripsi
claimType

string

Jenis klaim token.

claimValue

string

Nilai klaim token.

ContentKeyPolicyTokenRestriction

Mewakili pembatasan token. Token yang disediakan harus sesuai dengan persyaratan ini agar lisensi atau pengiriman kunci berhasil.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Diskriminator untuk jenis turunan.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Daftar kunci verifikasi alternatif.

audience

string

Audiens untuk token.

issuer

string

Penerbit token.

openIdConnectDiscoveryDocument

string

Dokumen penemuan sambungkan OpenID.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Kunci verifikasi utama.

requiredClaims

ContentKeyPolicyTokenClaim[]

Daftar klaim token yang diperlukan.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Jenis token.

ContentKeyPolicyUnknownConfiguration

Mewakili ContentKeyPolicyConfiguration yang tidak tersedia dalam versi API saat ini.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Diskriminator untuk jenis turunan.

ContentKeyPolicyUnknownRestriction

Mewakili ContentKeyPolicyRestriction yang tidak tersedia dalam versi API saat ini.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Diskriminator untuk jenis turunan.

ContentKeyPolicyWidevineConfiguration

Menentukan konfigurasi untuk lisensi Widevine.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Diskriminator untuk jenis turunan.

widevineTemplate

string

Templat Widevine.

ContentKeyPolicyX509CertificateTokenKey

Menentukan sertifikat untuk validasi token.

Nama Jenis Deskripsi
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Diskriminator untuk jenis turunan.

rawBody

string

Bidang data mentah sertifikat dalam format PKCS 12 (X509Certificate2 di .NET)

createdByType

Jenis identitas yang membuat sumber daya.

Nama Jenis Deskripsi
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

SecurityLevel

Tingkat keamanan.

Nama Jenis Deskripsi
SL150

string

Untuk klien yang sedang dalam pengembangan atau pengujian. Tidak ada perlindungan terhadap penggunaan yang tidak sah.

SL2000

string

Untuk perangkat dan aplikasi yang diperkeras yang menggunakan konten komersial. Perlindungan perangkat lunak atau perangkat keras.

SL3000

string

Hanya untuk perangkat yang diperkeras. Perlindungan perangkat keras.

Unknown

string

Mewakili SecurityLevel yang tidak tersedia dalam versi API saat ini.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir mengubah sumber daya.