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 Multimédia

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

Parâmetros do URI

Name Em Necessário Tipo Description
accountName
path True

string

O nome da conta dos Serviços de Multimédia.

contentKeyPolicyName
path True

string

O nome da Política de Chave de Conteúdo.

resourceGroupName
path True

string

O nome do grupo de recursos na subscrição do Azure.

subscriptionId
path True

string

O identificador exclusivo de uma subscrição do Microsoft Azure.

api-version
query True

string

A versão da API a ser utilizada com o pedido de cliente.

Respostas

Name Tipo Description
200 OK

ContentKeyPolicy

OK

Other Status Codes

ErrorResponse

Informações detalhadas sobre o erro.

Exemplos

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

Definições

Name Description
ContentKeyPolicy

Um recurso de Política de Chave de Conteúdo.

ContentKeyPolicyClearKeyConfiguration

Representa uma configuração para chaves não DRM.

ContentKeyPolicyFairPlayConfiguration

Especifica uma configuração para licenças do FairPlay.

ContentKeyPolicyFairPlayOfflineRentalConfiguration
ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

ContentKeyPolicyOpenRestriction

Representa uma restrição aberta. A licença ou chave será entregue em todos os pedidos.

ContentKeyPolicyOption

Representa uma opção de política.

ContentKeyPolicyPlayReadyConfiguration

Especifica uma configuração para licenças playReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que o ID da chave de conteúdo está no cabeçalho PlayReady.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que o ID da chave de conteúdo é especificado na configuração PlayReady.

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura os bits de controlo Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, veja As Regras de Conformidade do PlayReady.

ContentKeyPolicyPlayReadyLicense

A licença do PlayReady

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

ContentKeyPolicyPlayReadyPlayRight

Configura o Play Right na licença PlayReady.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

ContentKeyPolicyRestrictionTokenType

O tipo de token.

ContentKeyPolicyRsaTokenKey

Especifica uma chave RSA para validação de tokens

ContentKeyPolicySymmetricTokenKey

Especifica uma chave simétrica para validação de tokens.

ContentKeyPolicyTokenClaim

Representa uma afirmação de token.

ContentKeyPolicyTokenRestriction

Representa uma restrição de tokens. O token fornecido tem de corresponder a estes requisitos para a entrega com êxito da licença ou da chave.

ContentKeyPolicyUnknownConfiguration

Representa uma ContentKeyPolicyConfiguration que não está disponível na versão atual da API.

ContentKeyPolicyUnknownRestriction

Representa uma ContentKeyPolicyRestriction que não está disponível na versão atual da API.

ContentKeyPolicyWidevineConfiguration

Especifica uma configuração para licenças do Widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica um certificado para validação de tokens.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

SecurityLevel

O nível de segurança.

systemData

Metadados relativos à criação e última modificação do recurso.

ContentKeyPolicy

Um recurso de Política de Chave de Conteúdo.

Name Tipo Description
id

string

ID de recurso completamente qualificado 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 da Política.

properties.lastModified

string

A data da última modificação da Política

properties.options

ContentKeyPolicyOption[]

As opções da Política de Chaves.

properties.policyId

string

O ID da Política legada.

systemData

systemData

Os metadados do sistema relacionados com este recurso.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ContentKeyPolicyClearKeyConfiguration

Representa uma configuração para chaves não DRM.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration

O discriminador para tipos derivados.

ContentKeyPolicyFairPlayConfiguration

Especifica uma configuração para licenças do FairPlay.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyFairPlayConfiguration

O discriminador para tipos derivados.

ask

string

A chave que tem de ser utilizada como chave Do Segredo da Aplicação FairPlay. Tem de ser codificado em base64.

fairPlayPfx

string

A representação Base64 do certificado FairPlay no formato PKCS 12 (pfx) (incluindo a chave privada).

fairPlayPfxPassword

string

A palavra-passe que encripta o certificado FairPlay no formato PKCS 12 (pfx).

offlineRentalConfiguration

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Política de aluguer offline

rentalAndLeaseKeyType

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

rentalDuration

integer

A duração do aluguer. Tem de ser maior ou igual a 0.

ContentKeyPolicyFairPlayOfflineRentalConfiguration

Name Tipo Description
playbackDurationSeconds

integer

Duração da reprodução

storageDurationSeconds

integer

Duração do armazenamento

ContentKeyPolicyFairPlayRentalAndLeaseKeyType

O tipo de chave de aluguer e concessão.

