Dela via

Locator

  • Artikel

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:

  1. 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.

  2. 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.

  3. 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)

  4. 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