Locator

Artikel
08/05/2023

Locator tillhandahåller en startpunkt för att komma åt filerna som finns i en tillgång. En AccessPolicy används för att definiera de behörigheter och varaktighet som en klient har åtkomst till en viss tillgång. Lokaliserare kan ha en många-till-en-relation med en AccessPolicy, så att olika positionerare kan ge olika starttider och anslutningstyper till olika klienter samtidigt som alla använder samma behörighets- och varaktighetsinställningar. Men på grund av en principbegränsning för delad åtkomst som angetts av Azure Storage-tjänster kan du inte ha fler än fem unika lokaliserare som är associerade med en viss tillgång samtidigt. Mer information finns i Använda en signatur för delad åtkomst (REST API).

Du behöver ofta transformera en Locator URI för att få åtkomst till olika filformat. Till exempel ger SAS-lokaliserarens Path egenskap åtkomst till containern. För att komma åt filer måste du bädda in filnamnet mellan värden och SAS-signaturen. När du arbetar med OnDemandOrigin-lokaliserare Path är egenskapen inte användbar förrän den protokollspecifika delen har lagts till i den.

Följande regler styr när en positionerare kan skapas och uppdateras:

Url-positionerare för åtkomstsignatur (SAS) som används med AccessPolicies som definierar läsbehörigheter, samt Origin Locators, kan inte skapas förrän filerna har laddats upp till en tillgång.. SAS URL-positionerare, som används för att ladda ned eller ladda upp filer, kan skapas innan filerna laddas upp endast om de används med AccessPolicies som anger skrivbehörigheter.
Du kan inte uppdatera en SAS URL-positionerare när den har skapats. Andra positionerartyper, till exempel ursprungslokaliserare, kan dock uppdateras med nya StartTime-värden.
URL:er för SAS-lokaliserare ändras varje gång lagringsnycklarna för det associerade lagringskontot uppdateras. Mer information finns i How To: Update Media Services after Rolling Storage Access Keys (Så här uppdaterar du Media Services efter rullande lagringsåtkomstnycklar)
Det kan uppstå en fördröjning på 30–40 sekunder när en positionerare har skapats till när den är tillgänglig för användning. Det här problemet gäller både SAS-URL:en och OnDemandOrigin-lokaliserare.

Anteckning

Positionerare är inte utformade för att hantera åtkomstkontroll per användare. Om du vill ge olika åtkomsträttigheter till enskilda användare kan du använda DRM-lösningar (Digital Rights Management).

Den här artikeln ger en översikt över Locator entiteten och visar även hur du kör olika åtgärder med Media Services REST API.

Viktigt

När du kommer åt entiteter i Media Services måste du ange specifika rubrikfält och värden i dina HTTP-begäranden.
Mer information finns i Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Installation för Media Services REST API Development and Connecting to Media Services with the Media Services REST API).

Entitetsegenskaper för positionerare

Egenskap	Typ	Description
`Id` Valfritt. Det går inte att uppdatera när entiteten har skapats.	Edm.String	Unik identifierare som angetts av Media Services.
`Name` Valfritt.	Edm.String	Namnet på lokaliseraren. Maximal längd är 4 000.
`ExpirationDateTime` Skrivskyddad. Använd en MERGE HTTP-begäran för att uppdatera värdet ExpirationDateTime.	Edm.DateTime	Värdet (representeras i millisekunder sedan midnatt den 1 januari 1970) när positioneraren inte längre kan användas för att komma åt den angivna tillgången. ExpirationDateTime måste ha följande DateTime-format: `YYYY-MM-DDTHH:mm:ssZ` (till exempel "2014-05-23T17:53:50Z").
`Type` Krävs. Det går inte att uppdatera när entiteten har skapats.	Edm.Int32	Uppräkningsvärde som beskriver typen av positionerare. Giltiga värden är: - Ingen = 0: Det här är standarduppräkningsvärdet. Ingen giltig positionerare har den här typen - SAS = 1: Anger positionerartyp för signatur för delad åtkomst (Sas) - OnDemandOrigin = 2: Anger en positionerartyp som refererar till en Azure Media Service-slutpunkt för direktuppspelning på begäran
`Path` Skrivskyddad. Anges av Media Services.	Edm.String	URL som används för åtkomst till tillgångsfiler.
`BaseUri` Skrivskyddad. Anges av Media Services.	Edm.String	En del av positioneraren som tillhandahåller information om tillgången för lagring/tjänst/container. (till exempel Dns-värdnamn `http://someservice.cloudapp.net`)
`ContentAccessComponent` Skrivskyddad. Anges av Media Services.	Edm.String	En del av den URI som krävs för att komma åt innehållet. Platsen för denna token i den slutliga medie-URL:en beror på positionerartyp, medietyp och strömningstjänst.
`AccessPolicyId` Skrivskyddad. Anges av Media Services.	Edm.String	ID:t för AccessPolicy som definierar behörigheter och varaktighet för positionerar-URL:en. Listbehörigheten ska inte användas när du skapar OnDemandOrigin-positionerare.
`AssetId` Skrivskyddad. Anges av Media Services.	Edm.String	ID:t för tillgången som innehåller det innehåll som du vill ge åtkomst till.
`StartTime` Valfritt.	Edm.DateTime	Datum och tid då positioneraren är tillgänglig för klienter att använda. Tips: Om du behöver ladda upp dina filer omedelbart bör du ange StartTime-värdet till fem minuter före den aktuella tiden. Det beror på att det kan uppstå klocksnedvridning mellan klientdatorn och Media Services. Dessutom måste ditt StartTime-värde ha följande DateTime-format: `YYYY-MM-DDTHH:mm:ssZ` (till exempel "2014-05-23T17:53:50Z").
`AssetPolicy` Skrivskyddad. Anges av Media Services.	`AssetPolicy` entitetsuppsättning	Navigeringsegenskap till en AccessPolicy-instans.
`Asset` Skrivskyddad. Anges av Media Services.	`Asset` entitetsuppsättning	Navigeringsegenskap till en tillgångsinstans.

Skapa en positionerare

Lokaliserare kan skapas med en POST HTTP-begäran.

Metod	URI för förfrågan	HTTP-version
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>	HTTP/1.1

Anteckning

URL:er för SAS-lokaliserare ändras varje gång lagringsnycklarna för det associerade lagringskontot uppdateras. Mer information finns i How To: Update Media Services after Rolling Storage Access Keys (Så här uppdaterar du Media Services efter rullande lagringsåtkomstnycklar)

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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}

Mer information finns i Leverera tillgångar med Media Services REST API.

Lista lokaliserare

Positionerare kan hämtas med hjälp av en GET HTTP-begäran.

Metod	URI för förfrågan	HTTP-version
GET	GET https://< accountname.restv2>.<location.media.azure.net/api/Locators>	HTTP/1.1

Metod	URI för förfrågan	HTTP-version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Metod	URI för förfrågan	HTTP-version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators	HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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

Uppdatera en positionerare

Origin Locators kan uppdateras med hjälp av en MERGE HTTP-begäran.

Metod	URI för förfrågan	HTTP-version
SAMMANFOGA	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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"}

Ta bort en positionerare

Positionerare kan tas bort med en HTTP-begäran DELETE.

Metod	URI för förfrågan	HTTP-version
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

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

Se även

Leverera tillgångar med Media Services REST API
ContentKey
Tillgång
AccessPolicy
AssetFile
JobTemplate
Jobb
MediaProcessor
Uppgift
TaskTemplate
Kvoter och begränsningar

Locator

Entitetsegenskaper för positionerare

Skapa en positionerare

Exempelförfrågan

Lista lokaliserare

Exempelförfrågan

Uppdatera en positionerare

Exempelförfrågan

Ta bort en positionerare

Exempelförfrågan

Se även

Ytterligare resurser