Partager via

AssetFile

  • Article

L'entité AssetFile représente un fichier vidéo ou audio réel qui est stocké dans un conteneur d'objets blob. Un fichier d’élément multimédia est toujours associé à un élément multimédia et un élément multimédia peut contenir un ou plusieurs fichiers La tâche de Media Services Encoder échoue si un objet de fichier de ressources n’est pas associé à un fichier numérique dans un conteneur d’objets blob.

Cette rubrique offre une vue d'ensemble de l'entité AssetFile, 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 d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés de l'entité AssetFile

Propriété Type Description
Id

Lecture seule. Défini par Media Services au moment de la création.		 Edm.String Identificateur unique.
Name

Obligatoire.		 Edm.String Nom convivial de votre AssetFile. La valeur par défaut est le nom de fichier utilisé durant le téléchargement de votre fichier. La longueur maximale est de 260. Note: Media Services utilise la valeur de la propriété lors de la Name création d’URL pour le contenu en streaming (par exemple, http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Pour cette raison, l’encodage en pourcentage n’est pas autorisé. La valeur de la propriété Name ne peut pas comporter les caractères réservés à l’encodage en pourcentage suivants : !*'();:@&=+$,/?%#[]". En outre, il ne peut exister qu’un seul « . » pour l’extension de nom de fichier.
ContentFileSize

facultatif.		 Edm.Int64 Taille de l'AssetFile (en octets) du contenu.
ParentAssetId

Obligatoire. Mise à jour impossible après la création de l'entité.		 Edm.String ID de l'élément multimédia auquel ce fichier est associé.
EncryptionVersion

facultatif.		 Edm.String La version « 1.0 » est actuellement prise en charge pour StorageEncryption et CommonEncryption.
EncryptionScheme

facultatif.		 Edm.String Schéma de chiffrement utilisé pour ce fichier. Les valeurs valides sont : « StorageEncryption » ou « CommonEncryption ».
IsEncrypted

facultatif.		 Edm.Boolean Cette valeur doit être définie sur true si ce fichier est stocké sous forme chiffrée.
EncryptionKeyId

facultatif.		 Edm.String ID de ContentKey chiffrée.
InitializationVector

facultatif.		 Edm.String Vecteur d'initialisation utilisé pour le chiffrement de stockage.
IsPrimary

facultatif.		 Edm.Boolean Détermine si ce fichier est le fichier principal dans un élément multimédia incluant plusieurs fichiers.
LastModified

Lecture seule. Défini par Media Services au moment de la création.		 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.
Created

Lecture 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.
MimeType

facultatif.		 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. La longueur maximale est de 4 000.
ContentChecksum

facultatif.		 Edm.String Nombre hexadécimal représentant une valeur de synthèse de message MD5 (RFC 1321). Cette valeur est définie par le client ou la bibliothèque cliente pour valider le téléchargement correct du contenu. La longueur maximale est de 4 000.

Création d’un AssetFile

La fonction CreateFileInfos permet de créer une entité AssetFile. Pour plus d’informations, consultez Fonctions de l’API REST.

Liste des AssetFiles

Les AssetFiles sont récupérés à l'aide d'une requête HTTP GET.

Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files 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/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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

Mise à jour d'un AssetFile

Les AssetFiles sont mis à jour à l'aide d'une requête HTTP MERGE.

Méthode URI de demande Version HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Exemple de demande

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Suppression d'un AssetFile

Les AssetFiles sont supprimés une fois l'élément multimédia associé supprimé. Pour voir un exemple, consultez Suppression d'un élément multimédia.

Voir aussi

ContentKey
Asset
AccessPolicy
Travail
JobTemplate
Locator
MediaProcessor
Tâche
TaskTemplate
Quotas et limitations