IngestManifest
Een IngestManifest vertegenwoordigt een set assets die moet worden gemaakt via bulkopname, samen met de bijbehorende assetbestanden. Door bulksgewijs op te nemen kunt u het proces voor het uploaden van bestanden loskoppelen van het maken van assets. Als gevolg hiervan kan een krachtige methode voor het uploaden van bestanden worden gebruikt voor grote bestandensets tijdens het maken van assets. Zodra een IngestManifestAssets is gemaakt, samen met de bijbehorende IngestManifestFiles, bewaakt Microsoft Azure Media Services de Blob-opslagcontainer die is gekoppeld aan de IngestManifest via de eigenschap BlobStorageUriForUpload. Wanneer elk bestand wordt geüpload naar de Blob Storage-container, voltooit Microsoft Azure Media Services een nieuwe asset voor de respectieve IngestManifestAsset die dat bestand bevat.
Dit artikel geeft een overzicht van de IngestManifest entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.
Belangrijk
Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connect to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.
Notitie
Elke IngestManifestAssetFile die is gekoppeld aan een IngestManifest, moet een unieke bestandsnaam in het manifest hebben.
Eigenschappen van ingestManifest-entiteit
| Eigenschap | Type | Beschrijving |
|---|---|---|
IdAlleen-lezen. Ingesteld door Media Services tijdens het maken. |
Edm.String | Unieke id. |
CreatedAlleen-lezen. Ingesteld door Media Services tijdens het maken. |
Edm.DateTime | Geeft het aantal milliseconden aan sinds middernacht 1 januari 1970. |
LastModifiedAlleen-lezen. Ingesteld door Media Services. |
Edm.DateTime | Deze waarde wordt bijgewerkt door Media Services nadat eventuele eigenschapswijzigingen zijn aangebracht. Het geeft het aantal milliseconden aan sinds middernacht 1 januari 1970. |
NameOptioneel. |
Edm.String | Beschrijvende naam voor uw IngestManifest. |
StateAlleen-lezen. Ingesteld door Media Services. |
Edm.Int32 | De huidige status van het manifest. Deze waarde kan een van de volgende zijn: - Inactief = 0: Er blijven geen in behandeling zijnde assetcreaties over. Alle zijn voltooid of er is een fout opgetreden. - Activeren = 1: het manifest is nog niet gereed voor het ontvangen van bestanden die zijn geüpload naar de blobcontainer. - Actief = 2: Er zijn IngestManifestAssets in behandeling en de Blob-container wordt bewaakt. |
BlobStorageUriForUploadAlleen-lezen. Ingesteld door Media Services. |
Edm.String | Deze waarde wordt ingesteld door Media Services. Deze waarde geeft de URI aan van de Blob Storage-container, die de bestandsuploads ontvangt die nodig zijn om de IngestManifestAssets te voltooien. |
StatisticsAlleen-lezen. Ingesteld door Media Services. |
IngestManifestStatistics | Dit complexe type bevat statistische informatie om de huidige voortgang van het maken van IngestManifestAssets te bepalen op basis van alle assetbestanden die betrekking hebben op het manifest. |
IngestManifestAssetsAlleen-lezen. Ingesteld door Media Services. |
Entiteitsset IngestManifestAsset | Navigatie-eigenschap die toegankelijk is door te verwijzen naar een specifieke Waarde van IngestManifestAsset by Id. De geretourneerde entiteitsset bevat alle IngestManifestAssets in de IngestManifest. |
PendingIngestManifestAssetsAlleen-lezen. Ingesteld door Media Services. |
Entiteitsset IngestManifestAsset | Navigatie-eigenschap die toegankelijk is door te verwijzen naar een specifieke Waarde van IngestManifestAsset by Id. De geretourneerde entiteitsset bevat alle IngestManifestAssets die wachten op het uploaden van bestanden of het maken van assets. |
StorageAccountNameOptioneel. Kan niet worden bijgewerkt nadat de entiteit is gemaakt. |
Edm.String | Naam van het opslagaccount dat de blobcontainer bevat waarin de bestanden worden geüpload. Als dit niet is opgegeven tijdens het maken, stelt Media Services de standaardnaam van het opslagaccount in. IngestManifestAsset.Asset moet hetzelfde opslagaccount gebruiken als opgegeven in het IngestManifest. |
StorageAccountAlleen-lezen. Ingesteld door Media Services. |
Entiteitsset StorageAccount. | De geretourneerde entiteitsset bevat alle StorageAccount-entiteiten die zijn gekoppeld aan de opgegeven asset. |
Een IngestManifest maken
IngestManifests kan worden gemaakt met behulp van een HTTP POST-aanvraag en het doorgeven van een aanvraagbody die de naam van het nieuwe IngestManifest bevat.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | <https:// accountnaam.restv2>.<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
Voorbeeldaanvraag
Zie Media Services REST voor de nieuwste x-ms-version:versie.
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" }
Een IngestManifest weergeven
IngestManifests kunnen worden opgehaald met behulp van een HTTP GET-aanvraag. U kunt een opnamemanifest aanvragen op basis van de id of alle manifesten aanvragen.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| GET | <https:// accountnaam.restv2>.<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
| GET | <https:// accountnaam.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
Voorbeeldaanvraag
Zie Media Services REST voor de meest recente x-ms-version:versie.
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
Een IngestManifest bijwerken
IngestManifests kan worden bijgewerkt door te verwijzen naar de IngestManifest-id met een HTTP MERGE-aanvraag. De aanvraagbody bevat de eigenschappen die moeten worden bijgewerkt.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| SAMENVOEGEN | <https:// accountnaam.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
Voorbeeldaanvraag
Zie Media Services REST voor de meest recente x-ms-version:versie.
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" }
Een opnamemanifest verwijderen
IngestManifests kan worden verwijderd door te verwijzen naar de waarde IngestManifest Id met een HTTP DELETE-aanvraag.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| DELETE | <https:// accountnaam.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
Voorbeeldaanvraag
Zie Media Services REST voor de meest recente x-ms-version:versie.
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
Zie ook
AccessPolicy
AssetFile
Asset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Taak
JobTemplate
Locator
MediaProcessor
Taak
TaskTemplate
Quota en beperkingen