Freigeben über

AssetFile

  • Artikel

Die AssetFile-Entität stellt eine tatsächliche Video- oder Audiodatei dar, die in einem BLOB-Container gespeichert wird. Eine Medienobjektdatei ist immer mit einem Medienobjekt verknüpft, wobei ein Medienobjekt eine oder mehrere Dateien enthalten kann. Der Media Services Encoder-Task kann nicht ausgeführt werden, wenn ein Medienobjektdatei-Objekt keiner digitalen Datei in einem Blobcontainer zugeordnet ist.

Dieses Thema enthält eine Übersicht über die Entität AssetFile. 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.

AssetFile-Entitätseigenschaften

Eigenschaft Typ BESCHREIBUNG
Id

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.String Eindeutiger Bezeichner.
Name

Erforderlich.		 Edm.String Der Anzeigename für AssetFile. Der Standardwert ist der Dateiname, den Sie beim Dateiupload verwendet haben. Die maximale Länge beträgt 260. Hinweis: Media Services verwendet den Wert der Name -Eigenschaft beim Erstellen von URLs für den Streaminginhalt (z. B. http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Aus diesem Grund ist die Prozentcodierung nicht zulässig. Der Wert der „Name“-Eigenschaft darf keines der folgenden für die Prozentcodierung reservierten Zeichen enthalten: !*'();:@&=+$,/?%#[]". Darüber hinaus darf „.“ nur einmal für die Dateinamenerweiterung vorhanden sein.
ContentFileSize

Optional.		 Edm.Int64 Die AssetFile-Größe (in Bytes) des Inhalts.
ParentAssetId

Erforderlich. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.String Die Medienobjekt-ID, der diese Datei zugeordnet ist.
EncryptionVersion

Optional.		 Edm.String Die aktuelle unterstützte Version für StorageEncryption und CommonEncryption ist "1.0".
EncryptionScheme

Optional.		 Edm.String Das für diese Datei verwendete Verschlüsselungsschema. Die gültigen Werte sind: "StorageEncryption" oder "CommonEncryption".
IsEncrypted

Optional.		 Edm.Boolean Dieser Wert sollte auf true festgelegt sein, wenn diese Datei verschlüsselt gespeichert wird.
EncryptionKeyId

Optional.		 Edm.String Die verschlüsselte ContentKey-ID.
InitializationVector

Optional.		 Edm.String Der Initialisierungsvektor, der für Speicherverschlüsselung verwendet wird.
IsPrimary

Optional.		 Edm.Boolean Bestimmt, ob diese Datei die primäre Datei in einem Medienobjekt mit mehreren Dateien ist.
LastModified

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftsänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
Created

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.DateTime Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
MimeType

Optional.		 Edm.String Media Services untersucht keine von Ihnen hochgeladenen Blobs. Aus diesem Grund müssen Sie den MIME-Typ manuell festlegen. "text/plain" und "video/x-ms-wmv" sind z. B. gültige Werte, die verwendet werden können. Die maximale Länge beträgt 4000.
ContentChecksum

Optional.		 Edm.String Eine hexadezimale Zahl, die einen MD5-Nachrichtenhashwert (RFC 1321) darstellt. Dieser Wert wird vom Client oder von der Clientbibliothek als Bestätigung des erfolgreichen Uploads des Inhalts festgelegt. Die maximale Länge beträgt 4000.

Erstellen einer AssetFile

Die Funktion CreateFileInfos wird zum Erstellen einer neuen AssetFile-Entität verwendet. Weitere Informationen finden Sie unter REST-API-Funktionen.

Auflisten von "AssetFiles"

AssetFiles werden mithilfe einer GET HTTP-Anforderung abgerufen.

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files 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/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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 AssetFile-Objekts

AssetFiles werden mithilfe einer MERGE HTTP-Anforderung aktualisiert.

Methode Anforderungs-URI HTTP-Version
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') 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/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Löschen eines AssetFile-Objekts

AssetFiles werden gelöscht, nachdem ihr zugehöriges Medienobjekt gelöscht wurde. Ein Beispiel finden Sie unter Löschen eines Medienobjekts.

Weitere Informationen

ContentKey
Asset
AccessPolicy
Job
JobTemplate
Locator
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen