Dela via

Tillgång

  • Artikel

Entiteten Asset innehåller digitala filer (inklusive video, ljud, bilder, miniatyrsamlingar, textspår och stängda bildtext filer) och metadata om dessa filer. När de digitala filerna har laddats upp till en tillgång kan de användas i Media Services-kodnings- och strömningsarbetsflöden.

När du kodar en tillgång skapas en utdatatillgång när kodningsjobbet har slutförts. Bland de filer som nämns ovan innehåller utdatatillgången XML-metadatafiler som beskriver indatatillgången och utdatatillgången. Mer information finns i artiklarna Indatametadata och Utdatametadata .

Följande egenskaper gäller för en tillgång i Media Services:

  • En tillgång är en logisk enhet som representerar en enda audiovisuell presentation.

  • En tillgång innehåller en samling av en till många mediefiler.

  • Filerna för en tillgång finns i en enda bloblagringscontainer.

Några exempel på en tillgång är: en fullständig film, ETT TV-program, specifik redigering; ett klipp från en film, ett TV-program, en animering, en ISO-kamerafil eller en händelse; en filmtrailer eller reklamvideo; en annons. en ljudfil, ett radioprogram, en podcast eller en ljudfil.

Följande egenskaper gäller INTE för en tillgång i Media Services:

  • Helt enkelt en lagringscontainer

  • En mapp för att organisera och lagra flera versioner av samma presentation i

  • En mapp för att skicka batchbearbetning av flera audiovisuella presentationer till Azure Media Encoder

Du får till exempel inte lagra en film, dess trailer, en annons och en internationell redigeringsversion av samma film i en enda tillgång.

Det här avsnittet ger en översikt över entiteten Asset 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 tillgångsentitet

Egenskap Typ Description
Id

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Sträng Unik identifierare.
State

Skrivskyddad. Anges av Media Services.		 Edm.Int32 Ett uppräkningsvärde som beskriver tillgångens tillstånd. Värdevärden är:

- Initierad = 0
- Publicerad = 1 Varning: Åtgärden Publish är inaktuell. Ta bort koden som kontrollerar om en tillgång är i Published tillståndet .
- Borttaget = 2

En tillgång är alltid i initierat tillstånd tills den tas bort.
Created

Skrivskyddad. Anges av Media Services vid skapandetillfället.		 Edm.DateTime Det här värdet anges av Media Services när det skapas.
LastModified

Skrivskyddad. Anges av Media Services.		 Edm.DateTime Det här värdet uppdateras av Media Services när eventuella egenskapsändringar har gjorts.
AlternateId

Valfritt.		 Edm.String Ett alternativt ID-värde som motsvarar ett ID i ett annat innehållshanteringssystem. Maxlängden är 4 000.
Name

Valfritt.		 Edm.String Eget namn för din tillgång. Maxlängden är 512.
Options

Krävs. Det går inte att uppdatera entiteten efter att den har skapats.		 Edm.Int32 Ett uppräkningsvärde som beskriver de krypteringsalternativ som en tillgång kan skapas med. Ett giltigt värde är ett värde i listan nedan, inte en kombination av värden från den här listan:

- Ingen = 0: Anger inga alternativ för att skapa tillgångar.
- StorageEncrypted = 1: Anger att en tillgångs filer ska krypteras för uppladdning och lagring när du skapar tillgången.
- CommonEncryptionProtected = 2: Anger att en tillgångs filer skyddas med hjälp av en vanlig krypteringsmetod (till exempel PlayReady).
- EnvelopeEncryptionProtected = 4
Uri

Skrivskyddad. Anges av Media Services.		 Edm.String URI:n för bloblagringscontainern för den angivna tillgången.
Locators

Skrivskyddad. Anges av Media Services.		 Entitetsuppsättning för positionerare Den returnerade entitetsuppsättningen innehåller alla positionerarentiteter som är länkade till den angivna tillgången.
ContentKeys

