Partager via

AccessPolicy

  • Article

Une stratégie d'accès (AccessPolicy) définit les autorisations et la durée d'accès à un élément multimédia.

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

Propriété Type Description
Id

Lecture seule. Défini par Media Services au moment de la création.		 Edm.String Identificateur unique.
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.
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. Elle représente le nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit.
Name

Obligatoire.		 Edm.String Nom convivial de votre stratégie d'accès.
DurationInMinutes

Obligatoire.		 Edm.Double Durée de validité de la stratégie d'accès.
Permissions

Optionnel.		 Edm.Int32 Cette valeur spécifie les droits d'accès dont dispose le client lors de l'interaction avec l'élément multimédia. Les valeurs autorisées sont :

- Aucun = 0
- Lecture = 1
- Écriture = 2
- Supprimer = 4
- Liste = 8

La valeur par défaut est 0.

L'autorisation de liste ne doit pas être utilisée lors de la création de localisateurs OnDemandOrigin.

Création d'une stratégie d'accès

Les stratégies d'accès peuvent être créées à l'aide d'une requête HTTP POST.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> 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/AccessPolicies 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: 67  
Expect: 100-continue  
  
{"Name": "NewUploadPolicy", "DurationInMinutes" : "100", "Permissions" : 2 }

Liste des stratégies d'accès

Les stratégies d'accès peuvent être récupérées à l'aide d'une requête HTTP GET.

Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies 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/AccessPolicies('nb:pid:UUID:ad05d8fa-06a2-4e2f-8fb4-fac57875135a') 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>

Suppression d'une stratégie d'accès

Les stratégies d'accès peuvent être supprimées à l'aide d'une requête HTTP DELETE.

Méthode URI de demande Version HTTP
Suppression <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') 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/AccessPolicies('nb:pid:UUID:ad05d8fa-06a2-4e2f-8fb4-fac57875135a') 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

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