Dela via

AssetFile

  • Artikel

Entiteten AssetFile representerar en faktisk video- eller ljudfil som lagras i en blobcontainer. En tillgångsfil är alltid associerad med en tillgång och en tillgång kan innehålla en eller flera filer. Media Services-kodaraktiviteten misslyckas om ett tillgångsfilobjekt inte är associerat med en digital fil i en blobcontainer.

Det här avsnittet ger en översikt över entiteten AssetFile 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).

Egenskaper för AssetFile-entitet

Egenskap Typ Description
Id

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Edm.String Unik identifierare.
Name

Krävs.		 Edm.String Eget namn för din AssetFile. Standardvärdet är det filnamn som du använde under filuppladdningen. Maxlängden är 260. Observera: Media Services använder värdet Name för egenskapen när url:er skapas för strömmande innehåll (till exempel http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Därför tillåts inte procentkodning. Värdet för egenskapen Namn får inte innehålla något av följande procentkodningsreserverade tecken: !*'();:@&=+$,/?%#[]". Dessutom kan det bara finnas ett "." för filnamnstillägget.
ContentFileSize

Valfritt.		 Edm.Int64 AssetFile-storlek (i byte) för innehållet.
ParentAssetId

Krävs. Det går inte att uppdatera entiteten efter att den har skapats.		 Edm.String Tillgångs-ID för den tillgång som den här filen är associerad med.
EncryptionVersion

Valfritt.		 Edm.String Aktuell version som stöds för både StorageEncryption och CommonEncryption är "1.0"
EncryptionScheme

Valfritt.		 Edm.String Krypteringsschemat som används för den här filen. Giltiga värden är: "StorageEncryption" eller "CommonEncryption".
IsEncrypted

Valfritt.		 Edm.Boolean Det här värdet ska anges till true om den här filen lagras krypterad.
EncryptionKeyId

Valfritt.		 Edm.String Krypterat ContentKey-ID.
InitializationVector

Valfritt.		 Edm.String Initieringsvektorn som används för lagringskryptering.
IsPrimary

Valfritt.		 Edm.Boolean Avgör om den här filen är den primära filen i en tillgång med flera filer.
LastModified

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Edm.DateTime Det här värdet uppdateras av Media Services när eventuella egenskapsändringar har gjorts. Den representerar antalet millisekunder sedan midnatt den 1 januari 1970.
Created

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Edm.DateTime Representerar antalet millisekunder sedan midnatt den 1 januari 1970.
MimeType

Valfritt.		 Edm.String Media Services inspekterar inte någon blob som du har laddat upp, så du måste ange mime-typen manuellt. Till exempel är "text/plain" eller "video/x-ms-wmv" giltiga värden att använda. Maxlängden är 4 000.
ContentChecksum

Valfritt.		 Edm.String Ett hexadecimalt tal som representerar ett sammandragsvärde för ett MD5-meddelande (RFC 1321). Det här värdet anges av klienten eller klientbiblioteket för att fungera som en validering av den lyckade uppladdningen av innehållet. Maxlängden är 4 000.

Skapa en AssetFile

Funktionen CreateFileInfos används för att skapa en ny AssetFile-entitet. Mer information finns i REST API Functions.

Visa lista med tillgångsfiler

AssetFiles hämtas med hjälp av en GET HTTP-begäran.

Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files 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/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

Uppdatera en AssetFile

AssetFiles uppdateras med HTTP-begäran MERGE.

Metod URI för förfrågan HTTP-version
SAMMANFOGA <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') 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/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" }

Ta bort en tillgångsfil

AssetFiles tas bort när deras associerade tillgång har tagits bort. Ett exempel finns i Ta bort en tillgång.

Se även

ContentKey
Tillgång
AccessPolicy
Jobb
JobTemplate
Locator
MediaProcessor
Uppgift
TaskTemplate
Kvoter och begränsningar