Sdílet prostřednictvím

IngestManifest

  • Článek

IngestManifest představuje sadu prostředků, které se mají vytvořit prostřednictvím hromadného ingestování spolu s přidruženými soubory prostředků. Hromadné ingestování umožňuje oddělit proces nahrávání souboru od vytváření prostředků. V důsledku toho je možné při vytváření prostředku použít vysoce výkonnou metodu nahrávání souborů pro velké sady souborů. Jakmile se vytvoří IngestManifestAssets spolu s přidruženými soubory IngestManifestFiles, Microsoft Azure Media Services prostřednictvím vlastnosti BlobStorageUriForUpload sleduje kontejner úložiště objektů blob přidružený k objektu IngestManifest. Po dokončení každého nahrání souboru do kontejneru úložiště objektů blob Microsoft Azure Media Services dokončí nový prostředek pro příslušný objekt IngestManifestAsset, který tento soubor obsahuje.

Tento článek poskytuje přehled IngestManifest entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Poznámka

Každý soubor IngestManifestAssetFile přidružený k IngestManifest musí mít v manifestu jedinečný název souboru.

Vlastnosti entity IngestManifest

Vlastnost Typ Description
Id

Jen pro čtení. Nastaví se službou Media Services při vytváření.		 Edm.String Jedinečný identifikátor.
Created

Jen pro čtení. Nastaví se službou Media Services při vytváření.		 Edm.DateTime Představuje počet milisekund od půlnoci 1. ledna 1970.
LastModified

Jen pro čtení. Nastaveno službou Media Services.		 Edm.DateTime Služba Media Services tuto hodnotu aktualizuje po provedení jakýchkoli změn vlastností. Představuje počet milisekund od půlnoci 1. ledna 1970.
Name

Nepovinný parametr.		 Edm.String Popisný název pro váš IngestManifest.
State

Jen pro čtení. Nastaveno službou Media Services.		 Edm.Int32 Aktuální stav manifestu. Tato hodnota může být jedna z následujících:

- Neaktivní = 0: Nezůstalo žádné nevyřízené vytvoření prostředku. Všechny jsou buď dokončené, nebo došlo k chybě.
- Aktivace = 1: Manifest ještě není připravený přijímat soubory nahrané do kontejneru objektů blob.
- Aktivní = 2: IngestManifestAssets čekají na vytvoření a kontejner objektů blob se monitoruje.
BlobStorageUriForUpload

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String Tuto hodnotu nastavuje Služba Media Services. Tato hodnota určuje identifikátor URI kontejneru úložiště objektů blob, který přijímá nahrání souborů potřebných k dokončení IngestManifestAssets.
Statistics

Jen pro čtení. Nastaveno službou Media Services.		 IngestManifestStatistics Tento komplexní typ obsahuje statistické informace, které pomáhají určit aktuální průběh vytváření IngestManifestAssets na základě všech souborů prostředků souvisejících s manifestem.
IngestManifestAssets

Jen pro čtení. Nastaveno službou Media Services.		 Sada entit IngestManifestAsset Navigační vlastnost, ke které lze získat přístup odkazem na konkrétní IngestManifestAsset podle hodnoty Id. Vrácená sada entit obsahuje všechny IngestManifestAssets obsažené v IngestManifest.
PendingIngestManifestAssets

Jen pro čtení. Nastaveno službou Media Services.		 Sada entit IngestManifestAsset Navigační vlastnost, ke které lze získat přístup odkazem na konkrétní IngestManifestAsset podle hodnoty Id. Vrácená sada entit obsahuje všechny IngestManifestAssets čekající na nahrání souboru nebo vytvoření prostředku.
StorageAccountName

Nepovinný parametr. Po vytvoření entity není možné aktualizovat.		 Edm.String Název účtu úložiště, který obsahuje kontejner objektů blob, do kterého se soubory nahrají.

Pokud tento parametr při vytváření nezadáte, služba Media Services nastaví výchozí název účtu úložiště.

IngestManifestAsset.Asset musí používat stejný účet úložiště jako v IngestManifest.
StorageAccount

Jen pro čtení. Nastaveno službou Media Services.		 Sada entit StorageAccount. Vrácená sada entit obsahuje všechny entity StorageAccount, které jsou propojené se zadaným assetem.

Vytvoření IngestManifestu

IngestManifests lze vytvořit pomocí požadavku HTTP POST a předáním textu požadavku, který obsahuje název nového IngestManifest.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// název_účtu.restv2>.<umístění.media.azure.net/api/IngestManifests> HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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" }

Vypsat IngestManifest

IngestManifests je možné načíst pomocí požadavku HTTP GET. Můžete si vyžádat ingestovací manifest podle jeho ID nebo všechny manifesty.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// název_účtu.restv2>.<umístění.media.azure.net/api/IngestManifests> HTTP/1.1
GET <https:// název_účtu.restv2>.<location.media.azure.net/api/IngestManifests>('Id IngestManifest') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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

Aktualizace IngestManifestu

IngestManifests lze aktualizovat odkazem na ID IngestManifest s požadavkem HTTP MERGE. Text požadavku obsahuje vlastnosti, které se mají aktualizovat.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
SLOUČIT <https:// název_účtu.restv2>.<location.media.azure.net/api/IngestManifests>('Id IngestManifest') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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" }

Odstranění manifestu ingestování

IngestManifests lze odstranit odkazem na hodnotu ID IngestManifest s požadavkem HTTP DELETE.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE <https:// název_účtu.restv2>.<location.media.azure.net/api/IngestManifests>('Id IngestManifest') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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

Viz také

Zásady přístupu
AssetFile
Prostředek
Klíč obsahu
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Úloha
Pracovní pozice
Lokátor
MediaProcessor
Úkol
TaskTemplate
Kvóty a omezení