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 |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usługi Media Services. |
content
|
path | True |
string |
Nazwa zasad klucza zawartości. |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
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 |
Opcje kluczowe zasady. |
|
properties.description |
string |
Opis zasad. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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 |
---|---|
Content |
Zasób zasad klucza zawartości. |
Content |
Reprezentuje konfigurację kluczy innych niż DRM. |
Content |
Określa konfigurację licencji FairPlay. |
Content |
|
Content |
Typ klucza wynajmu i dzierżawy. |
Content |
Reprezentuje otwarte ograniczenie. Licencja lub klucz zostaną dostarczone na każde żądanie. |
Content |
Reprezentuje opcję zasad. |
Content |
Określa konfigurację licencji PlayReady. |
Content |
Określa, że identyfikator klucza zawartości znajduje się w nagłówku PlayReady. |
Content |
Określa, że identyfikator klucza zawartości jest określony w konfiguracji PlayReady. |
Content |
Typ zawartości PlayReady. |
Content |
Konfiguruje bity kontroli ograniczeń wyjścia telewizji analogowej jawnej. Aby uzyskać więcej informacji, zobacz Reguły zgodności PlayReady. |
Content |
Licencja PlayReady |
Content |
Typ licencji. |
Content |
Konfiguruje prawo odtwarzania w licencji PlayReady. |
Content |
Konfiguruje ustawienia obsługi nieznanych danych wyjściowych licencji. |
Content |
Typ tokenu. |
Content |
Określa klucz RSA na potrzeby weryfikacji tokenu |
Content |
Określa klucz symetryczny do weryfikacji tokenu. |
Content |
Reprezentuje oświadczenie tokenu. |
Content |
Reprezentuje ograniczenie tokenu. Podany token musi być zgodny z tymi wymaganiami dotyczącymi pomyślnego dostarczania licencji lub klucza. |
Content |
Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API. |
Content |
Reprezentuje właściwość ContentKeyPolicyRestriction, która jest niedostępna w bieżącej wersji interfejsu API. |
Content |
Określa konfigurację licencji Widevine. |
Content |
Określa certyfikat do weryfikacji tokenu. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Security |
Poziom zabezpieczeń. |
system |
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 |
Opcje kluczowe zasady. |
|
properties.policyId |
string |
Starszy identyfikator zasad. |
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. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyFairPlayConfiguration
Określa konfigurację licencji FairPlay.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
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 |
Zasady wypożyczania w trybie offline |
|
rentalAndLeaseKeyType |
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. |
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. |
Dyskryminator typów pochodnych. |
licenses |
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. |
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. |
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 |
Typ zawartości PlayReady. |
|
expirationDate |
string |
Data wygaśnięcia licencji. |
gracePeriod |
string |
Okres prolongaty licencji. |
licenseType |
Typ licencji. |
|
playRight |
Licencja PlayRight |
|
relativeBeginDate |
string |
Względna data rozpoczęcia licencji. |
relativeExpirationDate |
string |
Względna data wygaśnięcia licencji. |
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 |
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 |
Content |
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. |
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. |
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. |
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 |
Lista wymaganych oświadczeń tokenu. |
|
restrictionTokenType |
Typ tokenu. |
ContentKeyPolicyUnknownConfiguration
Reprezentuje element ContentKeyPolicyConfiguration, który jest niedostępny w bieżącej wersji interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
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. |
Dyskryminator typów pochodnych. |
ContentKeyPolicyWidevineConfiguration
Określa konfigurację licencji Widevine.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
Dyskryminator typów pochodnych. |
widevineTemplate |
string |
Szablon Widevine. |
ContentKeyPolicyX509CertificateTokenKey
Określa certyfikat do weryfikacji tokenu.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |