IngestManifest
Ein IngestManifest-Objekt stellt eine Sammlung von Medienobjekten dar, die durch Sammelerfassung zusammen mit ihren zugehörigen Medienobjektdateien erstellt werden soll. Durch die Massenerfassung können Sie den Dateiuploadvorgang von der Erstellung von Ressourcen entkoppeln. Daher kann eine leistungsstarke Dateiuploadmethode für große Dateisätze während der Asseterstellung verwendet werden. Sobald ein IngestManifestAssets zusammen mit den zugehörigen IngestManifestFiles erstellt wurde, überwacht Microsoft Azure Media Services den Blob Storage-Container, der dem IngestManifest über die BlobStorageUriForUpload-Eigenschaft zugeordnet ist. Wenn jeder Dateiupload in den Blob Storage-Container abgeschlossen ist, schließt Microsoft Azure Media Services ein neues Asset für die jeweilige IngestManifestAsset ab, die diese Datei enthält.
Dieser Artikel bietet eine Übersicht über die IngestManifest Entität und veranschaulicht außerdem, wie verschiedene 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.
Hinweis
Jedes IngestManifestAssetFile, das einem IngestManifest zugeordnet ist, muss im Manifest über einen eindeutigen Dateinamen verfügen.
IngestManifest-Entitätseigenschaften
| Eigenschaft | type | BESCHREIBUNG |
|---|---|---|
IdSchreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt. |
Edm.String | Eindeutiger Bezeichner. |
CreatedSchreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt. |
Edm.DateTime | Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar. |
LastModifiedSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.DateTime | Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftenänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar. |
NameOptional. |
Edm.String | Der Anzeigename für Ihr IngestManifest. |
StateSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.Int32 | Der aktuelle Status des Manifests. Die folgenden Werte sind möglich: - Inaktiv = 0: Es verbleiben keine ausstehenden Asset-Erstellungen. Sie wurden alle abgeschlossen, oder es ist ein Fehler aufgetreten. - Aktivieren = 1: Das Manifest ist noch nicht bereit, Dateien zu empfangen, die in den Blobcontainer hochgeladen wurden. - Active = 2: IngestManifestAssets stehen Erstellungen aus, und der Blobcontainer wird überwacht. |
BlobStorageUriForUploadSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.String | Dieser Wert wird von Media Services festgelegt. Dieser Wert gibt den URI des Blob Storage-Containers an, der die Dateiuploads empfängt, die zum Abschließen der IngestManifestAssets erforderlich sind. |
StatisticsSchreibgeschützt. Wird von Media Services festgelegt. |
IngestManifestStatistics | Dieser komplexe Typ enthält Statistikinformationen, die den aktuellen Status der Erstellung von IngestManifestAssets basierend auf allen Medienobjektdateien angeben, die mit dem Manifest in Beziehung stehen. |
IngestManifestAssetsSchreibgeschützt. Wird von Media Services festgelegt. |
IngestManifestAsset-Entitätssatz | Eine Navigationseigenschaft, auf die durch Verweisen auf ein bestimmtes IngestManifestAsset-Objekt nach ID-Wert zugegriffen werden kann. Die zurückgegebene Entitätenmenge enthält alle IngestManifestAssets, die im IngestManifest enthalten sind. |
PendingIngestManifestAssetsSchreibgeschützt. Wird von Media Services festgelegt. |
IngestManifestAsset-Entitätssatz | Eine Navigationseigenschaft, auf die durch Verweisen auf ein bestimmtes IngestManifestAsset-Objekt nach ID-Wert zugegriffen werden kann. Die zurückgegebene Entitätenmenge enthält alle IngestManifestAssets, für die der Dateiupload oder die Medienobjekterstellung aussteht. |
StorageAccountNameOptional. Kann nach der Erstellung der Entität nicht aktualisiert werden. |
Edm.String | Der Name des Speicherkontos, das den BLOB-Container enthält, in den die Dateien hochgeladen werden. Falls zur Erstellungszeit nicht angegeben, legt Media Services den Standardnamen des Speicherkontos fest. IngestManifestAsset.Asset muss das gleiche Speicherkonto verwenden, das in IngestManifest angegeben wurde. |
StorageAccountSchreibgeschützt. Wird von Media Services festgelegt. |
Die StorageAccount-Entitätenmenge. | Die zurückgegebene Entitätenmenge aller StorageAccount-Entitäten, die mit dem angegebenen Medienobjekt verknüpft sind. |
Erstellen eines IngestManifest-Objekts
IngestManifests können mithilfe einer HTTP POST-Anforderung und Übergeben eines Anforderungstexts erstellt werden, der den Namen des neuen IngestManifest-Objekts enthält.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
Beispiel für eine Anforderung
Informationen zum Aktuellen x-ms-version:finden Sie unter 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" }
Auflisten eines IngestManifest-Objekts
IngestManifests können mithilfe einer HTTP GET-Anforderung abgerufen werden. Sie können ein Erfassungsmanifest nach seiner ID abrufen oder alle Manifestdateien abrufen.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| 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 |
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/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
Aktualisieren eines IngestManifest-Objekts
IngestManifests können aktualisiert werden, indem auf die IngestManifest-ID mit einer HTTP MERGE-Anforderung verwiesen wird. Der Anforderungstext enthält die zu aktualisierenden Eigenschaften.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest ID') | HTTP/1.1 |
Beispiel für eine Anforderung
Informationen zum Aktuellen x-ms-version:finden Sie unter 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" }
Löschen eines Erfassungsmanifests
IngestManifests können durch Verweisen auf den ID-Wert von IngestManifest mit einer HTTP DELETE-Anforderung gelöscht werden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| Delete | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest 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/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
Weitere Informationen
AccessPolicy
AssetFile
Asset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Job
JobTemplate
Locator
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen