Compartilhar via


Ativo

A entidade Asset contém arquivos digitais (incluindo vídeo, áudio, imagens, coleções de miniaturas, faixas de texto e arquivos de legenda codificada) e os metadados para esses arquivos. Depois que os arquivos digitais são carregados em um ativo, eles podem ser usados nos fluxos de trabalho de codificação e streaming dos serviços de mídia.

Ao codificar um ativo, um ativo de saída é produzido quando o trabalho de codificação é concluído. Entre os arquivos mencionados acima, o ativo de saída contém arquivos de metadados XML que descrevem o ativo de entrada e o ativo de saída. Para obter mais informações, confira os artigos Metadados de entrada e Metadados de saída.

As seguintes características se aplicam a um ativo nos Serviços de Mídia:

  • Um ativo é uma unidade lógica que representa uma apresentação audiovisual única.

  • Um ativo contém uma coleção de um a vários arquivos de mídia.

  • Os arquivos de um ativo estão localizados em um único contêiner de armazenamento blob.

Alguns exemplos de um Ativo são: um filme completo, programa de TV, edição específica; um clipe de um filme, programa de TV, animação, arquivo ISO da câmera ou evento; um trailer de filme ou vídeo promocional; um anúncio; um arquivo de áudio, um programa de rádio, um podcast ou um arquivo de som.

As seguintes características NÃO se aplicam a um ativo nos Serviços de Mídia:

  • Um simples contêiner de armazenamento

  • Uma pasta para organizar e armazenar múltiplas versões da mesma apresentação

  • Uma pasta para enviar um processamento em massa de várias apresentações audiovisuais para o Azure Media Encoder

Por exemplo, você não deve armazenar um filme, o seu trailer, um anúncio e uma versão de edição internacional do mesmo filme em um único ativo.

Este tópico oferece uma visão geral da entidade Asset e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades de entidade do ativo

Propriedade Tipo Descrição
Id

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.
String Identificador exclusivo.
State

Somente leitura. Configurada pelos Serviços de Mídia.
Edm.Int32 Um valor de enumeração que descreve o estado do ativo. Os valores do valor são:

- Inicializado = 0
- Publicado = 1 Aviso: a Publish ação foi preterida. Remova o código que verifica se o ativo está no estado Published.
- Excluído = 2

Um ativo está sempre no estado Inicializado até que seja excluído.
Created

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.
Edm.DateTime Esse valor é definido pelos Serviços de Mídia no momento da criação.
LastModified

Somente leitura. Configurada pelos Serviços de Mídia.
Edm.DateTime Esse valor é atualizado pelos Serviços de Mídia depois que qualquer alteração de propriedade é feita.
AlternateId

Opcional.
Edm.String Um valor de ID alternativo que corresponde a uma ID em outro sistema de gerenciamento de conteúdo. O comprimento máximo é 4000.
Name

Opcional.
Edm.String Nome amigável para o ativo. O comprimento máximo é 512.
Options

Obrigatórios. Não pode ser atualizada após a criação da entidade.
Edm.Int32 Um valor de enumeração que descreve as opções de criptografia com as quais um ativo pode ser criado. Um valor da lista abaixo é um valor válido, uma combinação de valores dessa lista, não:

- None = 0: não especifica opções de criação de ativos.
- StorageEncrypted = 1: especifica que os arquivos de um ativo devem ser criptografados para upload e armazenamento ao criar o ativo.
- CommonEncryptionProtected = 2: especifica que os arquivos de um ativo são protegidos usando um método de criptografia comum (como PlayReady).
- EnvelopeEncryptionProtected = 4
Uri

Somente leitura. Configurada pelos Serviços de Mídia.
Edm.String O URI do contêiner de armazenamento de blobs do ativo especificado.
Locators

Somente leitura. Configurada pelos Serviços de Mídia.
Conjunto de entidades do localizador O conjunto de entidades retornado contém todas as entidades do localizador que estão vinculadas ao ativo especificado.
ContentKeys

Opcional.
Conjunto de entidades de ContentKey O conjunto de entidades retornado contém todas as entidades de ContentKey que estão vinculadas ao ativo especificado.
Files

Somente leitura. Configurada pelos Serviços de Mídia.
Conjunto de entidades de arquivo O conjunto de entidades retornado contém todas as entidades de arquivo que estão vinculadas ao ativo especificado.
ParentAssets

Opcional.
Conjunto de entidades dos ativos pais O conjunto de entidade retornado contém todas as entidades de ativo pai que estão conectadas ao ativo especificado.
StorageAccountName

Opcional. Não pode ser atualizada após a criação da entidade.
Edm.String Nome da conta de armazenamento que contém o contêiner de blob do ativo.

Se não for especificado no momento da criação, os Serviços de Mídia definirão o nome da conta de armazenamento padrão.
StorageAccount

Somente leitura. Configurada pelos Serviços de Mídia.
Conjunto de entidades StorageAccount O conjunto de entidade retornado contém todas as entidades StorageAccount que estão conectadas ao ativo especificado.
DeliveryPolicies Conjunto de entidades AssetDeliveryPolicy O conjunto de entidades retornado contém políticas de entrega associadas ao ativo.
FormatOption Edm.Int32 Especifica diferentes opções de formato com as quais um ativo pode ser criado. Os valores permitidos são: 0 (padrão) – não especifica nenhuma opção de formato de ativo; 1 – especifica que o formato de um ativo será AdaptiveStreaming.

Criar um ativo

Os ativos podem ser criados usando uma solicitação HTTP POST e especificando os valores da propriedade.

Método URI da solicitação Versão de HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

POST https://<accountname>.restv2.<location>.media.azure.net/api/Assets HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization:  Bearer <token value>  
Host: media.windows.net  
Content-Length: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }  

Listar um ativo

Os ativos podem ser recuperados usando uma solicitação HTTP GET.

Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0  
  

Atualizar um ativo

Os ativos pode ser atualizados usando uma solicitação HTTP MERGE e as propriedades específicas que você deseja alterar.

Método URI da solicitação Versão de HTTP
MESCLAR <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }  

Excluir um ativo

Os ativos podem ser excluídos referenciando o valor da ID do ativo. Quando um ativo é excluído, todos os seus localizadores são excluídos por Serviços de Mídia do Microsoft Azure. Se o ativo tiver localizadores de origem, esses localizadores também serão revogados e excluídos. Todos os links para ContentKeys serão excluídos e quaisquer ContentKeys não vinculados a outros ativos serão excluídos.

Método URI da solicitação Versão de HTTP
Delete (excluir) <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0  
  

Publicar um ativo

Observação

A ação Publish foi substituída. A partir da versão mais recente dos Serviços de Mídia, Publish não deve ser usado.

Se o seu código usa Publish, esteja atento às seguintes considerações:

  1. A ação Publish não exclui localizadores associados ao ativo. Você deve excluir explicitamente os localizadores do código depois de chamar Publish.
  2. A ação Publish não define o estado do ativo como Published. Remova o código que verifica se o ativo está no estado Published. Atualmente, um ativo pode ter apenas o estado Initialized ou Deleted.

Vinculando chaves de conteúdo a ativos

Você pode vincular uma ContentKey a um ativo fazendo referência à ID do ativo com uma solicitação HTTP POST. O URI do ContentKey deve estar incluído no corpo da solicitação. Só é possível vincular um tipo de ContentKey que corresponda ao tipo especificado em CreationOptions do ativo. Por exemplo, se um ativo tiver as opções definidas como StorageEncrypted(1), o ContentKey deverá ser do tipo StorageEncryption(1).

Método URI da solicitação Versão de HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

POST https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}  
  

Você pode remover links contentKey de um ativo referenciando a ID do ativo e a ID contentKey em uma solicitação HTTP DELETE. Se o ContentKey não estiver vinculado a nenhum outro ativo, ele será excluído.

Método URI da solicitação Versão de HTTP
Delete (excluir) <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0  
  

Consulte Também

AccessPolicy
ContentKey
AssetFile
Trabalho
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Ingestão de Ativos com o API REST de Serviços de Mídia
Cotas e limitações