Freigeben über

Locator

  • Artikel

Ein Locator stellt einen Einstiegspunkt für den Zugriff auf die in einem Medienobjekt enthaltenen Dateien zur Verfügung. Eine AccessPolicy wird zum Definieren der Berechtigungen und der Dauer des Zugriffs auf ein bestimmtes Medienobjekt durch einen Client verwendet. Locator können eine n:1-Beziehung mit einer AccessPolicy aufweisen, wobei verschiedene Locator verschiedene Startzeiten und Verbindungstypen mit verschiedenen Clients bereitstellen können, die alle die gleichen Berechtigungs- und Zugriffsdauereinstellungen verwenden. Aufgrund einer gemeinsamen Einschränkung der Zugriffsrichtlinie, die von den Azure Storage Services festgelegt wird, können jedoch nur maximal fünf eindeutige Locator einem bestimmten Medienobjekt gleichzeitig zugeordnet werden. Weitere Informationen finden Sie unter Using a Shared Access Signature (REST API).

Häufig müssen Sie einen Locator-URI transformieren, um auf verschiedene Dateiformate zugreifen zu können. Die Eigenschaft Path des SAS-Locators erteilt z. B. den Zugriff auf den Container. Damit Sie auf Dateien zugreifen können, müssen Sie den Dateinamen zwischen dem Host und der SAS-Signatur einbetten. Beim Arbeiten mit OnDemandOrigin-Locators ist die Path Eigenschaft erst nützlich, wenn ihr ein protokollspezifischer Teil hinzugefügt wird.

Die folgenden Regeln steuern, wann ein Locator erstellt oder aktualisiert werden kann:

  1. SAS URL-Locator (Shared Access Signature), die mit AccessPolicies verwendet werden, die Leseberechtigungen definieren, sowie Ursprungslocator können erst nach Hochladen der Dateien zu einem Medienobjekt erstellt werden. SAS URL-Locator (Shared Access Signature), die zum Herunter- oder Hochladen von Dateien verwendet werden, können nur dann vor dem Hochladen der Dateien erstellt werden, wenn sie mit AccessPolicies verwendet werden, die Schreibberechtigungen angeben.

  2. Ein SAS URL-Locator kann nach seiner Erstellung nicht aktualisiert werden. Andere Locatortypen (z. B. Ursprungslocator) können jedoch mit neuen StartTime-Werten aktualisiert werden.

  3. Die URLs der SAS-Locators ändern sich jedes Mal, wenn Speicherschlüssel des zugeordneten Speicherkontos aktualisiert werden. Weitere Informationen finden Sie unter Vorgehensweise: Aktualisieren von Media Services nach rollierenden Speicherzugriffsschlüsseln.

  4. Gegebenenfalls tritt eine Verzögerung von 30 bis 40 Sekunden zwischen dem Erstellen eines Locators und seiner Verfügbarkeit auf. Dies gilt für SAS URL- sowie für OnDemandOrigin-Locator.

Hinweis

Locator sind nicht für die Verwaltung der Zugriffssteuerung pro Benutzer konzipiert. Um einzelnen Benutzern verschiedene Zugriffsrechte zu erteilen, verwenden Sie Lösungen zur Verwaltung digitaler Rechte (Digital Rights Management, DRM).

Dieser Artikel bietet eine Übersicht über die Locator Entität und veranschaulicht außerdem, wie verschiedene Vorgänge mit der Media Services-REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

Locator-Entitätseigenschaften

Eigenschaft type BESCHREIBUNG
Id

Optional. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.String Eindeutiger Bezeichner, der von Media Services festgelegt wurde.
Name

Optional.		 Edm.String Der Name des Locators. Die maximale Länge beträgt 4000.
ExpirationDateTime

Nur Schreibzugriff. Verwenden Sie eine MERGE HTTP-Anforderung, um den ExpirationDateTime-Wert zu aktualisieren.		 Edm.DateTime Der Wert (dargestellt in Millisekunden seit dem 1. Januar 1970, 0:00 Uhr), ab dem der Locator nicht mehr für den Zugriff auf das angegebene Medienobjekt verwendet werden kann.

