Delen via

AssetFile

  • Artikel

De AssetFile entiteit vertegenwoordigt een video- of audiobestand dat is opgeslagen in een blobcontainer. Een assetbestand is altijd gekoppeld aan een asset en een asset kan een of meer bestanden bevatten. De taak Media Services Encoder mislukt als een object voor een assetbestand niet is gekoppeld aan een digitaal bestand in een blobcontainer.

Dit onderwerp geeft een overzicht van de AssetFile 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 Connecting 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 AssetFile-entiteit

Eigenschap Type Description
Id

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Edm.String Unieke id.
Name

Vereist.		 Edm.String Beschrijvende naam voor uw AssetFile. De standaardwaarde is de bestandsnaam die u hebt gebruikt tijdens het uploaden van het bestand. De maximale lengte is 260. Opmerking: Media Services gebruikt de waarde van de eigenschap bij het Name bouwen van URL's voor de streaming-inhoud (bijvoorbeeld http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Daarom is procentcodering niet toegestaan. De waarde van de eigenschap Naam mag geen van de volgende procent-encoding-gereserveerde tekens hebben: !*'();:@&=+$,/?%#[]". Bovendien kan er maar één zijn. voor de bestandsnaamextensie.
ContentFileSize

Optioneel.		 Edm.Int64 AssetFile-grootte (in bytes) van de inhoud.
ParentAssetId

Vereist. Kan niet worden bijgewerkt nadat de entiteit is gemaakt.		 Edm.String Asset-id van de asset waaraan dit bestand is gekoppeld.
EncryptionVersion

Optioneel.		 Edm.String Huidige ondersteunde versie voor zowel StorageEncryption als CommonEncryption is '1.0'
EncryptionScheme

Optioneel.		 Edm.String Het versleutelingsschema dat voor dit bestand wordt gebruikt. De geldige waarden zijn: 'StorageEncryption' of 'CommonEncryption'.
IsEncrypted

Optioneel.		 Edm.Boolean Deze waarde moet worden ingesteld op true als dit bestand versleuteld is opgeslagen.
EncryptionKeyId

Optioneel.		 Edm.String Versleutelde ContentKey-id.
InitializationVector

Optioneel.		 Edm.String De initialisatievector die wordt gebruikt voor opslagversleuteling.
IsPrimary

Optioneel.		 Edm.Boolean Bepaalt of dit bestand het primaire bestand in een asset met meerdere bestanden is.
LastModified

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Edm.DateTime Deze waarde wordt bijgewerkt door Media Services nadat eventuele eigenschapswijzigingen zijn aangebracht. Het vertegenwoordigt het aantal milliseconden sinds middernacht 1 januari 1970.
Created

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Edm.DateTime Vertegenwoordigt het aantal milliseconden sinds middernacht 1 januari 1970.
MimeType

Optioneel.		 Edm.String Media Services inspecteert geen blob die u hebt geüpload, dus u moet het mime-type handmatig instellen. 'text/plain' of 'video/x-ms-wmv' zijn bijvoorbeeld geldige waarden om te gebruiken. De maximale lengte is 4000.
ContentChecksum

Optioneel.		 Edm.String Een hexadecimaal getal dat een MD5-berichtsamenvattingswaarde (RFC 1321) vertegenwoordigt. Deze waarde wordt door de client of clientbibliotheek ingesteld als validatie van het succesvol uploaden van de inhoud. De maximale lengte is 4000.

Een AssetFile maken

De functie CreateFileInfos wordt gebruikt om een nieuwe AssetFile-entiteit te maken. Zie REST API-functies voor meer informatie.

AssetFiles weergeven

AssetFiles worden opgehaald met behulp van een GET HTTP-aanvraag.

Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

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

Een AssetFile bijwerken

AssetFiles worden bijgewerkt met behulp van de HTTP-aanvraag SAMENVOEGEN.

Methode Aanvraag-URI HTTP-versie
SAMENVOEGEN <https:// accountnaam.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

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" }

Een AssetFile verwijderen

AssetFiles worden verwijderd wanneer de bijbehorende asset is verwijderd. Zie Een asset verwijderen voor een voorbeeld.

Zie ook

ContentKey
Asset
AccessPolicy
Taak
JobTemplate
Locator
MediaProcessor
Taak
TaskTemplate
Quota en beperkingen