Freigeben über

IngestManifestFile

  • Artikel

Ein IngestManifestFile-Objekt stellt ein tatsächliches Video- oder Audio-Blob-Objekt dar, das als Teil der Sammelerfassung hochgeladen wird. Weitere Informationen zur Massenerfassung finden Sie unter Erfassen von Ressourcen in Massen mit der REST-API. Ein IngestManifestFile-Objekt ist immer einem IngestManifest- und einem IngestManifestAsset-Objekt zugeordnet.

Dieses Thema enthält eine Übersicht über die Entität IngestManifestFile. Darüber hinaus wird gezeigt, wie unterschiedliche Vorgänge mit der Media Services REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

IngestManifestFile-Entitätseigenschaften

Eigenschaft type BESCHREIBUNG
Id

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.String Eindeutiger Bezeichner.
Created

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.DateTime Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
LastModified

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftsänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
Name

Erforderlich.		 Edm.String Tatsächlicher Dateiname, der in den Blobcontainer hochgeladen wird, auf den von der BlobStorageUriForUpload-Eigenschaft des IngestManifest verwiesen wird. Media Services überwacht den Dateiupload in diesem Container anhand des Namens.

Der Dateiname darf nicht leer sein und keine Leerzeichen enthalten. Ist innerhalb von IngestManifest eindeutig. Die maximale Länge beträgt 4000.
State

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.Int32 Der aktuelle Status des IngestManifestFile-Objekts. Die folgenden Werte sind möglich:

- Ausstehend = 0: Die Datei wurde noch nicht hochgeladen, um die Erstellung des Medienobjekts abzuschließen. Media Services wartet auf den Dateiupload.
- Abgeschlossen = 1: Der Dateiupload wurde erkannt, und das zugeordnete Medienobjekt wurde aktualisiert.
- Fehler = 2: Bei der Verarbeitung dieser Datei ist ein Fehler aufgetreten. Weitere Informationen finden Sie in den Fehlerinformationen der Eigenschaft ErrorDetails.
ParentIngestManifestId

Erforderlich.		 Edm.String Die IngestManifest-ID des Manifests, das diese Datei enthält.
ParentIngestManifestAssetId

Erforderlich.		 Edm.String Die IngestManifestAsset-ID des IngestManifestAsset-Objekts, dem diese Datei zugeordnet ist.
ErrorDetail

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Details eines Fehlers, der beim Verarbeiten dieser Datei aufgetreten ist.
MimeType

Optional.		 Edm.String Media Services untersucht keine von Ihnen hochgeladenen Blobs. Aus diesem Grund müssen Sie den MIME-Typ manuell festlegen. "text/plain" und "video/x-ms-wmv" sind z. B. gültige Werte, die verwendet werden können.
IsPrimary

Optional.		 Edm.Boolean Bestimmt, ob dieses IngestManifestFile-Objekt die primäre Datei in einem Medienobjekt mit mehreren Dateien ist.
EncryptionVersion

Optional.		 Edm.String Die aktuelle unterstützte Version für StorageEncryption, CommonEncryption und EnvelopeEncryption ist "1.0".
EncryptionScheme

Optional.		 Edm.String Das für diese Datei verwendete Verschlüsselungsschema. Die gültigen Werte sind: "StorageEncryption", "CommonEncryption" oder "EnvelopeEncryption".
IsEncrypted

Optional.		 Edm.Boolean Dieser Wert sollte auf true festgelegt sein, wenn diese Datei verschlüsselt gespeichert wird.
EncryptionKeyId

Optional.		 Edm.String Die verschlüsselte ContentKey-ID.
InitializationVector

Optional.		 Edm.String Der Initialisierungsvektor, der für Speicherverschlüsselung verwendet wird.

Erstellen eines IngestManifestFile-Objekts

IngestManifestFiles können mithilfe einer HTTP POST-Anforderung erstellt werden. Sie müssen einen Anforderungstext übergeben, der den Wert Name des neuen IngestManifestFile-Objekts enthält, sowie die ParentIngestManifestId und die ParentIngestManifestAssetId.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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" }

Auflisten eines IngestManifestFile-Objekts

IngestManifestFiles können mithilfe einer HTTP GET-Anforderung abgerufen werden. Sie können ein IngestManifestFile-Objekt nach seiner ID anfordern oder alle IngestManifestFiles anfordern, indem Sie die ID nicht angeben.

Methode Anforderungs-URI HTTP-Version
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

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Löschen eines IngestManifestFile-Objekts

IngestManifestFiles können durch Verweisen auf den ID-Wert von IngestManifestFile mit einer HTTP DELETE-Anforderung gelöscht werden.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile ID') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Weitere Informationen

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Kontingente und Einschränkungen