Delen via

Locator

  • Artikel

Locator biedt een toegangspunt voor toegang tot de bestanden in een asset. Een AccessPolicy wordt gebruikt om de machtigingen en duur te definiëren die een client toegang heeft tot een bepaalde asset. Locators kunnen een veel-op-een-relatie hebben met een AccessPolicy, zodat verschillende Locators verschillende starttijden en verbindingstypen voor verschillende clients kunnen bieden terwijl ze allemaal dezelfde machtigings- en duurinstellingen gebruiken; Vanwege een beperking voor gedeeld toegangsbeleid die is ingesteld door Azure Storage-services, kunt u echter niet meer dan vijf unieke locators tegelijk aan een bepaalde asset hebben gekoppeld. Zie Een Shared Access Signature (REST API) gebruiken voor meer informatie.

Vaak moet u een Locator URI transformeren om toegang te krijgen tot verschillende bestandsindelingen. De eigenschap van Path de SAS-locator geeft bijvoorbeeld toegang tot de container. Voor toegang tot bestanden moet u de bestandsnaam insluiten tussen de host en de SAS-handtekening. Wanneer u met OnDemandOrigin-locators werkt, is de Path eigenschap pas nuttig als het protocolspecifieke onderdeel eraan wordt toegevoegd.

De volgende regels bepalen wanneer een locator kan worden gemaakt en bijgewerkt:

  1. SAS-URL-locators (Access Signature) die worden gebruikt met AccessPolicies die leesmachtigingen definiëren, evenals origin-locators, kunnen pas worden gemaakt nadat de bestanden zijn geüpload naar een asset. SAS-URL-locators, die worden gebruikt om bestanden te downloaden of uploaden, kunnen alleen worden gemaakt voordat de bestanden worden geüpload als ze worden gebruikt met AccessPolicies die schrijfmachtigingen opgeven.

  2. U kunt een SAS-URL-locator niet bijwerken nadat deze is gemaakt. Andere locatortypen, zoals oorspronkelijke locators, kunnen echter worden bijgewerkt met nieuwe StartTime-waarden.

  3. DE URL's van SAS-locators worden telkens gewijzigd wanneer de opslagsleutels van het gekoppelde opslagaccount worden bijgewerkt. Zie Procedure: Media Services bijwerken na rolling storage-toegangssleutels voor meer informatie

  4. Er kan een vertraging van 30 tot 40 seconden zijn nadat een locator is gemaakt tot wanneer deze beschikbaar is voor gebruik. Dit probleem is van toepassing op zowel SAS-URL- als OnDemandOrigin-locators.

Notitie

Locators zijn niet ontworpen voor het beheren van toegangsbeheer per gebruiker. Gebruik DRM-oplossingen (Digital Rights Management) als u afzonderlijke gebruikers verschillende toegangsrechten wilt geven.

Dit artikel geeft een overzicht van de Locator entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connect to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Eigenschappen van locator-entiteit

Eigenschap Type Beschrijving
Id

Optioneel. Kan niet worden bijgewerkt nadat de entiteit is gemaakt.		 Edm.String Unieke id ingesteld door Media Services.
Name

Optioneel.		 Edm.String De naam van de locator. De maximale lengte is 4000.
ExpirationDateTime

Alleen-schrijven. Gebruik een MERGE HTTP-aanvraag om de waarde ExpirationDateTime bij te werken.		 Edm.DateTime De waarde (weergegeven in milliseconden sinds middernacht 1 januari 1970) wanneer de locator niet meer kan worden gebruikt voor toegang tot de opgegeven asset.

De ExpirationDateTime moet de volgende Datum/tijd-notatie hebben: YYYY-MM-DDTHH:mm:ssZ (bijvoorbeeld '2014-05-23T17:53:50Z').
Type

Vereist. Kan niet worden bijgewerkt nadat de entiteit is gemaakt.		 Edm.Int32 Opsommingswaarde die het type Locator beschrijft. Geldige waarden zijn:

- Geen = 0: dit is de standaard opsommingswaarde. Geen geldige locator heeft dit type
- SAS = 1: hiermee geeft u sas-locatortype (Shared Access Signature) op
- OnDemandOrigin = 2: hiermee geeft u een locatortype op, dat verwijst naar een streaming-eindpunt van Azure Media Service On-Demand Origin
Path

Alleen-lezen. Ingesteld door Media Services.		 Edm.String URL die wordt gebruikt voor toegang tot assetbestanden.
BaseUri

Alleen-lezen. Ingesteld door Media Services.		 Edm.String Onderdeel van de locator die informatie over de store/service/container over de asset biedt. (bijvoorbeeld DNS-hostnaam http://someservice.cloudapp.net)
ContentAccessComponent

Alleen-lezen. Ingesteld door Media Services.		 Edm.String Een deel van de URI dat nodig is voor toegang tot de inhoud. De locatie van dit token in de uiteindelijke media-URL is afhankelijk van het locatortype, het mediatype en de streamingservice.
AccessPolicyId

Alleen-lezen. Ingesteld door Media Services.		 Edm.String De id van het AccessPolicy dat de machtigingen en duur voor de Locator-URL definieert.

De lijstmachtiging mag niet worden gebruikt bij het maken van OnDemandOrigin-locators.
AssetId

Alleen-lezen. Ingesteld door Media Services.		 Edm.String De id van de asset die de inhoud bevat waartoe u toegang wilt verlenen.
StartTime

Optioneel.		 Edm.DateTime De datum en tijd waarop uw locator beschikbaar is voor clients. Tip: Als u uw bestanden onmiddellijk wilt uploaden, moet u de waarde voor StartTime instellen op vijf minuten voor de huidige tijd. Dit komt doordat er mogelijk een scheefe klok is tussen uw clientcomputer en Media Services. Bovendien moet uw StartTime-waarde de volgende Datum/tijd-notatie hebben: YYYY-MM-DDTHH:mm:ssZ (bijvoorbeeld '2014-05-23T17:53:50Z').
AssetPolicy

Alleen-lezen. Ingesteld door Media Services.		 AssetPolicy entiteitsset Navigatie-eigenschap naar een AccessPolicy-exemplaar.
Asset

Alleen-lezen. Ingesteld door Media Services.		 Asset entiteitsset Navigatie-eigenschap naar een assetexemplaren.

Een locator maken

Locators kunnen worden gemaakt met een POST HTTP-aanvraag.

Methode Aanvraag-URI HTTP-versie
POST <https:// accountnaam.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Notitie

DE URL's van SAS-locators worden telkens gewijzigd wanneer de opslagsleutels van het gekoppelde opslagaccount worden bijgewerkt. Zie Procedure: Media Services bijwerken na rolling storage-toegangssleutels voor meer informatie

Voorbeeldaanvraag

Zie Media Services REST voor de meest recente x-ms-version:versie.

POST https://<accountname>.restv2.<location>.media.azure.net/api/Locators 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: 182  
Expect: 100-continue  
  
{"AccessPolicyId": "nb:pid:UUID:25544a8f-8ccf-43b1-a188-2a860b35bffa", "AssetId" : "nb:cid:UUID:d062e5ef-e496-4f21-87e7-17d210628b7c", "StartTime" : "2014-05-17T16:45:53", "Type":1}

Zie Assets leveren met de Media Services REST API voor meer informatie.

Lijstzoekers

Locators kunnen worden opgehaald met behulp van een GET HTTP-aanvraag.

Methode Aanvraag-URI HTTP-versie
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de meest recente x-ms-version:versie.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:627cbafb-3d81-4623-97c2-2194282b6d16') 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

Een locator bijwerken

Origin Locators kunnen worden bijgewerkt met behulp van een HTTP-aanvraag SAMENVOEGEN.

Methode Aanvraag-URI HTTP-versie
SAMENVOEGEN <https:// accountnaam.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de meest recente x-ms-version:versie.

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:5bfcb65d-843d-4d5e-bf71-9306ecb08203') 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: 38  
Expect: 100-continue  
  
{"StartTime" : "2014-05-17T16:45:53"}

Een locator verwijderen

Locators kunnen worden verwijderd met behulp van een HTTP-aanvraag VERWIJDEREN.

Methode Aanvraag-URI HTTP-versie
DELETE <https:// accountnaam.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de meest recente x-ms-version:versie.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:9f0e0cee-8ea5-46c4-b985-5a7cd30e7623') 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  
Connection: Keep-Alive

Zie ook

Assets leveren met de Media Services REST API
ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Taak
MediaProcessor
Taak
TaskTemplate
Quota en beperkingen