Udostępnij za pośrednictwem

IngestManifest

  • Artykuł

IngestManifest reprezentuje zestaw zasobów, które mają zostać utworzone przez zbiorcze pozyskiwanie wraz ze skojarzonymi plikami zasobów. Zbiorcze pozyskiwanie umożliwia oddzielenie procesu przekazywania plików od tworzenia zasobów. W związku z tym metoda przekazywania plików o wysokiej wydajności może służyć do obsługi dużych zestawów plików podczas tworzenia zasobu. Po utworzeniu elementu IngestManifestAssets wraz ze skojarzonymi plikami IngestManifestFiles Microsoft Azure Media Services obserwuje kontener usługi Blob Storage skojarzony z plikiem IngestManifest za pośrednictwem właściwości BlobStorageUriForUpload. Po zakończeniu przekazywania każdego pliku do kontenera usługi Blob Storage Microsoft Azure Media Services ukończy nowy zasób dla odpowiedniego zestawu IngestManifestAsset zawierającego ten plik.

Ten artykuł zawiera omówienie IngestManifest jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).

Uwaga

Każdy plik IngestManifestAssetFile skojarzony z plikiem IngestManifest musi mieć unikatową nazwę pliku w manifeście.

Właściwości jednostki IngestManifest

Właściwość Typ Opis
Id

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.String Unikatowy identyfikator.
Created

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Przedstawia liczbę milisekund od północy 1 stycznia 1970 r.
LastModified

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.DateTime Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu jakichkolwiek zmian właściwości. Reprezentuje liczbę milisekund od północy 1 stycznia 1970 r.
Name

Opcjonalny.		 Edm.String Przyjazna nazwa IngestManifest.
State

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.Int32 Bieżący stan manifestu. Ta wartość może być jedną z następujących wartości:

- Nieaktywny = 0: nie pozostają oczekujące operacje tworzenia zasobów. Wszystkie zostały ukończone lub napotkały błąd.
- Aktywowanie = 1: Manifest nie jest jeszcze gotowy do odbierania plików przekazanych do kontenera obiektów blob.
- Aktywny = 2: Istnieją oczekujące operacje tworzenia zasobów IngestManifest, a kontener obiektów blob jest monitorowany.
BlobStorageUriForUpload

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.String Ta wartość jest ustawiana przez usługę Media Services. Ta wartość określa identyfikator URI kontenera usługi Blob Storage, który odbiera przekazywane pliki potrzebne do ukończenia operacji IngestManifestAssets.
Statistics

Tylko do odczytu. Ustawiane przez usługę Media Services.		 IngestManifestStatistics Ten typ złożony zawiera informacje statystyczne ułatwiające określenie bieżącego postępu tworzenia elementów zawartości IngestManifestAssets na podstawie wszystkich plików zasobów związanych z manifestem.
IngestManifestAssets

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek IngestManifestAsset Właściwość nawigacji, do którego można uzyskać dostęp, odwołując się do określonej wartości identyfikatora IngestManifestAsset. Zwrócony zestaw jednostek zawiera wszystkie IngestManifestAssets zawarte w IngestManifest.
PendingIngestManifestAssets

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek IngestManifestAsset Właściwość nawigacji, do którego można uzyskać dostęp, odwołując się do określonej wartości identyfikatora IngestManifestAsset. Zwrócony zestaw jednostek zawiera wszystkie IngestManifestAssets oczekujące na przekazanie pliku lub utworzenie zasobu.
StorageAccountName

Opcjonalny. Nie można zaktualizować po utworzeniu jednostki.		 Edm.String Nazwa konta magazynu zawierającego kontener obiektów blob, w którym są przekazywane pliki.

Jeśli nie zostanie określony w czasie tworzenia, usługa Media Services ustawi domyślną nazwę konta magazynu.

IngestManifestAsset.Asset musi używać tego samego konta magazynu, co określone w IngestManifest.
StorageAccount

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek StorageAccount. Zwrócony zestaw jednostek zawiera wszystkie jednostki StorageAccount połączone z określonym zasobem.

Tworzenie pliku IngestManifest

IngestManifests można utworzyć przy użyciu żądania HTTP POST i przekazać treść żądania, która zawiera nazwę nowego IngestManifest.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services 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" }

Wyświetlanie listy IngestManifest

Plik IngestManifests można pobrać przy użyciu żądania HTTP GET. Manifest pozyskiwania można zażądać według jego identyfikatora lub zażądać wszystkich manifestów.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU 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

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.

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

Aktualizowanie pliku IngestManifest

IngestManifests można zaktualizować, odwołując się do identyfikatora IngestManifest za pomocą żądania SCALANIA HTTP. Treść żądania zawiera właściwości do zaktualizowania.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
SCALANIA <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.

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" }

Usuwanie manifestu pozyskiwania

IngestManifests można usunąć, odwołując się do wartości identyfikatora IngestManifest z żądaniem HTTP DELETE.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.

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

Zobacz też

AccessPolicy
AssetFile
Zasób
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Zadanie
JobTemplate
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia