Locator
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:
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.
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.
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
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