Condividi tramite

AccessPolicy

  • Articolo

Un'entità AccessPolicy corrisponde a un criterio di accesso e definisce le autorizzazioni e la durata dell'accesso a un asset.

Questo argomento presenta informazioni generali sull'entità AccessPolicy e mostra come eseguire varie operazioni con l'API REST di Servizi multimediali.

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurazione per lo sviluppo di API REST di Servizi multimediali e connessione a Servizi multimediali con l'API REST di Servizi multimediali.

Proprietà dell'entità AccessPolicy

Proprietà Type Descrizione
Id

Di sola lettura. Impostato da Servizi multimediali in fase di creazione.		 Edm.String Identificatore univoco.
Created

Di sola lettura. Impostato da Servizi multimediali in fase di creazione.		 Edm.DateTime Rappresenta il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970.
LastModified

Di sola lettura. Impostata da Servizi multimediali.		 Edm.DateTime Questo valore viene aggiornato da Servizi multimediali dopo che vengono apportate modifiche alle proprietà. Rappresenta il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970.
Name

Obbligatorio.		 Edm.String Nome descrittivo dell'entità AccessPolicy.
DurationInMinutes

Obbligatorio.		 Edm.Double Periodo di validità dell'entità AccessPolicy.
Permissions

Facoltativa.		 Edm.Int32 Questo valore specifica i diritti di accesso di cui dispone il client quando interagisce con l'asset. I valori validi sono:

- Nessuno = 0
- Lettura = 1
- Write = 2
- Delete = 4
- Elenco = 8

Il valore predefinito è 0.

Tenere presente che l'autorizzazione di elenco non deve essere usata durante la creazione di localizzatori OnDemandOrigin.

Creare un'entità AccessPolicy

Le entità AccessPolicy possono essere create usando una richiesta HTTP POST.

Metodo URI richiesta Versione HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Richiesta di esempio

Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.

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 }

Elencare le entità AccessPolicy

Le entità AccessPolicy possono essere recuperate usando una richiesta HTTP GET.

Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Richiesta di esempio

Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.

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>

Eliminare un'entità AccessPolicy

Le entità AccessPolicy possono essere eliminate usando una richiesta HTTP DELETE.

Metodo URI richiesta Versione HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Richiesta di esempio

Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.

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

Vedere anche

ContentKey
Asset
AssetFile
Processo
JobTemplate
Locator
MediaProcessor
Attività
TaskTemplate
Quote e limitazioni