Partilhar via

IngestManifestFile

  • Artigo

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

Este tópico fornece uma descrição geral da IngestManifestFile entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade IngestManifestFile

Propriedade Tipo Description
Id

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.String Identificador exclusivo.
Created

Só de leitura. Definido pelos Serviços de Multimé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

Só de leitura. Definido pelos Serviços de Multimédia.		 Edm.DateTime Este valor é atualizado pelos Serviços de Multimédia depois de serem efetuadas alterações de propriedade. Representa o número de milissegundos desde a meia-noite de 1 de Janeiro de 1970.
Name

Obrigatório.		 Edm.String Nome de ficheiro real que será carregado para o contentor de blobs referenciado pela propriedade BlobStorageUriForUpload da IngestManifest. Os Serviços de Multimédia observam o carregamento de ficheiros nesse contentor por nome.

O nome do ficheiro não pode estar vazio nem espaços brancos. Exclusivo no IngestManifest. O comprimento máximo é 4000.
State

Só de leitura. Definido pelos Serviços de Multimédia.		 Edm.Int32 O estado atual do IngestManifestFile. Este valor pode ser um dos seguintes:

- Pendente = 0: o ficheiro ainda não foi carregado para concluir a criação do recurso. Os Serviços de Multimédia estão à espera do carregamento do ficheiro.
- Concluído = 1: o carregamento de ficheiros foi detetado e o recurso associado foi atualizado.
- Erro = 2: Ocorreu um erro ao processar este ficheiro. Veja a propriedade ErrorDetails para obter informações de erro.
ParentIngestManifestId

Obrigatório.		 Edm.String ID ingestManifest do manifesto que contém este ficheiro.
ParentIngestManifestAssetId

Obrigatório.		 Edm.String IngestManifestAsset ID do IngestManifestAsset ao qual este ficheiro está associado.
ErrorDetail

Só de leitura. Definido pelos Serviços de Multimédia.		 Edm.String Foram encontrados detalhes de erros ao processar este ficheiro.
MimeType

Opcional.		 Edm.String Os Serviços de Multimédia não inspecionam nenhum blob que carregou, pelo que tem de definir manualmente o tipo de mime. Por exemplo, "texto/simples" ou "vídeo/x-ms-wmv" são valores válidos a utilizar.
IsPrimary

Opcional.		 Edm.Boolean Determina se este IngestManifestFile é o ficheiro primário num Recurso de múltiplos ficheiros.
EncryptionVersion

Opcional.		 Edm.String A versão suportada atual para StorageEncryption, CommonEncryption e EnvelopeEncryption é "1.0".
EncryptionScheme

Opcional.		 Edm.String O esquema de encriptação utilizado para este ficheiro. Os valores válidos são: "StorageEncryption", "CommonEncryption" ou "EnvelopeEncryption".
IsEncrypted

Opcional.		 Edm.Boolean Este valor deve ser definido como verdadeiro se este ficheiro estiver armazenado encriptado.
EncryptionKeyId

Opcional.		 Edm.String ID contentkey encriptado.
InitializationVector

Opcional.		 Edm.String O vetor de inicialização utilizado para encriptação de armazenamento.

Criar um IngestManifestFile

IngestManifestFiles pode ser criado com um pedido HTTP POST. Tem de transmitir um corpo do pedido que contenha o nome do novo IngestManifestFile, juntamente com ParentIngestManifestId e ParentIngestManifestAssetId.

Método URI do pedido Versão HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

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

IngestManifestFiles pode ser obtido com um pedido HTTP GET. Pode pedir um IngestManifestFile pelo respetivo ID ou pedir a todos os IngestManifestFiles ao omitir o ID.

Método URI do pedido Versão 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

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

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

Eliminar um IngestManifestFile

IngestManifestFiles pode ser eliminado ao referenciar o valor ingestManifestFile ID com um pedido HTTP DELETE.

Método URI do pedido Versão HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

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
Quotas e Limitações