IngestManifest
Un IngestManifest représente un ensemble d'éléments multimédias à créer via la réception en bloc avec leurs fichiers d'éléments multimédias associés. L’ingestion en bloc vous permet de dissocier le processus de chargement de fichiers de la création de ressources. Par conséquent, une méthode de chargement de fichiers hautes performances peut être utilisée pour les jeux de fichiers volumineux lors de la création de ressources. Une fois qu’un IngestManifestAssets est créé, ainsi que ses IngestManifestFiles associés, Microsoft Azure Media Services surveille le conteneur de stockage Blob associé à IngestManifest via la propriété BlobStorageUriForUpload. À chaque chargement de fichier dans le conteneur de stockage Blob, Microsoft Azure Media Services termine une nouvelle ressource pour l’IngestManifestAsset correspondant qui contient ce fichier.
Cet article donne une vue d’ensemble de l’entité IngestManifest et montre également comment exécuter diverses opérations avec l’API REST Media Services.
Important
Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.
Notes
Chaque IngestManifestAssetFile associé à un IngestManifest doit avoir un nom de fichier unique dans le manifeste.
Propriétés de l'entité IngestManifest
| Propriété | Type | Description |
|---|---|---|
IdLecture seule. Défini par Media Services au moment de la création. |
Edm.String | Identificateur unique. |
CreatedLecture seule. Défini par Media Services au moment de la création. |
Edm.DateTime | Indique le nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit. |
LastModifiedLecture seule. Défini par Media Services. |
Edm.DateTime | Cette valeur est mise à jour par Media Services après que des modifications de propriété ont été apportées. Elle représente le nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit. |
NameOptionnel. |
Edm.String | Nom convivial de votre IngestManifest. |
StateLecture seule. Défini par Media Services. |
Edm.Int32 | État actuel du manifeste. Cette valeur peut être l'une des suivantes : - Inactif = 0 : aucune création de ressource en attente ne reste. Toutes sont terminées ou ont généré une erreur. - Activation = 1 : le manifeste n’est pas encore prêt à recevoir les fichiers chargés dans le conteneur d’objets blob. - Actif = 2 : Des créations d’IngestManifestAssets sont en attente et le conteneur d’objets blob est surveillé. |
BlobStorageUriForUploadLecture seule. Défini par Media Services. |
Edm.String | Cette valeur est définie par Media Services. Cette valeur spécifie l’URI du conteneur de stockage Blob, qui reçoit les téléchargements de fichiers nécessaires pour terminer les IngestManifestAssets. |
StatisticsLecture seule. Défini par Media Services. |
IngestManifestStatistics | Ce type complexe contient des informations statistiques qui permettent de déterminer la progression actuelle de la création des IngestManifestAssets sur la base des fichiers d'éléments multimédias liés au manifeste. |
IngestManifestAssetsLecture seule. Défini par Media Services. |
Ensemble d’entités IngestManifestAsset | Propriété de navigation accessible via la référence d'un IngestManifestAsset spécifique selon la valeur d'ID. L'ensemble d'entités renvoyé comprend les IngestManifestAssets contenus dans l'IngestManifest. |
PendingIngestManifestAssetsLecture seule. Défini par Media Services. |
Ensemble d’entités IngestManifestAsset | Propriété de navigation accessible via la référence d'un IngestManifestAsset spécifique selon la valeur d'ID. L'ensemble d'entités renvoyé contient les IngestManifestAssets en attente de téléchargement de fichiers ou de création d'éléments multimédias. |
StorageAccountNameOptionnel. Mise à jour impossible après la création de l'entité. |
Edm.String | Nom du compte de stockage comprenant le conteneur d'objets blob où les fichiers sont téléchargés. S’il n’est pas spécifié au moment de la création, Media Services définit le nom du compte de stockage par défaut. IngestManifestAsset.Asset doit utiliser le même compte de stockage que celui qui est indiqué dans l'IngestManifest. |
StorageAccountLecture seule. Défini par Media Services. |
Ensemble d'entités StorageAccount | L'ensemble d'entités renvoyé contient les entités StorageAccount liées à l'élément multimédia spécifié. |
Création d'un IngestManifest
Les IngestManifests peuvent être créés à l'aide d'une requête HTTP POST, en transmettant un corps de requête contenant le nom du nouvel IngestManifest.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
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" }
Liste des IngestManifests
Les IngestManifests peuvent être récupérés à l'aide d'une requête HTTP GET. Vous pouvez demander un manifeste de réception selon son ID ou tous les manifestes.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| 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 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
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
Mise à jour d'un IngestManifest
IngestManifests peut être mis à jour en référençant l’ID IngestManifest avec une requête HTTP MERGE. Le corps de la requête contient les propriétés à mettre à jour.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
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" }
Suppression d'un IngestManifest
Les IngestManifests peuvent être supprimés en faisant référence à la valeur d'ID d'IngestManifest à l'aide d'une requête HTTP DELETE.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
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
Voir aussi
AccessPolicy
AssetFile
Asset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Travail
JobTemplate
Locator
MediaProcessor
Tâche
TaskTemplate
Quotas et limitations