Compartilhar via

AssetFile

  • Artigo

A entidade AssetFile representa um arquivo de áudio ou vídeo real que é armazenado em um contêiner de blob. Um arquivo de ativo está sempre associado a um ativo, e um ativo pode conter um ou vários arquivos. A tarefa do Codificador dos serviços de mídia falha se um objeto de arquivo de ativo não estiver associado um arquivo digital em um contêiner de blob.

Este tópico oferece uma visão geral da entidade AssetFile 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 AssetFile

Propriedade Tipo Descrição
Id

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

Obrigatórios.		 Edm.String Nome amigável para o AssetFile. O valor padrão é o nome do arquivo usado durante o carregamento do arquivo. O comprimento máximo é 260. Nota: Os Serviços de Mídia usam o valor da Name propriedade ao criar URLs para o conteúdo de streaming (por exemplo, http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Por esse motivo, a codificação por porcentagem não é permitida. O valor da propriedade Name não pode ter quaisquer dos seguintes caracteres reservados para codificação de percentual: !*'();:@&=+$,/?%#[]". Além disso, pode haver somente um ‘.’ Além disso, pode haver somente um '.' para a extensão de nome de arquivo.
ContentFileSize

Opcional.		 Edm.Int64 Tamanho (em bytes) do conteúdo do AssetFile.
ParentAssetId

Obrigatórios. Não pode ser atualizada após a criação da entidade.		 Edm.String A ID do ativo ao qual este arquivo está associado.
EncryptionVersion

Opcional.		 Edm.String A versão com suporte atualmente para o StorageEncryption e o CommonEncryption é a "1.0"
EncryptionScheme

Opcional.		 Edm.String O esquema de criptografia usado para esse arquivo. Os valores válidos são: "StorageEncryption" ou "CommonEncryption".
IsEncrypted

Opcional.		 Edm.Boolean Este valor deverá ser definido como true se esse arquivo for armazenado criptografado.
EncryptionKeyId

Opcional.		 Edm.String ID de ContentKey criptografada.
InitializationVector

Opcional.		 Edm.String O vetor de inicialização usado para criptografia de armazenamento.
IsPrimary

Opcional.		 Edm.Boolean Determina se esse arquivo é o primeiro arquivo de um ativo com vários arquivos.
LastModified

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.		 Edm.DateTime Esse valor é atualizado pelos Serviços de Mídia depois que quaisquer alterações de propriedade são feitas. Representa o número de milissegundos desde a meia-noite de 1º de janeiro de 1970.
Created

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.		 Edm.DateTime Representa o número de milissegundos desde a meia-noite de 1º de janeiro de 1970.
MimeType

Opcional.		 Edm.String O Media Services não inspeciona nenhum blob carregado, portanto você deve definir o tipo MIME. Por exemplo, "texto/sem formatação" ou "vídeo/x-ms-wmv" são valores válidos para usar. O comprimento máximo é 4000.
ContentChecksum

Opcional.		 Edm.String Um número hexadecimal que representa um valor de resumo da mensagem MD5 (RFC 1321). Esse valor é definido pelo cliente ou pela biblioteca do cliente para servir como uma validação do carregamento bem-sucedido do conteúdo. O comprimento máximo é 4000.

Criar um AssetFile

A função CreateFileInfos é usada para criar uma nova entidade AssetFile. Para obter mais informações, consulte Funções da API REST.

Listar AssetFiles

Os AssetFiles são 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/Files> HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files 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/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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

Atualizar um AssetFile

Os AssetFiles são atualizados usando uma solicitação HTTP MERGE.

Método URI da solicitação Versão de HTTP
MESCLAR <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') 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/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Excluir um AssetFile

Os AssetFiles são excluídos quando o seu ativo associado for excluído. Para obter um exemplo, consulte Excluir um ativo.

Consulte Também

ContentKey
Ativo
AccessPolicy
Trabalho
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Cotas e limitações