Partager via

Asset

  • Article

L'entité Asset contient des fichiers numériques (notamment des fichiers vidéo et audio, des images, des collections de miniatures, des pistes textuelles et des légendes) ainsi que les métadonnées concernant ces fichiers. Une fois les fichiers numériques chargés dans un élément multimédia, ils peuvent être utilisés dans des flux de travail de diffusion et d’encodage Media Services.

Lorsque vous encodez un élément multimédia, un élément multimédia de sortie est créé à la fin du travail d'encodage. Parmi les fichiers mentionnés ci-dessus, la ressource de sortie contient des fichiers de métadonnées XML qui décrivent la ressource d’entrée et la ressource de sortie. Pour plus d’informations, consultez les articles Métadonnées d’entrée et Métadonnées de sortie.

Les caractéristiques suivantes s’appliquent à une ressource dans Media Services :

  • Un élément multimédia est une unité logique qui représente une présentation audiovisuelle.

  • Il inclut une collection d'un ou plusieurs fichiers multimédias.

  • Les fichiers d'un élément multimédia sont placés dans un seul conteneur de stockage d'objets blob.

Voici quelques exemples d’une ressource : un film complet, une émission de télévision, une modification spécifique ; un clip d’un film, d’une émission de télévision, d’une animation, d’un fichier ISO de caméra ou d’un événement ; une bande-annonce de film ou une vidéo promotionnelle; une publicité; un fichier audio, une émission de radio, un podcast ou un fichier audio.

Les caractéristiques suivantes ne s’appliquent PAS à une ressource dans Media Services :

  • Simple conteneur de stockage.

  • Un dossier dans lequel organiser et stocker plusieurs versions de la même présentation.

  • Un dossier pour envoyer un traitement par lots de plusieurs présentations audiovisuelles à l'encodeur Azure Media.

Par exemple, vous ne devez pas stocker un film, sa bande-annonce, une publicité et une version d'édition internationale du même film dans un seul élément multimédia.

Cette rubrique offre une vue d'ensemble de l'entité Asset, 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é Asset

Propriété Type Description
Id

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

Lecture seule. Défini par Media Services.		 Edm.Int32 Valeur d'énumération qui décrit l'état de l'élément multimédia. Les valeurs admises sont les suivantes :

- Initialisé = 0
- Publié = 1 Avertissement : l’action Publish a été déconseillée. Supprimez le code qui vérifie si un élément multimédia se trouve dans l'état Published.
- Supprimé = 2

Un élément multimédia est toujours associé à l'état Initialisé jusqu'à sa suppression.
Created

Lecture seule. Défini par Media Services au moment de la création.		 Edm.DateTime Cette valeur est définie par Media Services au moment de la création.
LastModified

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

Optionnel.		 Edm.String Autre valeur d'ID qui correspond à un ID dans un autre système de gestion de contenu. La longueur maximale est de 4 000.
Name

Optionnel.		 Edm.String Nom convivial de votre élément multimédia. La longueur maximale est 512.
Options

Obligatoire. Mise à jour impossible après la création de l'entité.		 Edm.Int32 Valeur d'énumération qui décrit les options de chiffrement avec lesquelles un élément multimédia peut être créé. Une valeur valide est une de celle figurant dans la liste ci-dessous (et non une combinaison de celles-ci) :

- None = 0 : spécifie aucune option de création de ressource.
- StorageEncrypted = 1 : spécifie que les fichiers d’une ressource doivent être chiffrés pour le chargement et le stockage lors de la création de la ressource.
- CommonEncryptionProtected = 2 : spécifie que les fichiers d’une ressource sont protégés à l’aide d’une méthode de chiffrement commune (telle que PlayReady).
- EnvelopeEncryptionProtected = 4
Uri

Lecture seule. Défini par Media Services.		 Edm.String URI du conteneur de stockage d’objets blob de la ressource spécifiée.
Locators

Lecture seule. Défini par Media Services.		 Ensemble d'entités Locator L'ensemble d'entités renvoyé contient les entités Locator liées à l'élément multimédia spécifié.
ContentKeys

