Partilhar via

AccessPolicy

  • Artigo

Uma AccessPolicy define as permissões e a duração do acesso a um Recurso.

Este tópico fornece uma descrição geral da AccessPolicy entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade AccessPolicy

Propriedade Tipo Description
Id

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.String Identificador exclusivo.
Created

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.DateTime Representa o número de milissegundos desde a meia-noite de 1 de janeiro de 1970.
LastModified

Só de leitura. Definido pelos Serviços de Multimédia.		 Edm.DateTime Este valor é atualizado pelos Serviços de Multimédia depois de serem efetuadas alterações de propriedade. Representa o número de milissegundos desde a meia-noite de 1 de janeiro de 1970.
Name

Obrigatório.		 Edm.String Nome amigável para accessPolicy.
DurationInMinutes

Obrigatório.		 Edm.Double Duração para a qual a AccessPolicy é válida.
Permissions

Opcional.		 Edm.Int32 Este valor especifica os direitos de acesso que o cliente tem ao interagir com o Recurso. Os valores válidos são:

- Nenhum = 0
- Leitura = 1
- Escrita = 2
- Eliminar = 4
- Lista = 8

O valor predefinido é 0.

Tenha em atenção que a permissão Lista não deve ser utilizada ao criar localizadores OnDemandOrigin.

Criar uma AccessPolicy

As AccessPolicies podem ser criadas com um pedido HTTP POST.

Método URI do pedido Versão HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Pedido de Amostra

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

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 }

Listar AccessPolicies

As AccessPolicies podem ser obtidas com um pedido GET HTTP.

Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Pedido de Amostra

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

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>

Eliminar uma Política de Acesso

As Políticas de Acesso podem ser eliminadas com um pedido DELETE HTTP.

Método URI do pedido Versão HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Pedido de Amostra

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

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

Consulte também

ContentKey
Recurso
AssetFile
Tarefa
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Quotas e Limitações