Udostępnij za pośrednictwem


Content Key Policies - Update

Aktualizowanie zasad klucza zawartości
Aktualizacje istniejących zasad klucza zawartości na koncie usługi Media Services

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

Nazwa konta usługi Media Services.

contentKeyPolicyName
path True

string

Nazwa zasad klucza zawartości.

resourceGroupName
path True

string

Nazwa grupy zasobów w ramach subskrypcji platformy Azure.

subscriptionId
path True

string

Unikatowy identyfikator subskrypcji platformy Microsoft Azure.

api-version
query True

string

Wersja interfejsu API, która ma być używana z żądaniem klienta.

Treść żądania

Nazwa Wymagane Typ Opis
properties.options True

ContentKeyPolicyOption[]

Opcje kluczowe zasady.

properties.description

string

Opis zasad.

Odpowiedzi

Nazwa Typ Opis
200 OK

ContentKeyPolicy

OK

Other Status Codes

ErrorResponse

Szczegółowe informacje o błędzie.

Przykłady

Update a Content Key Policy

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ContentKeyPolicy

Zasób zasad klucza zawartości.

ContentKeyPolicyClearKeyConfiguration

Reprezentuje konfigurację kluczy innych niż DRM.

ContentKeyPolicyFairPlayConfiguration

Określa konfigurację licencji FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klucza wynajmu i dzierżawy.

ContentKeyPolicyOpenRestriction

Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie.

ContentKeyPolicyOption

Reprezentuje opcję zasad.

ContentKeyPolicyPlayReadyConfiguration

Określa konfigurację licencji PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady.

ContentKeyPolicyPlayReadyContentType

Typ zawartości PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje bity kontroli ograniczeń wyjścia telewizji analogowej jawnej. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady.

ContentKeyPolicyPlayReadyLicense

Licencja PlayReady

ContentKeyPolicyPlayReadyLicenseType

Typ licencji.

ContentKeyPolicyPlayReadyPlayRight

Konfiguruje prawo odtwarzania w licencji PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyRsaTokenKey

Określa klucz RSA na potrzeby weryfikacji tokenu

ContentKeyPolicySymmetricTokenKey

Określa klucz symetryczny do weryfikacji tokenu.

ContentKeyPolicyTokenClaim

Reprezentuje oświadczenie tokenu.

ContentKeyPolicyTokenRestriction

Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza.

ContentKeyPolicyUnknownConfiguration

Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.

ContentKeyPolicyUnknownRestriction

Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API.

ContentKeyPolicyWidevineConfiguration

Określa konfigurację licencji Widevine.

ContentKeyPolicyX509CertificateTokenKey

Określa certyfikat do weryfikacji tokenu.

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

SecurityLevel

Poziom zabezpieczeń.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

ContentKeyPolicy

Zasób zasad klucza zawartości.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nazwa zasobu

properties.created

string

Data utworzenia zasad

properties.description

string

Opis zasad.

properties.lastModified

string

Data ostatniej modyfikacji zasad

properties.options

ContentKeyPolicyOption[]

Opcje kluczowe zasady.

properties.policyId

string

Starszy identyfikator zasad.

systemData

systemData

Metadane systemowe odnoszące się do tego zasobu.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ContentKeyPolicyClearKeyConfiguration

Reprezentuje konfigurację kluczy innych niż DRM.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

Dyskryminator typów pochodnych.

ContentKeyPolicyFairPlayConfiguration

Określa konfigurację licencji FairPlay.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

Dyskryminator typów pochodnych.

ask

string

Klucz, który musi być używany jako klucz tajny aplikacji FairPlay. Musi to być zakodowane w formacie Base64.

fairPlayPfx

string

Reprezentacja certyfikatu FairPlay w formacie Base64 w formacie PKCS 12 (pfx) (w tym klucz prywatny).

fairPlayPfxPassword

string

Hasło szyfrujące certyfikat FairPlay w formacie PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Zasady wypożyczania w trybie offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klucza wynajmu i dzierżawy.

rentalDuration

integer

Czas trwania wynajmu. Musi być równa 0 lub większa.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Nazwa Typ Opis
playbackDurationSeconds

integer

Czas trwania odtwarzania

storageDurationSeconds

integer

Okres przechowywania

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

Typ klucza wynajmu i dzierżawy.

Nazwa Typ Opis
DualExpiry

string

Podwójny czas wygaśnięcia do wynajęcia w trybie offline.

PersistentLimited

string

Klucz zawartości można utrwalić, a prawidłowy czas trwania jest ograniczony przez wartość Czas trwania wynajmu

PersistentUnlimited

string

Klucz zawartości można utrwał z nieograniczonym czasem trwania

Undefined

string

Nie określono czasu trwania klucza.

Unknown

string

Reprezentuje właściwość ContentKeyPolicyFairPlayRentalAndLeaseKeyType, która jest niedostępna w bieżącej wersji interfejsu API.

ContentKeyPolicyOpenRestriction

Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

Dyskryminator typów pochodnych.

ContentKeyPolicyOption

Reprezentuje opcję zasad.

Nazwa Typ Opis
configuration ContentKeyPolicyConfiguration:

Konfiguracja dostarczania kluczy.

name

string

Opis opcji zasad.

policyOptionId

string

Starszy identyfikator opcji zasad.

restriction ContentKeyPolicyRestriction:

Wymagania, które muszą zostać spełnione w celu dostarczenia kluczy z tą konfiguracją

ContentKeyPolicyPlayReadyConfiguration

Określa konfigurację licencji PlayReady.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

Dyskryminator typów pochodnych.

licenses

ContentKeyPolicyPlayReadyLicense[]

Licencje PlayReady.

responseCustomData

string

Niestandardowe dane odpowiedzi.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Dyskryminator typów pochodnych.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Dyskryminator typów pochodnych.

keyId

string

Identyfikator klucza zawartości.

ContentKeyPolicyPlayReadyContentType

Typ zawartości PlayReady.

Nazwa Typ Opis
UltraVioletDownload

string

Typ zawartości pobierania ultrafioletnie.

UltraVioletStreaming

string

Typ zawartości przesyłania strumieniowego w formacie ultrafioletowym.

Unknown

string

Reprezentuje właściwość ContentKeyPolicyPlayReadyContentType, która jest niedostępna w bieżącej wersji interfejsu API.

Unspecified

string

Nieokreślony typ zawartości.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje bity kontroli ograniczeń wyjścia telewizji analogowej jawnej. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady.

Nazwa Typ Opis
bestEffort

boolean

Wskazuje, czy to ograniczenie jest wymuszane w oparciu o najlepsze wysiłki.

configurationData

integer

Konfiguruje bity kontroli ograniczeń. Musi należeć do przedziału od 0 do 3 włącznie.

ContentKeyPolicyPlayReadyLicense

Licencja PlayReady

Nazwa Typ Opis
allowTestDevices

boolean

Flaga wskazująca, czy urządzenia testowe mogą korzystać z licencji.

beginDate

string

Data rozpoczęcia licencji

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

Lokalizacja klucza zawartości.

contentType

ContentKeyPolicyPlayReadyContentType

Typ zawartości PlayReady.

expirationDate

string

Data wygaśnięcia licencji.

gracePeriod

string

Okres prolongaty licencji.

licenseType

ContentKeyPolicyPlayReadyLicenseType

Typ licencji.

playRight

ContentKeyPolicyPlayReadyPlayRight

Licencja PlayRight

relativeBeginDate

string

Względna data rozpoczęcia licencji.

relativeExpirationDate

string

Względna data wygaśnięcia licencji.

securityLevel

SecurityLevel

Poziom zabezpieczeń.

ContentKeyPolicyPlayReadyLicenseType

Typ licencji.

Nazwa Typ Opis
NonPersistent

string

Licencja nietrwalna.

Persistent

string

Licencja trwała. Umożliwia odtwarzanie w trybie offline.

Unknown

string

Reprezentuje właściwość ContentKeyPolicyPlayReadyLicenseType, która jest niedostępna w bieżącej wersji interfejsu API.

ContentKeyPolicyPlayReadyPlayRight

Konfiguruje prawo odtwarzania w licencji PlayReady.

Nazwa Typ Opis
agcAndColorStripeRestriction

integer

Konfiguruje automatyczną kontrolę przyrostk (AGC) i pasek kolorów w licencji. Musi należeć do przedziału od 0 do 3 włącznie.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji.

analogVideoOpl

integer

Określa poziom ochrony danych wyjściowych dla skompresowanego dźwięku cyfrowego.

compressedDigitalAudioOpl

integer

Określa poziom ochrony danych wyjściowych dla skompresowanego dźwięku cyfrowego.

compressedDigitalVideoOpl

integer

