IngestManifestFile
Un IngestManifestFile représente un objet blob vidéo ou audio réel qui sera téléchargé dans le cadre de l'opération de réception en bloc. Pour plus d’informations sur l’ingestion en bloc, consultez Ingestion de ressources en bloc avec l’API REST. Un IngestManifestFile est toujours associé à un IngestManifest et à un IngestManifestAsset.
Cette rubrique offre une vue d'ensemble de l'entité IngestManifestFile, et montre 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 de l’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.
Propriétés de l'entité IngestManifestFile
| 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 une fois 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. |
NameObligatoire. |
Edm.String | Nom de fichier réel qui sera chargé dans le conteneur d’objets blob référencé par la propriété BlobStorageUriForUpload d’IngestManifest. Media Services surveille le chargement du fichier dans ce conteneur par son nom. Le nom du fichier ne peut ni être vide ni contenir des espaces. Unique au sein du IngestManifest. La longueur maximale est de 4 000. |
StateLecture seule. Défini par Media Services. |
Edm.Int32 | État actuel de l'IngestManifestFile. Cette valeur peut être l'une des suivantes : - En attente = 0 : le fichier n’a pas encore été chargé pour terminer la création de la ressource. Media Services attend le chargement du fichier. - Terminé = 1 : le chargement du fichier a été détecté et la ressource associée a été mise à jour. - Erreur = 2 : une erreur s’est produite lors du traitement de ce fichier. Pour plus d'informations sur l'erreur, consultez la propriété ErrorDetails. |
ParentIngestManifestIdObligatoire. |
Edm.String | ID d'IngestManifest du manifeste qui contient ce fichier. |
ParentIngestManifestAssetIdObligatoire. |
Edm.String | ID d'IngestManifestAsset de l'IngestManifestAsset auquel ce fichier est associé. |
ErrorDetailLecture seule. Défini par Media Services. |
Edm.String | Détails d'une erreur rencontrée lors du traitement de ce fichier. |
MimeTypeOptionnel. |
Edm.String | Media Services ne contrôlant pas les objets blob que vous avez téléchargés, vous devez définir manuellement le type mime. Par exemple, les valeurs « text/plain » ou « video/x-ms-wmv » sont valides. |
IsPrimaryOptionnel. |
Edm.Boolean | Détermine si ce IngestManifestFile est le fichier principal dans un élément multimédia incluant plusieurs fichiers. |
EncryptionVersionOptionnel. |
Edm.String | La version « 1.0 » est actuellement prise en charge pour StorageEncryption, CommonEncryption et EnvelopeEncryption. |
EncryptionSchemeOptionnel. |
Edm.String | Schéma de chiffrement utilisé pour ce fichier. Les valeurs valides sont « StorageEncryption », « CommonEncryption » ou « EnvelopeEncryption ». |
IsEncryptedOptionnel. |
Edm.Boolean | Cette valeur doit être définie sur true si ce fichier est stocké sous forme chiffrée. |
EncryptionKeyIdOptionnel. |
Edm.String | ID de ContentKey chiffrée. |
InitializationVectorOptionnel. |
Edm.String | Vecteur d'initialisation utilisé pour le chiffrement de stockage. |
Création d'un IngestManifestFile
Les IngestManifestFiles peuvent être créés à l'aide d'une requête HTTP POST. Vous devez transmettre un corps de requête contenant la valeur Name du nouveau IngestManifestFile, ainsi que les ParentIngestManifestId et ParentIngestManifestAssetId.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
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" }
Liste des IngestManifestFiles
Les IngestManifestFiles peuvent être récupérés à l'aide d'une requête HTTP GET. Vous pouvez rechercher un IngestManifestFile par son ID ou rechercher tous les IngestManifestFiles en omettant l'ID.
| Méthode | URI de demande | Version 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 |
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/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
Suppression d'un IngestManifestFile
Les IngestManifestFiles peuvent être supprimés en référençant la valeur d'ID d'IngestManifestFile à l'aide d'une requête HTTP DELETE.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile 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/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
Voir aussi
AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Quotas et limitations