IngestManifestFile

  • Artykuł

Plik IngestManifestFile reprezentuje rzeczywisty obiekt obiektu blob wideo lub audio, który zostanie przekazany w ramach zbiorczego pozyskiwania. Aby uzyskać więcej informacji na temat zbiorczego pozyskiwania, zobacz Zbiorcze pozyskiwanie zasobów za pomocą interfejsu API REST. Plik IngestManifestFile jest zawsze skojarzony z IngestManifest i IngestManifestAsset.

Ten temat zawiera omówienie IngestManifestFile 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).

Właściwości jednostki IngestManifestFile

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

Wymagane.		 Edm.String Rzeczywista nazwa pliku, która zostanie przekazana do kontenera obiektów blob, do którego odwołuje się właściwość BlobStorageUriForUpload obiektu IngestManifest. Usługa Media Services obserwuje przekazywanie pliku w tym kontenerze według nazwy.

Nazwa pliku nie może być pusta ani zawierać białych znaków. Unikatowy w ramach IngestManifest. Maksymalna długość to 4000.
State

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

- Oczekujące = 0: plik nie został jeszcze przekazany w celu ukończenia tworzenia zasobu. Usługa Media Services czeka na przekazanie pliku.
- Zakończono = 1: Wykryto przekazywanie pliku i zaktualizowano skojarzony zasób.
- Błąd = 2: Wystąpił błąd podczas przetwarzania tego pliku. Aby uzyskać informacje o błędzie, zobacz właściwość ErrorDetails .
ParentIngestManifestId

Wymagane.		 Edm.String Identyfikator IngestManifest manifestu zawierającego ten plik.
ParentIngestManifestAssetId

Wymagane.		 Edm.String Identyfikator IngestManifestAsset zestawu IngestManifestAsset, z którą jest skojarzony ten plik.
ErrorDetail

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.String Szczegóły błędów napotkanych podczas przetwarzania tego pliku.
MimeType

Opcjonalny.		 Edm.String Usługa Media Services nie sprawdza przekazanych obiektów blob, dlatego należy ręcznie ustawić typ mime. Na przykład wartości "text/plain" lub "video/x-ms-avi" są prawidłowymi wartościami do użycia.
IsPrimary

Opcjonalny.		 Edm.Boolean Określa, czy ten plik IngestManifestFile jest plikiem podstawowym w zasobie z wieloma plikami.
EncryptionVersion

Opcjonalny.		 Edm.String Bieżąca obsługiwana wersja dla elementu StorageEncryption, CommonEncryption i EnvelopeEncryption to "1.0".
EncryptionScheme

Opcjonalny.		 Edm.String Schemat szyfrowania używany dla tego pliku. Prawidłowe wartości to: "StorageEncryption", "CommonEncryption" lub "EnvelopeEncryption".
IsEncrypted

Opcjonalny.		 Edm.Boolean Ta wartość powinna być ustawiona na wartość true , jeśli ten plik jest przechowywany jako zaszyfrowany.
EncryptionKeyId

Opcjonalny.		 Edm.String Zaszyfrowany identyfikator klucza zawartości.
InitializationVector

Opcjonalny.		 Edm.String Wektor inicjowania używany do szyfrowania magazynu.

Tworzenie pliku IngestManifestFile

Plik IngestManifestFiles można utworzyć przy użyciu żądania HTTP POST. Musisz przekazać treść żądania zawierającą nazwę nowego pliku IngestManifestFile wraz z elementami ParentIngestManifestId i ParentIngestManifestAssetId.

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

Przykładowe żądanie

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

Wyświetlanie listy plików IngestManifestFile

Plik IngestManifestFiles można pobrać przy użyciu żądania HTTP GET. Możesz zażądać pliku IngestManifestFile według jego identyfikatora lub zażądać wszystkich plików IngestManifestFiles, pomijając identyfikator.

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

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services 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

Usuwanie pliku IngestManifestFile

Plik IngestManifestFiles można usunąć, odwołując się do wartości IngestManifestFile z żądaniem HTTP DELETE.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile 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/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

Zobacz też

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Limity przydziału i ograniczenia