Name Tipo Description
DualExpiry

string

Expiração dupla para aluguer offline.

PersistentLimited

string

A chave de conteúdo pode ser persistente e a duração válida é limitada pelo valor Duração do Aluguer

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 que não está disponível na versão atual da API.

ContentKeyPolicyOpenRestriction

Representa uma restrição aberta. A licença ou chave será entregue em todos os pedidos.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyOpenRestriction

O discriminador para tipos derivados.

ContentKeyPolicyOption

Representa uma opção de política.

Name Tipo Description
configuration ContentKeyPolicyConfiguration:

A configuração de entrega de chaves.

name

string

A descrição da Opção de Política.

policyOptionId

string

O ID da Opção de Política legada.

restriction ContentKeyPolicyRestriction:

Os requisitos que têm de ser cumpridos para entregar chaves com esta configuração

ContentKeyPolicyPlayReadyConfiguration

Especifica uma configuração para licenças playReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyConfiguration

O discriminador para tipos derivados.

licenses

ContentKeyPolicyPlayReadyLicense[]

As licenças do PlayReady.

responseCustomData

string

Os dados de resposta personalizados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

Especifica que o ID da chave de conteúdo está no cabeçalho PlayReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader

O discriminador para tipos derivados.

ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

Especifica que o ID da chave de conteúdo é especificado na configuração PlayReady.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier

O discriminador para tipos derivados.

keyId

string

O ID da chave de conteúdo.

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

Name Tipo Description
UltraVioletDownload

string

Tipo de conteúdo de transferência ultravioleta.

UltraVioletStreaming

string

Tipo de conteúdo de transmissão em fluxo ultravioleta.

Unknown

string

Representa um ContentKeyPolicyPlayReadyContentType indisponível na versão atual da API.

Unspecified

string

Tipo de conteúdo não especificado.

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura os bits de controlo Restrição de Saída de Televisão Analógica Explícita. Para obter mais detalhes, veja As Regras de Conformidade do PlayReady.

Name Tipo Description
bestEffort

boolean

Indica se esta restrição é imposta numa base de Melhor Esforço.

configurationData

integer

Configura os bits de controlo de restrição. Tem de estar entre 0 e 3 inclusive.

ContentKeyPolicyPlayReadyLicense

A licença do PlayReady

Name Tipo Description
allowTestDevices

boolean

Um sinalizador que indica se os dispositivos de teste podem utilizar a licença.

beginDate

string

A data de início da licença

contentKeyLocation ContentKeyPolicyPlayReadyContentKeyLocation:

A localização da chave de conteúdo.

contentType

ContentKeyPolicyPlayReadyContentType

O tipo de conteúdo PlayReady.

expirationDate

string

A data de expiração da licença.

gracePeriod

string

O período de tolerância da licença.

licenseType

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

playRight

ContentKeyPolicyPlayReadyPlayRight

A licença PlayRight

relativeBeginDate

string

A data de início relativa da licença.

relativeExpirationDate

string

A data de expiração relativa da licença.

securityLevel

SecurityLevel

O nível de segurança.

ContentKeyPolicyPlayReadyLicenseType

O tipo de licença.

Name Tipo Description
NonPersistent

string

Licença não persistente.

Persistent

string

Licença persistente. Permite a reprodução offline.

Unknown

string

Representa um ContentKeyPolicyPlayReadyLicenseType indisponível na versão atual da API.

ContentKeyPolicyPlayReadyPlayRight

Configura o Play Right na licença PlayReady.

Name Tipo Description
agcAndColorStripeRestriction

integer

Configura o Controlo de Ganhos Automáticos (AGC) e o Color Stripe na licença. Tem de estar entre 0 e 3 inclusive.

allowPassingVideoContentToUnknownOutput

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

analogVideoOpl

integer

Especifica o nível de proteção de saída para áudio digital comprimido.

compressedDigitalAudioOpl

integer

Especifica o nível de proteção de saída para áudio digital comprimido.

compressedDigitalVideoOpl

integer

Especifica o nível de proteção de saída para vídeo digital comprimido.

digitalVideoOnlyContentRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

explicitAnalogTelevisionOutputRestriction

ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction

Configura a Restrição de Saída de Televisão Analógica Explícita na licença. Os dados de configuração têm de estar entre 0 e 3 inclusive.

firstPlayExpiration

string

O período de tempo durante o qual a licença é válida após a licença ser utilizada pela primeira vez para reproduzir conteúdo.

imageConstraintForAnalogComponentVideoRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

imageConstraintForAnalogComputerMonitorRestriction

boolean

Ativa a Restrição de Imagem para a Restrição de Vídeo de Componente Analógico na licença.

scmsRestriction

integer

Configura o Sistema de Gestão de Cópias de Série (SCMS) na licença. Tem de estar entre 0 e 3 inclusive.

uncompressedDigitalAudioOpl

integer

Especifica o nível de proteção de saída para áudio digital descomprimido.

uncompressedDigitalVideoOpl

integer

Especifica o nível de proteção de saída para vídeo digital descomprimido.

ContentKeyPolicyPlayReadyUnknownOutputPassingOption

Configura as definições de processamento de saída desconhecidas da licença.

Name Tipo Description
Allowed

string

É permitida a transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida.

AllowedWithVideoConstriction

string

A transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida é permitida, mas com resolução restrita.

NotAllowed

string

Não é permitida a transmissão da parte do vídeo de conteúdo protegido para uma Saída Desconhecida.

Unknown

string

Representa um ContentKeyPolicyPlayReadyUnknownOutputPassingOption indisponível na versão atual da API.

ContentKeyPolicyRestrictionTokenType

O tipo de token.

Name Tipo Description
Jwt

string

Token Web JSON.

Swt

string

Token Web Simples.

Unknown

string

Representa um ContentKeyPolicyRestrictionTokenType indisponível na versão atual da API.

ContentKeyPolicyRsaTokenKey

Especifica uma chave RSA para validação de tokens

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyRsaTokenKey

O discriminador para tipos derivados.

exponent

string

O expoente do Parâmetro RSA

modulus

string

O módulo do Parâmetro RSA

ContentKeyPolicySymmetricTokenKey

Especifica uma chave simétrica para validação de tokens.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicySymmetricTokenKey

O discriminador para tipos derivados.

keyValue

string

O valor chave da chave

ContentKeyPolicyTokenClaim

Representa uma afirmação de token.

Name Tipo Description
claimType

string

Tipo de afirmação de token.

claimValue

string

Valor da afirmação de token.

ContentKeyPolicyTokenRestriction

Representa uma restrição de tokens. O token fornecido tem de corresponder a estes requisitos para a entrega com êxito da licença ou da chave.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyTokenRestriction

O discriminador para tipos derivados.

alternateVerificationKeys ContentKeyPolicyRestrictionTokenKey[]:

Uma lista de chaves de verificação alternativas.

audience

string

A audiência do token.

issuer

string

O emissor de tokens.

openIdConnectDiscoveryDocument

string

O documento de deteção do openID connect.

primaryVerificationKey ContentKeyPolicyRestrictionTokenKey:

A chave de verificação primária.

requiredClaims

ContentKeyPolicyTokenClaim[]

Uma lista de afirmações de token necessárias.

restrictionTokenType

ContentKeyPolicyRestrictionTokenType

O tipo de token.

ContentKeyPolicyUnknownConfiguration

Representa uma ContentKeyPolicyConfiguration que não está disponível na versão atual da API.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownConfiguration

O discriminador para tipos derivados.

ContentKeyPolicyUnknownRestriction

Representa uma ContentKeyPolicyRestriction que não está disponível na versão atual da API.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyUnknownRestriction

O discriminador para tipos derivados.

ContentKeyPolicyWidevineConfiguration

Especifica uma configuração para licenças do Widevine.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyWidevineConfiguration

O discriminador para tipos derivados.

widevineTemplate

string

O modelo Widevine.

ContentKeyPolicyX509CertificateTokenKey

Especifica um certificado para validação de tokens.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ContentKeyPolicyX509CertificateTokenKey

O discriminador para tipos derivados.

rawBody

string

O campo de dados não processados de um certificado no formato PKCS 12 (X509Certificate2 em .NET)

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

SecurityLevel

O nível de segurança.

Name Tipo Description
SL150

string

Para clientes em desenvolvimento ou teste. Sem proteção contra utilização não autorizada.

SL2000

string

Para dispositivos e aplicações endurecidos que consomem conteúdo comercial. Proteção contra software ou hardware.

SL3000

string

Apenas para dispositivos endurecidos. Proteção de hardware.

Unknown

string

Representa um Nível de Segurança que não está disponível na versão atual da API.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

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

createdByType

O tipo de identidade que modificou o recurso pela última vez.