Compartir a través de

AccessPolicy

  • Artículo

La entidad AccessPolicy define los permisos y la duración del acceso a un recurso.

En este tema encontrará un resumen de la entidad AccessPolicy y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.

Propiedades de la entidad AccessPolicy

Propiedad Tipo Descripción
Id

Solo lectura. Se establece por Media Services en el momento de la creación.		 Edm.String Identificador único.
Created

Solo lectura. Se establece por Media Services en el momento de la creación.		 Edm.DateTime Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
LastModified

Solo lectura. Establecido por Servicios multimedia.		 Edm.DateTime Media Services actualiza este valor después de realizar cualquier cambio de propiedad. Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
Name

Necesario.		 Edm.String Nombre descriptivo para AccessPolicy.
DurationInMinutes

Necesario.		 Edm.Double Duración de validez de AccessPolicy.
Permissions

Opcional.		 Edm.Int32 Este valor especifica los derechos de acceso que tiene el cliente al interactuar con el recurso. Los valores válidos son:

- Ninguno = 0
- Lectura = 1
- Escritura = 2
- Delete = 4
- Lista = 8

El valor predeterminado es 0.

Tenga en cuenta que el permiso Lista no debe utilizarse cuando se crean localizadores OnDemandOrigin.

Creación de AccessPolicy

Para crear AccessPolicies, puede usar una solicitud HTTP POST.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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 }

Lista de AccessPolicies

Para recuperar AccessPolicies, use una solicitud HTTP GET.

Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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>

Eliminación de AccessPolicy

Para eliminar AccessPolicies, use una solicitud HTTP DELETE.

Método URI de solicitud Versión HTTP
Delete <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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 también

ContentKey
Recurso
AssetFile
Trabajo
JobTemplate
Localizador
MediaProcessor
Task
TaskTemplate
Cuotas y limitaciones