Поделиться через


AccessPolicy

AccessPolicy определяется разрешения и длительность доступа к Asset.

В данном разделе приводится описание сущности AccessPolicy и демонстрируется выполнение различных операций с API REST служб мультимедиа.

Важно!

При доступе к сущностям в службах мультимедиа необходимо задать определенные поля и значения заголовков в HTTP-запросах.
Дополнительные сведения см. в статье Настройка rest API Служб мультимедиа Разработка и подключение к Службам мультимедиа с помощью REST API Служб мультимедиа.

Свойства сущности AccessPolicy

Свойство Тип Описание
Id

Только для чтения. Устанавливается Службами мультимедиа во время создания.
Edm.String Уникальный идентификатор.
Created

Только для чтения. Устанавливается Службами мультимедиа во время создания.
Edm.DateTime Представляет количество миллисекунд с полуночи 1 января 1970 г.
LastModified

Только для чтения. Задается Media Services.
Edm.DateTime Это значение обновляется Службами мультимедиа после внесения любых изменений свойств. Оно представляет количество миллисекунд с полуночи 1 января 1970 г.
Name

Обязательный.
Edm.String Понятное имя AccessPolicy.
DurationInMinutes

Обязательный.
Edm.Double Срок действия AccessPolicy.
Permissions

Необязательный элемент.
Edm.Int32 Это значение представляет права доступа клиента при взаимодействии с Asset. Допустимые значения:

- Нет = 0
- Чтение = 1
- Запись = 2
- Удалить = 4
- Список = 8

Значение по умолчанию — 0.

Обратите внимание, что разрешение на перечисление не следует использовать при создании указателей OnDemandOrigin.

Создание AccessPolicy

AccessPolicy можно создать с помощью HTTP-запроса POST.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

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 }  

Перечисление AccessPolicies

AccessPolicy можно получить с помощью HTTP-запроса GET.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

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>   

Удаление AccessPolicy

AccessPolicy можно удалить с помощью HTTP-запроса DELETE.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

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  
  

См. также:

ContentKey
Ресурс
AssetFile
Задание
JobTemplate
Локатор
MediaProcessor
Задача
TaskTemplate
Квоты и ограничения