Freigeben über

Asset

  • Artikel

Die Asset-Entität enthält digitale Dateien (z. B. Video, Audio, Bilder, Miniaturansichtsammlungen, Texttitel und geschlossene Untertiteldateien) sowie die Metadaten zu diesen Dateien. Nachdem die digitalen Dateien in ein Medienobjekt geladen wurden, können Sie in den Codierungs- und Streaming-Workflows der Media Services verwendet werden.

Wenn Sie ein Medienobjekt codieren, wird bei Abschluss des Codierungsauftrags ein Ausgabemedienobjekt erstellt. Unter den oben genannten Dateien enthält das Ausgabeobjekt XML-Metadatendateien, die das Eingabeobjekt und das Ausgabeobjekt beschreiben. Weitere Informationen finden Sie in den Artikeln Eingeben von Metadaten und Ausgeben von Metadaten.

Die folgenden Merkmale gelten für ein Medienobjekt in Media Services:

  • Ein Medienobjekt ist eine logische Einheit, die eine einzelne audiovisuelle Darstellung darstellt.

  • Ein Medienobjekt enthält eine Auflistung mit mindestens einer Mediendatei.

  • Die Dateien eines Medienobjekts befinden sich in einem BLOB-Speichercontainer.

Einige Beispiele für ein Asset sind: ein vollständiger Film, eine TV-Show, eine bestimmte Bearbeitung; ein Clip aus einem Film, einer Fernsehsendung, einer Animation, einer KAMERA-ISO-Datei oder einem Ereignis; einen Filmtrailer oder Werbevideo; eine Werbung; Eine Audiodatei, eine Radiosendung, einen Podcast oder eine Sounddatei.

Die folgenden Merkmale gelten NICHT für ein Medienobjekt in Media Services:

  • Es handelt sich einfach um einen Speichercontainer.

  • Es handelt sich um einen Ordner zum Organisieren und Speichern mehrerer Versionen der gleichen Darstellung.

  • Es handelt sich um einen Ordner zum Übermitteln der Batchverarbeitung mehrerer audiovisueller Darstellungen an Azure Media Encoder.

Sie dürfen z. B. nicht einen Film, seinen Trailer, einen Werbeclip und eine internationale bearbeitete Version des gleichen Films in einem einzigen Medienobjekt speichern.

Dieses Thema enthält eine Übersicht über die Entität Asset. Darüber hinaus wird gezeigt, wie unterschiedliche 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.

Asset-Entitätseigenschaften

Eigenschaft type BESCHREIBUNG
Id

Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.		 String Eindeutiger Bezeichner.
State

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.Int32 Ein Enumerationswert, der den Status des Medienobjekts beschreibt. Gültige Werte sind:

- Initialisiert = 0
- Veröffentlicht = 1 Warnung: Die Publish Aktion wurde veraltet. Entfernen Sie den Code, der überprüft, ob ein Medienobjekt den Status Published aufweist.
- Gelöscht = 2

Ein Medienobjekt weist immer den Status Initialized auf, bis es gelöscht wird.
Created

Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services zur Erstellungszeit festgelegt.
LastModified

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftenänderungen vorgenommen wurden.
AlternateId

Optional.		 Edm.String Ein alternativer ID-Wert, der einer ID in einem anderen CMS (Content Management System) entspricht. Die maximale Länge beträgt 4000.
Name

Optional.		 Edm.String Der Anzeigename für Ihr Medienobjekt. Die maximale Länge beträgt 512.
Options

Erforderlich. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.Int32 Ein Enumerationswert, der die Verschlüsselungsoptionen beschreibt, mit denen ein Medienobjekt erstellt werden kann. Gültig ist jeweils ein Wert aus der Liste unten, nicht eine Kombination von Werten aus dieser Liste:

- None = 0: Gibt keine Optionen zum Erstellen von Ressourcen an.
- StorageEncrypted = 1: Gibt an, dass die Dateien eines Medienobjekts beim Erstellen des Medienobjekts zum Hochladen und Speichern verschlüsselt werden sollen.
- CommonEncryptionProtected = 2: Gibt an, dass die Dateien eines Medienobjekts mit einer gängigen Verschlüsselungsmethode (z. B. PlayReady) geschützt werden.
- EnvelopeEncryptionProtected = 4
Uri

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.String Der URI des Blobspeichercontainers des angegebenen Medienobjekts.
Locators

Schreibgeschützt. Wird von Media Services festgelegt.		 Die Locator-Entitätenmenge. Die zurückgegebene Entitätenmenge enthält alle Locator-Entitäten, die mit dem angegebenen Objekt verknüpft sind.
ContentKeys