Określa poziom ochrony danych wyjściowych skompresowanego wideo cyfrowego.

digitalVideoOnlyContentRestriction

boolean

Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Konfiguruje jawne ograniczenie wyjścia telewizji analogowej w licencji. Dane konfiguracji muszą należeć do przedziału od 0 do 3 włącznie.

firstPlayExpiration

string

Czas ważności licencji po pierwszym użyciu licencji do odtwarzania zawartości.

imageConstraintForAnalogComponentVideoRestriction

boolean

Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Włącza ograniczenie obrazu dla ograniczeń wideo składników analogowych w licencji.

scmsRestriction

integer

Konfiguruje system zarządzania kopiami seryjnymi (SCMS) w licencji. Musi należeć do przedziału od 0 do 3 włącznie.

uncompressedDigitalAudioOpl

integer

Określa poziom ochrony danych wyjściowych dla nieskompresowanego dźwięku cyfrowego.

uncompressedDigitalVideoOpl

integer

Określa poziom ochrony danych wyjściowych dla nieskompresowanego cyfrowego wideo.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji.

Nazwa Typ Opis
Allowed

string

Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest dozwolone.

AllowedWithVideoConstriction

string

Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest dozwolone, ale z ograniczonym rozwiązaniem.

NotAllowed

string

Przekazywanie części chronionej zawartości wideo do nieznanych danych wyjściowych jest niedozwolone.

Unknown

string

Reprezentuje element ContentKeyPolicyPlayReadyUnknownOutputPassingOption, który jest niedostępny w bieżącej wersji interfejsu API.

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

Nazwa Typ Opis
Jwt

string

Token internetowy JSON.

Swt

string

Prosty token internetowy.

Unknown

string

Reprezentuje właściwość ContentKeyPolicyRestrictionTokenType, która jest niedostępna w bieżącej wersji interfejsu API.

ContentKeyPolicyRsaTokenKey

Określa klucz RSA na potrzeby weryfikacji tokenu

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

Dyskryminator typów pochodnych.

exponent

string

Wykładnik parametru RSA

modulus

string

Modulo parametru RSA

ContentKeyPolicySymmetricTokenKey

Określa klucz symetryczny do weryfikacji tokenu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

Dyskryminator typów pochodnych.

keyValue

string

Wartość klucza klucza

ContentKeyPolicyTokenClaim

Reprezentuje oświadczenie tokenu.

Nazwa Typ Opis
claimType

string

Typ oświadczenia tokenu.

claimValue

string

Wartość oświadczenia tokenu.

ContentKeyPolicyTokenRestriction

Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

Dyskryminator typów pochodnych.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Lista alternatywnych kluczy weryfikacji.

audience

string

Odbiorcy tokenu.

issuer

string

Wystawca tokenu.

openIdConnectDiscoveryDocument

string

Dokument OpenID connect discovery (Identyfikator openID łączenia odnajdywania).

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

Podstawowy klucz weryfikacji.

requiredClaims

ContentKeyPolicyTokenClaim[]

Lista wymaganych oświadczeń tokenu.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

Typ tokenu.

ContentKeyPolicyUnknownConfiguration

Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

Dyskryminator typów pochodnych.

ContentKeyPolicyUnknownRestriction

Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

Dyskryminator typów pochodnych.

ContentKeyPolicyWidevineConfiguration

Określa konfigurację licencji Widevine.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

Dyskryminator typów pochodnych.

widevineTemplate

string

Szablon Widevine.

ContentKeyPolicyX509CertificateTokenKey

Określa certyfikat do weryfikacji tokenu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

Dyskryminator typów pochodnych.

rawBody

string

Pole danych pierwotnych certyfikatu w formacie PKCS 12 (X509Certificate2 na platformie .NET)

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

SecurityLevel

Poziom zabezpieczeń.

Nazwa Typ Opis
SL150

string

W przypadku klientów w ramach programowania lub testowania. Brak ochrony przed nieautoryzowanym użyciem.

SL2000

string

W przypadku urządzeń ze wzmocnionym zabezpieczeniami i aplikacji korzystających z zawartości komercyjnej. Ochrona oprogramowania lub sprzętu.

SL3000

string

Tylko w przypadku urządzeń ze wzmocnionym zabezpieczeniami. Ochrona sprzętowa.

Unknown

string

Reprezentuje poziom zabezpieczeń, który jest niedostępny w bieżącej wersji interfejsu API.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.