Valfritt.		 ContentKey-entitetsuppsättning Den returnerade entitetsuppsättningen innehåller alla ContentKey-entiteter som är länkade till den angivna tillgången.
Files

Skrivskyddad. Anges av Media Services.		 Filentitetsuppsättning Den returnerade entitetsuppsättningen innehåller alla filentiteter som är länkade till den angivna tillgången.
ParentAssets

Valfritt.		 Entitetsuppsättning för överordnade tillgångar Den returnerade entitetsuppsättningen innehåller alla överordnade tillgångsentiteter som är länkade till den angivna tillgången.
StorageAccountName

Valfritt. Det går inte att uppdatera entiteten efter att den har skapats.		 Edm.String Namnet på lagringskontot som innehåller tillgångens blobcontainer.

Om det inte anges vid skapandetillfället anger Media Services standardnamnet för lagringskontot.
StorageAccount

Skrivskyddad. Anges av Media Services.		 StorageAccount-entitetsuppsättning Den returnerade entitetsuppsättningen innehåller alla StorageAccount-entiteter som är länkade till den angivna tillgången.
DeliveryPolicies Entitetsuppsättning för AssetDeliveryPolicy Den returnerade entitetsuppsättningen innehåller leveransprinciper som är associerade med tillgången.
FormatOption Edm.Int32 Anger olika formatalternativ som en tillgång kan skapas med. Tillåtna värden är: 0 (standard) – anger inget alternativ för tillgångsformat; 1 – anger att en tillgångs format är AdaptiveStreaming.

Skapa en tillgång

Tillgångar kan skapas med hjälp av en POST HTTP-begäran och anger egenskapsvärden.

Metod URI för förfrågan HTTP-version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i 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" }

Visa en lista över en tillgång

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

Uppdatera en tillgång

Tillgångar kan uppdateras med en MERGE HTTP-begäran och de specifika egenskaper som du vill ändra.

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

Ta bort en tillgång

Tillgångar kan tas bort genom att referera till tillgångs-ID-värdet. När en tillgång tas bort tas alla dess lokaliserare bort av Microsoft Azure Media Services. Om tillgången hade ursprungslokaliserare återkallas och tas även dessa lokaliserare bort. Alla länkar till ContentKeys tas bort och alla ContentKeys som inte är länkade till andra tillgångar tas bort.

Metod URI för förfrågan HTTP-version
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i 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

Publicera en tillgång

Anteckning

Åtgärden Publish är inaktuell. Från och med den senaste Media Services-versionen Publish bör inte användas.

Om koden använder Publishbör du vara medveten om följande:

  1. Åtgärden Publish tar inte bort lokaliserare som är associerade med tillgången. Du måste uttryckligen ta bort lokaliserarna i koden efter att du har anropat Publish.
  2. Åtgärden Publish anger inte tillgångstillståndet till Published. Ta bort koden som kontrollerar om en tillgång är i Published tillståndet . För närvarande kan en tillgång bara ha Initialized tillståndet eller Deleted .

Länka innehållsnycklar till tillgångar

Du kan länka en ContentKey till en tillgång genom att referera till tillgångs-ID:t med en HTTP POST-begäran. Innehållsnyckelns URI måste ingå i brödtexten i begäran. Du kan bara länka en ContentKey-typ som matchar den typ som anges i tillgångens CreationOptions. Om tillgången till exempel har alternativ som StorageEncrypted(1) måste ContentKey vara av typen StorageEncryption(1).

Metod URI för förfrågan HTTP-version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Tillgångs-ID')/$links/ContentKeys HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i 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')"}

Du kan ta bort ContentKey-länkar från en tillgång genom att referera till tillgångs-ID:t och ContentKey-ID:t i en HTTP DELETE-begäran. Om ContentKey inte är länkad till andra tillgångar tas den bort.

Metod URI för förfrågan HTTP-version
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i 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

Se även

AccessPolicy
ContentKey
AssetFile
Jobb
JobTemplate
Locator
MediaProcessor
Uppgift
TaskTemplate
Mata in tillgångar med Media Services REST API
Kvoter och begränsningar