Optional.		 Die ContentKey-Entitätenmenge. Die zurückgegebene Entitätenmenge enthält alle ContentKey-Entitäten, die mit dem angegebenen Medienobjekt verknüpft sind.
Files

Schreibgeschützt. Wird von Media Services festgelegt.		 Die File-Entitätenmenge. Die zurückgegebene Entitätenmenge enthält alle File-Entitäten, die mit dem angegebenen Medienobjekt verknüpft sind.
ParentAssets

Optional.		 Die übergeordnete Assets-Entitätenmenge. Die zurückgegebene Entitätenmenge enthält alle übergeordneten Asset-Entitäten, die mit dem angegebenen Medienobjekt verknüpft sind.
StorageAccountName

Optional. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.String Der Name des Speicherkontos, das den BLOB-Container des Medienobjekts enthält.

Falls zur Erstellungszeit nicht angegeben, legt Media Services den Standardnamen des Speicherkontos fest.
StorageAccount

Schreibgeschützt. Wird von Media Services festgelegt.		 StorageAccount-Entitätssatz Die zurückgegebene Entitätenmenge aller StorageAccount-Entitäten, die mit dem angegebenen Medienobjekt verknüpft sind.
DeliveryPolicies AssetDeliveryPolicy-Entitätsgruppe Die zurückgegebene Entitätenmenge enthält mit dem Medienobjekt verknüpfte Übermittlungsrichtlinien.
FormatOption Edm.Int32 Gibt verschiedene Formatoptionen an, mit denen ein Objekt erstellt werden kann. Zulässige Werte sind: 0 (Standard) – gibt keine Ressourcenformatoption an. 1 : Gibt an, dass das Format eines Medienobjekts AdaptiveStreaming ist.

Erstellen eines Medienobjekts

Medienobjekte können mithilfe einer POST HTTP-Anforderung und durch Angeben von Eigenschaftenwerten erstellt werden.

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

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/Assets 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: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }

Auflisten eines Medienobjekts

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

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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

Aktualisieren eines Medienobjekts

Medienobjekte können mithilfe einer MERGE HTTP-Anforderung und durch Angeben von bestimmten zu ändernden Eigenschaften aktualisiert werden.

Methode Anforderungs-URI HTTP-Version
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') 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: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }

Löschen eines Medienobjekts

Medienobjekte können durch einen Verweis auf den Wert der Medienobjekt-ID gelöscht werden. Wenn ein Objekt gelöscht wird, werden alle zugehörigen Locators von Microsoft Azure Media Services gelöscht. Wenn das Objekt Ursprungslocatoren hatte, werden auch diese Locators widerrufen und gelöscht. Alle Links zu ContentKeys werden gelöscht, und es werden alle ContentKeys gelöscht, die nicht mit anderen Medienobjekten verknüpft sind.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') 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/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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

Veröffentlichen eines Medienobjekts

Hinweis

Die Publish-Aktion ist veraltet. Ab dem neuesten Media Services-Release Publish sollte nicht mehr verwendet werden.

Bedenken Sie Folgendes, wenn Ihr Code Publish verwendet:

  1. Die Publish-Aktion löscht keine Locator, die dem Medienobjekt zugeordnet sind. Sie müssen die Locator im Code nach dem Aufrufen von Publish ausdrücklich löschen.
  2. Die Publish-Aktion legt den Medienobjektstatus nicht auf Published fest. Entfernen Sie den Code, der überprüft, ob ein Medienobjekt den Status Published aufweist. Zurzeit kann ein Medienobjekt nur den Status Initialized oder Deleted aufweisen.

Verknüpfen von Inhaltsschlüsseln mit Medienobjekten

Sie können einen ContentKey mit einem Asset verknüpfen, indem Sie auf die Ressourcen-ID mit einer HTTP POST-Anforderung verweisen. Der URI des ContentKey-Objekts muss im Text der Anforderung enthalten sein. Sie können nur einen ContentKey-Typ verknüpfen, der mit dem Typ übereinstimmt, der in den CreationOptions des Medienobjekts angegeben wurde. Wenn die Optionen für das Medienobjekt z. B. auf StorageEncrypted(1) festgelegt sind, muss der ContentKey vom Typ StorageEncryption(1) sein.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset ID')/$links/ContentKeys HTTP/1.1

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/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys 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: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

Sie können ContentKey-Links aus einem Objekt entfernen, indem Sie auf die Ressourcen-ID und die ContentKey-ID in einer HTTP DELETE-Anforderung verweisen. Wenn der ContentKey nicht mit weiteren Medienobjekten verknüpft ist, wird er gelöscht.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset ID')/$links/ContentKeys('ContentKey ID') 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/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') 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

Weitere Informationen

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