Content Key Policies - Get
Obter uma política de chave de conteúdo
Obter os detalhes de uma política de chave de conteúdo na conta dos Serviços de Mídia
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta dos Serviços de Mídia. |
content
|
path | True |
string |
O nome da Política de Chave de Conteúdo. |
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura do Azure. |
subscription
|
path | True |
string |
O identificador exclusivo de uma assinatura do Microsoft Azure. |
api-version
|
query | True |
string |
A versão da API a ser usada com a solicitação do cliente. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Informações detalhadas de erro. |
Exemplos
Get a Content Key Policy by name
Solicitação de exemplo
Resposta de exemplo
{
"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"
}
}
]
}
}
Definições
Nome | Description |
---|---|
Content |
Um recurso de Política de Chave de Conteúdo. |
Content |
Representa uma configuração para chaves não DRM. |
Content |
Especifica uma configuração para licenças do FairPlay. |
Content |
|
Content |
O tipo de chave de aluguel e concessão. |
Content |
Representa uma restrição aberta. A licença ou a chave serão entregues em cada solicitação. |
Content |
Representa uma opção de política. |
Content |
Especifica uma configuração para licenças do PlayReady. |
Content |
Especifica que a ID da chave de conteúdo está no cabeçalho PlayReady. |
Content |
Especifica que a ID da chave de conteúdo é especificada na configuração do PlayReady. |
Content |
O tipo de conteúdo PlayReady. |
Content |
Configura os bits de controle de Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, consulte As Regras de Conformidade do PlayReady. |
Content |
A licença do PlayReady |
Content |
O tipo de licença. |
Content |
Configura o Play Right na licença do PlayReady. |
Content |
Define as configurações de tratamento de saída desconhecidas da licença. |
Content |
O tipo de token. |
Content |
Especifica uma chave RSA para validação de token |
Content |
Especifica uma chave simétrica para validação de token. |
Content |
Representa uma declaração de token. |
Content |
Representa uma restrição de token. O token fornecido deve corresponder a esses requisitos para a licença bem-sucedida ou a entrega de chaves. |
Content |
Representa um ContentKeyPolicyConfiguration que não está disponível na versão atual da API. |
Content |
Representa um ContentKeyPolicyRestriction que não está disponível na versão atual da API. |
Content |
Especifica uma configuração para licenças widevine. |
Content |
Especifica um certificado para validação de token. |
created |
O tipo de identidade que criou o recurso. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Security |
O nível de segurança. |
system |
Metadados relativos à criação e à última modificação do recurso. |
ContentKeyPolicy
Um recurso de Política de Chave de Conteúdo.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties.created |
string |
A data de criação da política |
properties.description |
string |
Uma descrição para a política. |
properties.lastModified |
string |
A data da última modificação da política |
properties.options |
As principais opções de política. |
|
properties.policyId |
string |
A ID de política herdada. |
systemData |
Os metadados do sistema relacionados a esse recurso. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
Representa uma configuração para chaves não DRM.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
ContentKeyPolicyFairPlayConfiguration
Especifica uma configuração para licenças do FairPlay.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
ask |
string |
A chave que deve ser usada como chave do Segredo do Aplicativo FairPlay. Isso precisa ser codificado em base64. |
fairPlayPfx |
string |
A representação Base64 do certificado FairPlay no formato PKCS 12 (pfx) (incluindo chave privada). |
fairPlayPfxPassword |
string |
A senha que criptografa o certificado FairPlay no formato PKCS 12 (pfx). |
offlineRentalConfiguration |
Política de aluguel offline |
|
rentalAndLeaseKeyType |
O tipo de chave de aluguel e concessão. |
|
rentalDuration |
integer |
A duração do aluguel. Deve ser maior que ou igual a 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Nome | Tipo | Description |
---|---|---|
playbackDurationSeconds |
integer |
Duração da reprodução |
storageDurationSeconds |
integer |
Duração do armazenamento |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
O tipo de chave de aluguel e concessão.
Nome | Tipo | Description |
---|---|---|
DualExpiry |
string |
Expiração dupla para aluguel offline. |
PersistentLimited |
string |
A chave de conteúdo pode ser mantida e a duração válida é limitada pelo valor Duração do Aluguel |
PersistentUnlimited |
string |
A chave de conteúdo pode ser mantida com uma duração ilimitada |
Undefined |
string |
A duração da chave não é especificada. |
Unknown |
string |
Representa um ContentKeyPolicyFairPlayRentalAndLeaseKeyType indisponível na versão atual da API. |
ContentKeyPolicyOpenRestriction
Representa uma restrição aberta. A licença ou a chave serão entregues em cada solicitação.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
ContentKeyPolicyOption
Representa uma opção de política.
Nome | Tipo | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
A configuração de entrega de chave. |
name |
string |
A descrição da Opção de Política. |
policyOptionId |
string |
A ID da Opção de Política herdada. |
restriction | ContentKeyPolicyRestriction: |
Os requisitos que devem ser atendidos para fornecer chaves com essa configuração |
ContentKeyPolicyPlayReadyConfiguration
Especifica uma configuração para licenças do PlayReady.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
licenses |
As licenças do PlayReady. |
|
responseCustomData |
string |
Os dados de resposta personalizados. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Especifica que a ID da chave de conteúdo está no cabeçalho PlayReady.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Especifica que a ID da chave de conteúdo é especificada na configuração do PlayReady.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyId |
string |
A ID da chave de conteúdo. |
ContentKeyPolicyPlayReadyContentType
O tipo de conteúdo PlayReady.
Nome | Tipo | Description |
---|---|---|
UltraVioletDownload |
string |
Tipo de conteúdo de download de ultravioleta. |
UltraVioletStreaming |
string |
Tipo de conteúdo de streaming ultravioleta. |
Unknown |
string |
Representa um ContentKeyPolicyPlayReadyContentType que não está disponível na versão atual da API. |
Unspecified |
string |
Tipo de conteúdo não especificado. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Configura os bits de controle de Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, consulte As Regras de Conformidade do PlayReady.
Nome | Tipo | Description |
---|---|---|
bestEffort |
boolean |
Indica se essa restrição é imposta com base no Melhor Esforço. |
configurationData |
integer |
Configura os bits de controle de restrição. Deve estar entre 0 e 3, inclusive. |
ContentKeyPolicyPlayReadyLicense
A licença do PlayReady
Nome | Tipo | Description |
---|---|---|
allowTestDevices |
boolean |
Um sinalizador que indica se os dispositivos de teste podem usar a licença. |
beginDate |
string |
A data de início da licença |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
O local da chave de conteúdo. |
contentType |
O tipo de conteúdo PlayReady. |
|
expirationDate |
string |
A data de validade da licença. |
gracePeriod |
string |
O período de carência da licença. |
licenseType |
O tipo de licença. |
|
playRight |
A licença PlayRight |
|
relativeBeginDate |
string |
A data de início relativa da licença. |
relativeExpirationDate |
string |
A data de validade relativa da licença. |
securityLevel |
O nível de segurança. |
ContentKeyPolicyPlayReadyLicenseType
O tipo de licença.
Nome | Tipo | Description |
---|---|---|
NonPersistent |
string |
Licença não persistente. |
Persistent |
string |
Licença persistente. Permite a reprodução offline. |
Unknown |
string |
Representa um ContentKeyPolicyPlayReadyLicenseType que não está disponível na versão atual da API. |
ContentKeyPolicyPlayReadyPlayRight
Configura o Play Right na licença do PlayReady.
Nome | Tipo | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Configura o AGC (Controle de Ganho Automático) e a Faixa de Cores na licença. Deve estar entre 0 e 3, inclusive. |
allowPassingVideoContentToUnknownOutput |
Define as configurações de tratamento de saída desconhecidas da licença. |
|
analogVideoOpl |
integer |
Especifica o nível de proteção de saída para áudio digital compactado. |
compressedDigitalAudioOpl |
integer |
Especifica o nível de proteção de saída para áudio digital compactado. |
compressedDigitalVideoOpl |
integer |
Especifica o nível de proteção de saída para vídeo digital compactado. |
digitalVideoOnlyContentRestriction |
boolean |
Habilita a restrição de imagem para restrição de vídeo de componente analógico na licença. |
explicitAnalogTelevisionOutputRestriction |
Content |
Configura a restrição explícita de saída de televisão analógica na licença. Os dados de configuração devem estar entre 0 e 3, inclusive. |
firstPlayExpiration |
string |
A quantidade de tempo que a licença é válida depois que a licença é usada pela primeira vez para reproduzir conteúdo. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Habilita a restrição de imagem para restrição de vídeo de componente analógico na licença. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Habilita a restrição de imagem para restrição de vídeo de componente analógico na licença. |
scmsRestriction |
integer |
Configura o SCMS (Serial Copy Management System) na licença. Deve estar entre 0 e 3, inclusive. |
uncompressedDigitalAudioOpl |
integer |
Especifica o nível de proteção de saída para áudio digital descompactado. |
uncompressedDigitalVideoOpl |
integer |
Especifica o nível de proteção de saída para vídeo digital descompactado. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Define as configurações de tratamento de saída desconhecidas da licença.
Nome | Tipo | Description |
---|---|---|
Allowed |
string |
É permitido passar a parte de vídeo do conteúdo protegido para uma Saída Desconhecida. |
AllowedWithVideoConstriction |
string |
A passagem da parte de vídeo do conteúdo protegido para uma Saída Desconhecida é permitida, mas com resolução restrita. |
NotAllowed |
string |
Não é permitido passar a parte de vídeo do conteúdo protegido para uma Saída Desconhecida. |
Unknown |
string |
Representa um ContentKeyPolicyPlayReadyUnknownOutputPassingOption que não está disponível na versão atual da API. |
ContentKeyPolicyRestrictionTokenType
O tipo de token.
Nome | Tipo | Description |
---|---|---|
Jwt |
string |
Token Web JSON. |
Swt |
string |
Token Web simples. |
Unknown |
string |
Representa um ContentKeyPolicyRestrictionTokenType que não está disponível na versão atual da API. |
ContentKeyPolicyRsaTokenKey
Especifica uma chave RSA para validação de token
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
exponent |
string |
O expoente parâmetro RSA |
modulus |
string |
O módulo parâmetro RSA |
ContentKeyPolicySymmetricTokenKey
Especifica uma chave simétrica para validação de token.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyValue |
string |
O valor da chave |
ContentKeyPolicyTokenClaim
Representa uma declaração de token.
Nome | Tipo | Description |
---|---|---|
claimType |
string |
Tipo de declaração de token. |
claimValue |
string |
Valor da declaração de token. |
ContentKeyPolicyTokenRestriction
Representa uma restrição de token. O token fornecido deve corresponder a esses requisitos para a licença bem-sucedida ou a entrega de chaves.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Uma lista de chaves de verificação alternativas. |
audience |
string |
O público-alvo do token. |
issuer |
string |
O emissor do token. |
openIdConnectDiscoveryDocument |
string |
O documento de descoberta do OpenID Connect. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
A chave de verificação primária. |
requiredClaims |
Uma lista de declarações de token necessárias. |
|
restrictionTokenType |
O tipo de token. |
ContentKeyPolicyUnknownConfiguration
Representa um ContentKeyPolicyConfiguration que não está disponível na versão atual da API.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
ContentKeyPolicyUnknownRestriction
Representa um ContentKeyPolicyRestriction que não está disponível na versão atual da API.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
ContentKeyPolicyWidevineConfiguration
Especifica uma configuração para licenças widevine.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminatório para tipos derivados. |
widevineTemplate |
string |
O modelo widevine. |
ContentKeyPolicyX509CertificateTokenKey
Especifica um certificado para validação de token.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
rawBody |
string |
O campo de dados brutos de um certificado no formato PKCS 12 (X509Certificate2 no .NET) |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
SecurityLevel
O nível de segurança.
Nome | Tipo | Description |
---|---|---|
SL150 |
string |
Para clientes em desenvolvimento ou teste. Nenhuma proteção contra uso não autorizado. |
SL2000 |
string |
Para dispositivos e aplicativos protegidos que consomem conteúdo comercial. Proteção de software ou hardware. |
SL3000 |
string |
Somente para dispositivos protegidos. Proteção de hardware. |
Unknown |
string |
Representa um SecurityLevel que não está disponível na versão atual da API. |
systemData
Metadados relativos à criação e à última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |