Compartilhar via

IngestManifestFile

  • Artigo

Um IngestManifestFile representa um objeto blob real de vídeo ou áudio que será carregado como parte da ingestão em massa. Para obter mais informações sobre ingestão em massa, consulte Ingestão de ativos em massa com a API REST. Um IngestManifestFile é sempre associado a um IngestManifest e a um IngestManifestAsset.

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

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 qualquer alteração de propriedade é feita. Representa o número de milissegundos desde a meia-noite de 1º de janeiro de 1970.
Name

Obrigatórios.		 Edm.String Nome de arquivo real que será carregado no contêiner de blob referenciado pela propriedade BlobStorageUriForUpload do IngestManifest. Os Serviços de Mídia observam o upload de arquivo nesse contêiner pelo nome.

O nome do arquivo não ficar vazio ou conter espaços em branco. Único dentro do IngestManifest. O comprimento máximo é 4000.
State

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

- Pendente = 0: o arquivo ainda não foi carregado para concluir a criação do ativo. Os Serviços de Mídia estão aguardando o upload do arquivo.
- Concluído = 1: o upload de arquivo foi detectado e o ativo associado foi atualizado.
- Erro = 2: ocorreu um erro ao processar esse arquivo. Consulte a propriedade ErrorDetails para obter informações sobre o erro.
ParentIngestManifestId

Obrigatórios.		 Edm.String A ID do IngestManifest do manifesto que contém este arquivo.
ParentIngestManifestAssetId

Obrigatórios.		 Edm.String A ID do IngestManifestAsset de um IngestManifestAsset ao qual este arquivo está associado.
ErrorDetail

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String Detalhes dos erros encontrados durante o processamento deste arquivo.
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.
IsPrimary

Opcional.		 Edm.Boolean Determina se este IngestManifestFile é o primeiro arquivo de um ativo com vários arquivos.
EncryptionVersion

Opcional.		 Edm.String A versão atual com suporte a StorageEncryption, CommonEncryption e EnvelopeEncryption é "1.0".
EncryptionScheme

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

Opcional.		 Edm.Boolean Esse valor deverá ser configurado como verdadeiro caso esse arquivo seja armazenado criptografado.
EncryptionKeyId

Opcional.		 Edm.String ID de ContentKey criptografada.
InitializationVector

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

Criar um IngestManifestFile

Os IngestManifestFiles podem ser criados usando uma solicitação HTTP POST. Você deve transmitir um corpo da solicitação que contém o Nome do novo IngestManifestFile junto com ParentIngestManifestId e ParentIngestManifestAssetId.

Método URI da solicitação Versão de HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> 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/IngestManifestFiles 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: 200  
Expect: 100-continue  
  
{ "Name" : "REST_Example_File.wmv", "ParentIngestManifestId" : "nb:mid:UUID:bfe2d76c-17bd-884a-b9be-21bdfda65984", "ParentIngestManifestAssetId" : "nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6" }

Listar um IngestManifestFile

Os IngestManifestFiles podem ser recuperados usando uma solicitação HTTP GET. Você pode solicitar um IngestManifestFile pela sua ID ou solicitar todos os IngestManifestFiles omitindo a ID.

Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile 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/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

Excluir um IngestManifestFile

Os IngestManifestFiles podem ser excluídos referenciando o valor da ID do IngestManifestFile 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/IngestManifestFiles>('IngestManifestFile 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/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Cotas e limitações