AccessPolicy

  • Artykuł

Obiekt AccessPolicy definiuje uprawnienia i czas trwania dostępu do elementu zawartości.

Ten temat zawiera omówienie AccessPolicy jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).

Właściwości jednostki AccessPolicy

Właściwość Typ Opis
Id

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.String Unikatowy identyfikator.
Created

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Przedstawia liczbę milisekund od północy 1 stycznia 1970 r.
LastModified

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.DateTime Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu jakichkolwiek zmian właściwości. Reprezentuje liczbę milisekund od północy 1 stycznia 1970 r.
Name

Wymagane.		 Edm.String Przyjazna nazwa dla zasad programu AccessPolicy.
DurationInMinutes

Wymagane.		 Edm.Double Czas trwania, dla którego wartość AccessPolicy jest prawidłowa.
Permissions

Opcjonalny.		 Edm.Int32 Ta wartość określa prawa dostępu klienta podczas interakcji z zasobem. Prawidłowe wartości:

- Brak = 0
- Odczyt = 1
- Zapis = 2
- Usuń = 4
- Lista = 8

Wartość domyślna to 0.

Należy pamiętać, że uprawnienia Lista nie powinny być używane podczas tworzenia lokalizatorów OnDemandOrigin.

Tworzenie zasad programu AccessPolicy

Zasady dostępu można utworzyć za pomocą żądania HTTP POST.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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 }

Lista zasad dostępu

Zasady dostępu można pobrać przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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>

Usuwanie zasad programu AccessPolicy

Zasady dostępu można usunąć przy użyciu żądania HTTP DELETE.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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

Zobacz też

ContentKey
Zasób
AssetFile
Zadanie
JobTemplate
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia