Compartilhar via


AccessPolicy

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

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

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades da entidade AccessPolicy

Propriedade Type Descrição
Id

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.
Edm.String Identificador exclusivo.
Created

Somente leitura. Definido pelos Serviços de Mí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

Somente leitura. Configurada pelos Serviços de Mídia.
Edm.DateTime Esse valor é atualizado pelos Serviços de Mídia depois que quaisquer alterações de propriedade são feitas. Representa o número de milissegundos desde a meia-noite de 1º de janeiro de 1970.
Name

Obrigatórios.
Edm.String Nome amigável para a sua AccessPolicy.
DurationInMinutes

Obrigatórios.
Edm.Double Validade da AccessPolicy.
Permissions

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

- Nenhum = 0
- Leitura = 1
- Gravação = 2
– Excluir = 4
- Lista = 8

O valor padrão é 0.

Observe que a permissão de Lista não deve ser usada ao criar localizadores OnDemandOrigin.

Criar uma AccessPolicy

AccessPolicies podem ser criadas com uma solicitação POST HTTP.

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

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mí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

AccessPolicies podem ser recuperadas usando uma solicitação HTTP GET.

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

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mí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>   

Excluir uma AccessPolicy

AccessPolicies podem ser excluídas usando uma solicitação DELETE HTTP.

Método URI da solicitação Versão de HTTP
Delete (excluir) <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mí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
Ativo
AssetFile
Trabalho
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Cotas e limitações