Locator
Un Locator offre un point d'entrée pour l'accès aux fichiers inclus dans un élément multimédia. Une AccessPolicy (stratégie d'accès) permet de définir les autorisations et la durée pendant laquelle un client a accès à un élément multimédia donné. Avec une stratégie d'accès, les localisateurs peuvent avoir une relation plusieurs-à-un de telle façon que différents localisateurs peuvent fournir différentes heures de début et types de connexions à différents clients, même si les mêmes paramètres d'autorisation et de durée sont appliqués à tous les clients. Toutefois, en raison d'une restriction de stratégie d'accès partagé définie par les services de stockage Azure, un maximum de cinq localisateurs peuvent être associés à un élément multimédia à la fois. Pour plus d’informations, consultez Utilisation d’une signature d’accès partagé (API REST).
Vous devez souvent transformer un URI Locator pour accéder à divers formats de fichier. Par exemple, la propriété Path du localisateur SAS donne accès au conteneur. Pour accéder aux fichiers, vous devez inclure le nom du fichier entre l'hôte et la signature SAS. Lorsque vous travaillez avec des localisateurs OnDemandOrigin, la Path propriété n’est pas utile tant qu’une partie spécifique au protocole n’y est pas ajoutée.
Les règles suivantes s'appliquent si un localisateur peut être créé et mis à jour :
Les localisateurs d'URL SAS utilisés avec des stratégies d'accès définissant des autorisations de lecture, de même que les localisateurs d'origine, ne peuvent être créés qu'après le chargement des fichiers dans un élément multimédia. Les localisateurs d'URL SAS qui sont utilisés pour le téléchargement ou le chargement des fichiers peuvent être créés avant le chargement des fichiers seulement s'ils sont utilisés avec des stratégies d'accès spécifiant les autorisations d'écriture.
Vous ne pouvez pas mettre à jour un localisateur d'URL SAS après l'avoir créé. En revanche, les autres types de localisateurs tels que les localisateurs d'origine peuvent être mis à jour avec de nouvelles valeurs StartTime.
Les URL des localisateurs SAP changent chaque fois que les clés de stockage du compte de stockage associé sont mises à jour. Pour plus d’informations, consultez Guide pratique pour mettre à jour Media Services après la mise à jour des clés d’accès de stockage propagées
Il peut y avoir un délai de 30 à 40 secondes après la création d’un localisateur avant qu’il soit disponible. Ce problème s'applique aux localisateurs d'URL SAS et OnDemandOrigin.
Notes
Les localisateurs ne sont pas destinés à gérer un contrôle d'accès par utilisateur. Pour accorder différents droits d’accès aux utilisateurs, utilisez les solutions de gestion des droits numériques (DRM).
Cet article donne une vue d’ensemble de l’entité Locator 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.
Propriétés de l'entité localisateur
| Propriété | Type | Description |
|---|---|---|
Idfacultatif. Mise à jour impossible après la création de l'entité. |
Edm.String | Identificateur unique défini par Media Services. |
NameOptionnel. |
Edm.String | Nom du localisateur. La longueur maximale est de 4 000. |
ExpirationDateTimeEn écriture seule. Utilisez une requête HTTP MERGE pour mettre à jour la valeur ExpirationDateTime. |
Edm.DateTime | Valeur (représentée en millisecondes depuis le 1er janvier 1970 minuit) à partir de laquelle le localisateur ne peut plus être utilisé pour accéder à l'élément multimédia spécifié. ExpirationDateTime doit être au format DateTime suivant : YYYY-MM-DDTHH:mm:ssZ (par exemple, « 2014-05-23T17:53:50Z »). |
TypeObligatoire. Mise à jour impossible après la création de l'entité. |
Edm.Int32 | Valeur d'énumération décrivant le type de localisateur. Les valeurs autorisées sont : - None = 0 : il s’agit de la valeur d’énumération par défaut. Aucun localisateur valide n'a ce type - SAP = 1 : spécifie le type de localisateur Signature d’accès partagé (Sas) - OnDemandOrigin = 2 : spécifie un type de localisateur, qui fait référence à un point de terminaison de streaming Azure Media Service On-Demand Origin |
PathLecture seule. Défini par Media Services. |
Edm.String | URL utilisée pour accéder aux fichiers d'éléments multimédias. |
BaseUriLecture seule. Défini par Media Services. |
Edm.String | Partie du localisateur qui fournit les informations de magasin/service/conteneur relatives à l'élément multimédia. (par exemple, nom http://someservice.cloudapp.netd’hôte Dns ) |
ContentAccessComponentLecture seule. Défini par Media Services. |
Edm.String | Partie de l'URI nécessaire pour accéder au contenu. L’emplacement de ce jeton dans l’URL du média final dépend du type de localisateur, du type de média et du service de streaming. |
AccessPolicyIdLecture seule. Défini par Media Services. |
Edm.String | ID d’AccessPolicy qui définit les autorisations et la durée de l’URL du localisateur. L’autorisation List ne doit pas être utilisée lors de la création de localisateurs OnDemandOrigin. |
AssetIdLecture seule. Défini par Media Services. |
Edm.String | ID de la ressource qui contient le contenu auquel vous souhaitez fournir l’accès. |
StartTimeOptionnel. |
Edm.DateTime | Date et heure auxquelles le localisateur sera disponible pour l'usage des clients. Pointe: Si vous devez charger vos fichiers immédiatement, vous devez définir votre valeur StartTime sur cinq minutes avant l’heure actuelle. Cela vient du fait qu’il peut exister un décalage horaire entre votre ordinateur client et Media Services. En outre, votre valeur StartTime doit être au format DateTime suivant : YYYY-MM-DDTHH:mm:ssZ (par exemple, « 2014-05-23T17:53:50Z »). |
AssetPolicyLecture seule. Défini par Media Services. |
Ensemble d'entités AssetPolicy |
Propriété de navigation vers une instance AccessPolicy. |
AssetLecture seule. Défini par Media Services. |
Ensemble d'entités Asset |
Propriété de navigation vers une instance d'élément multimédia. |
Création d'un localisateur
Les localisateurs peuvent être créés à l'aide d'une requête HTTP POST.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
Notes
Les URL des localisateurs SAS changent chaque fois que les clés de stockage du compte de stockage associé sont mises à jour. Pour plus d’informations, consultez Guide pratique pour mettre à jour Media Services après des clés d’accès de stockage propagées
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/Locators 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: 182
Expect: 100-continue
{"AccessPolicyId": "nb:pid:UUID:25544a8f-8ccf-43b1-a188-2a860b35bffa", "AssetId" : "nb:cid:UUID:d062e5ef-e496-4f21-87e7-17d210628b7c", "StartTime" : "2014-05-17T16:45:53", "Type":1}
Pour plus d’informations, consultez Remise de ressources avec l’API REST Media Services.
Liste des localisateurs
Les localisateurs peuvent être récupérés à l'aide d'une requête HTTP GET.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| GET | GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators | 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/Locators('nb:lid:UUID:627cbafb-3d81-4623-97c2-2194282b6d16') 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 localisateur
Les localisateurs d'origine peuvent être mis à jour à l'aide d'une demande MERGE HTTP.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | 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/Locators('nb:lid:UUID:5bfcb65d-843d-4d5e-bf71-9306ecb08203') 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: 38
Expect: 100-continue
{"StartTime" : "2014-05-17T16:45:53"}
Suppression d'un localisateur
Les localisateurs peuvent être supprimés à l'aide d'une requête HTTP DELETE.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | 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/Locators('nb:lid:UUID:9f0e0cee-8ea5-46c4-b985-5a7cd30e7623') 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
Connection: Keep-Alive
Voir aussi
Fourniture d'éléments multimédias avec l'API REST Media Services
ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Travail
MediaProcessor
Tâche
TaskTemplate
Quotas et limitations