IngestManifest
Um IngestManifest representa um conjunto de recursos a criar através da ingestão em massa, juntamente com os respetivos ficheiros de recursos associados. A ingestão em massa permite-lhe desassociar o processo de carregamento de ficheiros a partir da criação de recursos. Como resultado, pode ser utilizado um método de carregamento de ficheiros de alto desempenho para conjuntos de ficheiros grandes durante a criação de recursos. Assim que for criado um IngestManifestAssets, juntamente com os ingestManifestFiles associados, Serviços de Multimédia do Microsoft Azure observa o contentor de armazenamento de Blobs associado ao IngestManifest através da propriedade BlobStorageUriForUpload. À medida que cada carregamento de ficheiros para o contentor de armazenamento de Blobs é concluído, Serviços de Multimédia do Microsoft Azure conclui um novo recurso para o respetivo IngestManifestAsset que contém esse ficheiro.
Este artigo apresenta uma descrição geral da IngestManifest 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).
Nota
Cada IngestManifestAssetFile associado a uma IngestManifest tem de ter um nome de ficheiro exclusivo no manifesto.
Propriedades da Entidade IngestManifest
| Propriedade | Tipo | Description |
|---|---|---|
IdSó de leitura. Definido pelos Serviços de Multimédia no momento da criação. |
Edm.String | Identificador exclusivo. |
CreatedSó 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. |
LastModifiedSó 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. |
NameOpcional. |
Edm.String | Nome amigável para a ingestãoManifest. |
StateSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.Int32 | O estado atual do manifesto. Este valor pode ser um dos seguintes: - Inativo = 0: não existem criações de recursos pendentes. Todos foram concluídos ou encontraram um erro. - Ativar = 1: o manifesto ainda não está pronto para receber ficheiros carregados para o contentor de Blobs. - Ativo = 2: existem ingestmanifestAssets pendentes e o contentor de Blobs está a ser monitorizado. |
BlobStorageUriForUploadSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | Este valor é definido pelos Serviços de Multimédia. Este valor especifica o Uri do contentor de armazenamento de Blobs, que recebe os carregamentos de ficheiros necessários para concluir o IngestManifestAssets. |
StatisticsSó de leitura. Definido pelos Serviços de Multimédia. |
IngestManifestStatistics | Este tipo complexo contém informações estatísticas para ajudar a determinar o progresso atual da criação de IngestManifestAssets com base em todos os ficheiros de recursos relacionados com o manifesto. |
IngestManifestAssetsSó de leitura. Definido pelos Serviços de Multimédia. |
Conjunto de entidades IngestManifestAsset | Propriedade de navegação que pode ser acedida ao referenciar um valor ingestmanifestAsset específico por ID. O conjunto de entidades devolvido contém todos os IngestManifestAssets contidos no IngestManifest. |
PendingIngestManifestAssetsSó de leitura. Definido pelos Serviços de Multimédia. |
Conjunto de entidades IngestManifestAsset | Propriedade de navegação que pode ser acedida ao referenciar um valor ingestmanifestAsset específico por ID. O conjunto de entidades devolvido contém todos os IngestManifestAssets pendentes de carregamento de ficheiros ou criação de recursos. |
StorageAccountNameOpcional. Não é possível atualizar após a criação da entidade. |
Edm.String | Nome da conta de armazenamento que contém o contentor de blobs onde os ficheiros são carregados. Se não for especificado no momento da criação, os Serviços de Multimédia definem o nome predefinido da conta de armazenamento. IngestManifestAsset.Asset tem de utilizar a mesma conta de armazenamento especificada no IngestManifest. |
StorageAccountSó de leitura. Definido pelos Serviços de Multimédia. |
Conjunto de entidades StorageAccount. | O conjunto de entidades devolvido contém todas as entidades StorageAccount que estão ligadas ao Recurso especificado. |
Criar uma IngestManifest
IngestManifests pode ser criado através de um pedido HTTP POST e ao transmitir um corpo de pedido que contém o nome do novo IngestManifest.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> | 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:// 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 uma IngestManifest
IngestManifests pode ser obtido com um pedido HTTP GET. Pode pedir um manifesto de ingestão pelo respetivo ID ou pedir todos os manifestos.
| Método | URI do pedido | Versão 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 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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
Os IngestManifests podem ser atualizados ao referenciar o ID ingestManifest com um pedido HTTP MERGE. O corpo do pedido contém as propriedades a atualizar.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| INTERCALAR | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('ID ingestManifest') | HTTP/1.1 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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" }
Eliminar um Manifesto de Ingestão
Os IngestManifests podem ser eliminados ao referenciar o valor de ID IngestManifest com um pedido HTTP DELETE.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('ID ingestManifest') | HTTP/1.1 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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
Recurso
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Tarefa
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Quotas e Limitações