Optionnel.		 Ensemble d'entités ContentKey L'ensemble d'entités renvoyé contient les entités ContentKey liées à l'élément multimédia spécifié.
Files

Lecture seule. Défini par Media Services.		 Ensemble d'entités File L'ensemble d'entités renvoyé contient les entités File liées à l'élément multimédia spécifié.
ParentAssets

Optionnel.		 Ensemble d'entités Asset parent L'ensemble d'entités renvoyé contient les entités Asset parent liées à l'élément multimédia spécifié.
StorageAccountName

Optionnel. Mise à jour impossible après la création de l'entité.		 Edm.String Nom du compte de stockage dans lequel se trouve le conteneur d'objets blob de l'élément multimédia.

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.
StorageAccount

Lecture seule. Défini par Media Services.		 Jeu d’entités StorageAccount L'ensemble d'entités renvoyé contient les entités StorageAccount liées à l'élément multimédia spécifié.
DeliveryPolicies Jeu d’entités AssetDeliveryPolicy L'ensemble d'entités renvoyé contient les stratégies de diffusion associées à la ressource.
FormatOption Edm.Int32 Spécifie différentes options de format avec laquelle une ressource peut être créée. Les valeurs autorisées sont les suivantes : 0 (valeur par défaut) - ne spécifie aucune option de format de ressource ; 1 : spécifie que le format d’une ressource sera AdaptiveStreaming.

Créer une ressource

Les éléments multimédias peuvent être créés à l'aide d'une requête HTTP POST et en spécifiant la valeur des propriétés.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets> 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/Assets 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: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }

Liste des éléments multimédias

Les éléments multimédias peuvent être 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/Assets> HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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 élément multimédia

Les éléments multimédias peuvent être mis à jour à l'aide d'une requête HTTP MERGE et des propriétés spécifiques que vous voulez modifier.

Méthode URI de demande Version HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') 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: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }

Supprimer un élément multimédia

Les éléments multimédias peuvent être supprimés via la référence de la valeur d'ID de l'élément multimédia. Lorsqu’une ressource est supprimée, tous ses localisateurs sont supprimés par Microsoft Azure Media Services. Si la ressource avait des localisateurs d’origine, ces localisateurs seront également révoqués et supprimés. Tous les liens vers les ContentKeys seront supprimés. Les ContentKeys non liées à d'autres éléments multimédias seront supprimées.

Méthode URI de demande Version HTTP
Suppression <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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

Publication d'un élément multimédia

Remarque

L'action Publish est devenue obsolète. À compter de la dernière version de Media Services, Publish ne doit pas être utilisé.

Si votre code utilise l'action Publish, prenez en compte les éléments suivants :

  1. L'action Publish ne supprime pas les localisateurs associés à l'élément multimédia. Vous devez supprimer de manière explicite les localisateurs dans le code après avoir appelé Publish.
  2. L'action Publish ne définit pas l'état de l'élément multimédia sur Published. Supprimez le code qui vérifie si un élément multimédia se trouve dans l'état Published. Actuellement, un élément multimédia peut uniquement avoir l'état Initialized ou Deleted.

Association de clés de contenu aux éléments multimédias

Vous pouvez lier une clé ContentKey à une ressource en référençant l’ID de ressource avec une requête HTTP POST. L'URI de la ContentKey doit être inclus dans le corps de la requête. Vous pouvez uniquement lier un type de ContentKey correspondant au type spécifié dans les CreationOptions de l'élément multimédia. Par exemple, si les options de l'élément multimédia sont définies sur StorageEncrypted(1), la ContentKey doit être de type StorageEncryption(1).

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Id de ressource')/$links/ContentKeys 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/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys 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: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

Vous pouvez supprimer les liens ContentKey d’une ressource en référençant l’ID de ressource et l’ID ContentKey dans une requête HTTP DELETE. Si la ContentKey n'est pas associée à un autre élément multimédia, elle sera supprimée.

Méthode URI de demande Version HTTP
Suppression <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey 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/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') 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
ContentKey
AssetFile
Travail
JobTemplate
Locator
MediaProcessor
Tâche
TaskTemplate
Réception d'éléments multimédias à l'aide de l'API REST de Media Services
Quotas et limitations