Das ExpirationDateTime-Format muss im folgenden DateTime-Format vorliegen: YYYY-MM-DDTHH:mm:ssZ (z. B. "2014-05-23T17:53:50Z").
Type

Erforderlich. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.Int32 Ein Enumerationswert, der den Typ des Locators beschreibt. Gültige Werte sind:

- None = 0: Dies ist der Standardaufzählungswert. Kein gültiger Locator weist diesen Typ auf.
- SAS = 1: Gibt den Sas-Locatortyp (Shared Access Signature) an
- OnDemandOrigin = 2: Gibt einen Locatortyp an, der auf einen Azure Media Service On-Demand Origin-Streamingendpunkt verweist
Path

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Eine URL, die für den Zugriff auf Medienobjektdateien verwendet wird.
BaseUri

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Der Teil des Locators, der die Speicher-/Dienst-/Containerinformationen zum Medienobjekt bereitstellt (z. B. DNS-Hostname http://someservice.cloudapp.net)
ContentAccessComponent

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Der Teil des URIs, der für den Zugriff auf den Inhalt erforderlich ist. Der Speicherort dieses Tokens in der endgültigen Medien-URL hängt vom Locatortyp, dem Medientyp und dem Streamingdienst ab.
AccessPolicyId

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Die ID der AccessPolicy, die die Berechtigungen und die Dauer für die Locator-URL definiert.

Die List-Berechtigung sollte beim Erstellen von OnDemandOrigin-Locators nicht verwendet werden.
AssetId

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Die ID des Medienobjekts, das den Inhalt enthält, auf den Sie Zugriff gewähren möchten.
StartTime

Optional.		 Edm.DateTime Das Datum und die Uhrzeit der Verfügbarkeit Ihres Locators für die Verwendung durch Clients. Tipp: Wenn Sie Ihre Dateien sofort hochladen müssen, sollten Sie Ihren StartTime-Wert auf fünf Minuten vor der aktuellen Zeit festlegen. Dies ist erforderlich, weil ggf. eine Uhrzeitabweichung zwischen dem Clientcomputer und Media Services vorliegen kann. Außerdem muss ihr StartTime-Wert das folgende DateTime-Format aufweisen: YYYY-MM-DDTHH:mm:ssZ (z. B. "2014-05-23T17:53:50Z").
AssetPolicy

Schreibgeschützt. Wird von Media Services festgelegt.		 AssetPolicy-Entitätenmenge Eine Navigationseigenschaft für den Zugriff auf eine AccessPolicy-Instanz.
Asset

Schreibgeschützt. Wird von Media Services festgelegt.		 Asset-Entitätenmenge Eine Navigationseigenschaft für den Zugriff auf eine Asset-Instanz.

Erstellen eines Locators

Locator können mit einer POST HTTP-Anforderung erstellt werden.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Hinweis

Die URLs von SAS-Locators ändern sich jedes Mal, wenn Speicherschlüssel des zugeordneten Speicherkontos aktualisiert werden. Weitere Informationen finden Sie unter Vorgehensweise: Aktualisieren von Media Services nach rollierenden Speicherzugriffsschlüsseln.

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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}

Weitere Informationen finden Sie unter Bereitstellen von Ressourcen mit der Media Services-REST-API.

Auflisten von Locatorobjekten

Locator können mithilfe einer GET HTTP-Anforderung abgerufen werden.

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

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Aktualisieren eines Locators

Ursprungslocator können mithilfe einer MERGE HTTP-Anforderung aktualisiert werden.

Methode Anforderungs-URI HTTP-Version
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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"}

Löschen eines Locators

Locator können mithilfe einer DELETE HTTP-Anforderung gelöscht werden.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Weitere Informationen

Bereitstellen von Medienobjekten mit der Media Services REST-API
ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Job
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen