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 |
|---|---|---|
IdSomente leitura. Definido pelos Serviços de Mídia no momento da criação. |
String | Identificador exclusivo. |
StateSomente 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. |
CreatedSomente 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. |
LastModifiedSomente 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. |
AlternateIdOpcional. |
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. |
NameOpcional. |
Edm.String | Nome amigável para o ativo. O comprimento máximo é 512. |
OptionsObrigató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 |
UriSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.String | O URI do contêiner de armazenamento de blobs do ativo especificado. |
LocatorsSomente 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. |
ContentKeysOpcional. |
Conjunto de entidades de ContentKey | O conjunto de entidades retornado contém todas as entidades de ContentKey que estão vinculadas ao ativo especificado. |
FilesSomente 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. |
ParentAssetsOpcional. |
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. |
StorageAccountNameOpcional. 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. |
StorageAccountSomente 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:
- A ação
Publishnão exclui localizadores associados ao ativo. Você deve excluir explicitamente os localizadores do código depois de chamarPublish. - A ação
Publishnão define o estado do ativo comoPublished. Remova o código que verifica se o ativo está no estadoPublished. Atualmente, um ativo pode ter apenas o estadoInitializedouDeleted.
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://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}
Removendo links ContentKey
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