AccessPolicy
EN
Dette innholdet er ikke tilgjengelig på ditt språk, men her er den engelske versjonen.

AccessPolicy

 

Updated: July 14, 2016

An AccessPolicy defines the permissions and duration of access to an Asset.

This topic gives an overview of the AccessPolicy entity and also demonstrates how to execute various operations with the Media Services REST API.

System_CAPS_importantImportant

When working with the Media Services REST API, the following considerations apply:

Property

Type

Description

Id

Read-only. Set by Media Services at creation time.

Edm.String

Unique identifier.

Created

Read-only. Set by Media Services at creation time.

Edm.DateTime

Represents the number of milliseconds since midnight Jan 1, 1970.

LastModified

Read-only. Set by Media Services.

Edm.DateTime

This value is updated by Media Services after any property changes are made. It represents the number of milliseconds since midnight Jan 1, 1970.

Name

Required.

Edm.String

Friendly name for your AccessPolicy.

DurationInMinutes

Required.

Edm.Double

Duration that the AccessPolicy is valid for.

Permissions

Optional.

Edm.Int32

This value specifies the access rights the client has when interacting with the Asset. Valid values are:

  • None = 0

  • Read = 1

  • Write = 2

  • Delete = 4

  • List = 8

The default value is 0.

Note that the List permission should not be used when creating OnDemandOrigin locators.

AccessPolicies can be created with a POST HTTP request.

Method

Request URI

HTTP Version

POST

https://media.windows.net/API/AccessPolicies

HTTP/1.1

System_CAPS_importantImportant

After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.

To get the latest x-ms-version:, see Azure Media Services REST API Reference.

POST https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 67
Expect: 100-continue

{"Name": "NewUploadPolicy", "DurationInMinutes" : "100", "Permissions" : 2 }

AccessPolicies can be retrieved using a GET HTTP request.

Method

Request URI

HTTP Version

GET

https://media.windows.net/API/AccessPolicies

HTTP/1.1

Method

Request URI

HTTP Version

GET

https://media.windows.net/API/AccessPolicies('accesspolicyid')

HTTP/1.1

Method

Request URI

HTTP Version

GET

https://media.windows.net/API/Assets('assetid')/AccessPolicies

HTTP/1.1

System_CAPS_importantImportant

After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.

To get the latest x-ms-version:, see Azure Media Services REST API Reference.

GET https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbusvoddev.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334276569&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=Cax61TKgo%2fLo5k6AWA%2brOLdAbMMd4poqvpVqiRPdTXk%3d
Host: media.windows.net


AccessPolicies can be deleted using a DELETE HTTP request.

Method

Request URI

HTTP Version

DELETE

https://media.windows.net/API/AccessPolicies('accesspolicyid')

HTTP/1.1

System_CAPS_importantImportant

After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.

To get the latest x-ms-version:, see Azure Media Services REST API Reference.

DELETE https://media.windows.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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337156939&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=IMU5VFP%2bhekKwnUJR13b%2fBMsrZF1h72pZdMlqZ8Txf8%3d
Host: media.windows.net
Content-Length: 0

Vis:
© 2016 Microsoft