Compartilhar via

IngestManifest

  • Artigo

Um IngestManifest representa um conjunto de ativos a ser criado por meio de uma ingestão em massa junto com os seus arquivos de ativo associados. A ingestão em massa permite que você desacopla o processo de upload de arquivo da criação de ativos. Como resultado, um método de upload de arquivo de alto desempenho pode ser usado para grandes conjuntos de arquivos durante a criação de ativos. Depois que um IngestManifestAssets é criado, juntamente com seu IngestManifestFiles associado, Serviços de Mídia do Microsoft Azure observa o contêiner de armazenamento de Blobs associado ao IngestManifest por meio da propriedade BlobStorageUriForUpload. À medida que cada upload de arquivo para o contêiner de Armazenamento de Blobs é concluído, Serviços de Mídia do Microsoft Azure conclui um novo ativo para o respectivo IngestManifestAsset que contém esse arquivo.

Este artigo fornece uma visão geral da IngestManifest entidade 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.

Observação

Cada IngestManifestAssetFile associado a um IngestManifest deve ter um nome de arquivo exclusivo no manifesto.

Propriedades da entidade IngestManifest

Propriedade Type Descrição
Id

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.		 Edm.String Identificador exclusivo.
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.
LastModified

Somente leitura. Configurada pelos Serviços de Mídia.		 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.
Name

Opcional.		 Edm.String Nome amigável para o IngestManifest.
State

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.Int32 O estado atual do manifesto. Este valor pode ser um dos seguintes:

- Inativo = 0: nenhuma criação de ativo pendente permanece. Todas foram concluídas ou encontraram um erro.
- Ativando = 1: o manifesto ainda não está pronto para receber arquivos carregados no contêiner de Blob.
- Ativo = 2: há criações de IngestManifestAssets pendentes e o contêiner de Blob está sendo monitorado.
BlobStorageUriForUpload

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String Esse valor é definido pelos Serviços de Mídia. Esse valor especifica o URI do contêiner de armazenamento de Blobs, que recebe os uploads de arquivo necessários para concluir o IngestManifestAssets.
Statistics

Somente leitura. Configurada pelos Serviços de Mídia.		 IngestManifestStatistics Esse tipo complexo contém informações estatísticas para ajudar a determinar o atual progresso da criação do IngestManifestAssets com base em todos os arquivos de ativo relacionados ao manifesto.
IngestManifestAssets

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades IngestManifestAsset A propriedade de navegação que pode ser acessada referenciando um IngestManifestAsset específico pelo valor da ID. O conjunto de entidades retornado contém todos os IngestManifestAssets contidos no IngestManifest.
PendingIngestManifestAssets

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades IngestManifestAsset A propriedade de navegação que pode ser acessada referenciando um IngestManifestAsset específico pelo valor da ID. O conjunto de entidades retornado contém todos os carregamentos de arquivo pendentes ou a criação de ativos do IngestManifestAssets.
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 em que os arquivos são carregados.

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.

IngestManifestAsset.Asset precisa usar a mesma conta de armazenamento, como especificado no IngestManifest.
StorageAccount

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

Criar um IngestManifest

Os IngestManifests podem ser criados usando uma solicitação HTTP POST e passando um corpo de solicitação que contenha o nome do novo IngestManifest.

Método URI da solicitação Versão de HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> 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:// media.windows.net/API/IngestManifests 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: 36  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestREST" }

Listar um IngestManifest

Os IngestManifests podem ser recuperados usando uma solicitação HTTP GET. É possível solicitar um manifesto de ingestão pela sua ID ou solicitar todos os manifestos.

Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') 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/IngestManifests('nb:mid:UUID:a2f9a230-831e-5e40-bafa-fbf8decbee26') 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 IngestManifest

IngestManifests podem ser atualizados fazendo referência à ID do IngestManifest com uma solicitação HTTP MERGE. O corpo da solicitação contém as propriedades a serem atualizadas.

Método URI da solicitação Versão de HTTP
MESCLAR <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') 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:// media.windows.net /API/IngestManifests('nb:mid:UUID:076faa09-8f5d-ce41-9de3-32ba66190271') 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: 43  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestUpdated" }

Excluir um IngestManifest

Os IngestManifests podem ser excluídos referenciando o valor da ID do IngestManifest com uma solicitação HTTP DELETE.

Método URI da solicitação Versão de HTTP
Delete (excluir) <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest 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/IngestManifests('nb:mid:UUID:45ea3cd0-b3cf-994b-8e4d-03c9620c22da') 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
AssetFile
Ativo
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Trabalho
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Cotas e limitações