Freigeben über

AccessPolicy

  • Artikel

Eine AccessPolicy definiert die Zugriffsberechtigungen für und die Zugriffsdauer auf ein Medienobjekt.

Dieses Thema enthält eine Übersicht über die Entität AccessPolicy. Darüber hinaus wird gezeigt, wie unterschiedliche Vorgänge mit der Media Services REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

AccessPolicy-Entitätseigenschaften

Eigenschaft type BESCHREIBUNG
Id

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.String Eindeutiger Bezeichner.
Created

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.DateTime Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
LastModified

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftsänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
Name

Erforderlich.		 Edm.String Der Anzeigename für Ihre AccessPolicy.
DurationInMinutes

Erforderlich.		 Edm.Double Die Zeitspanne, für die die AccessPolicy gültig ist.
Permissions

Optional.		 Edm.Int32 Dieser Wert gibt die Zugriffsrechte des Clients bei der Interaktion mit dem Medienobjekt an. Gültige Werte sind:

- None = 0
- Read = 1
– Schreiben = 2
- Löschen = 4
- Liste = 8

Der Standardwert ist 0.

Beachten Sie, dass die Listenberechtigung bei der Erstellung on OnDemandOrigin-Locators nicht verwendet werden sollte.

Erstellen eines AccessPolicy-Objekts

AccessPolicies können mit einer POST HTTP-Anforderung erstellt werden.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services 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 }

Auflisten von AccessPolicy-Objekten

AccessPolicies können mithilfe einer GET HTTP-Anforderung abgerufen werden.

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services 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>

Löschen eines AccessPolicy-Objekts

AccessPolicies können mithilfe einer DELETE HTTP-Anforderung gelöscht werden.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services 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

Weitere Informationen

ContentKey
Asset
AssetFile
Job
JobTemplate
Locator
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen