Prostředek

Článek
08/05/2023

Entita Asset obsahuje digitální soubory (včetně videa, zvuku, obrázků, kolekcí miniatur, textových stop a uzavřených popis souborů) a metadata o těchto souborech. Po nahrání digitálních souborů do prostředku je možné je použít v pracovních postupech kódování a streamování služby Media Services.

Při kódování prostředku se po dokončení úlohy kódování vytvoří výstupní prostředek. Mezi výše uvedenými soubory obsahuje výstupní asset soubory metadat XML, které popisují vstupní a výstupní prostředek. Další informace najdete v článcích o vstupních a výstupních metadatech .

Následující vlastnosti platí pro prostředek ve službě Media Services:

Asset je logická jednotka, která představuje jednu audiovizuální prezentaci.
Prostředek obsahuje kolekci jednoho až mnoha multimediálních souborů.
Soubory prostředku se nacházejí v jednom kontejneru úložiště objektů blob.

Mezi příklady prostředku patří: celý film, televizní pořad, konkrétní úpravy; klip z filmu, televizního pořadu, animace, souboru ISO kamery nebo události; filmovou upoutávku nebo propagační video; reklamu; zvukový soubor, rozhlasovou show, podcast nebo zvukový soubor.

Následující vlastnosti SE NEVZTAHUJÍ na prostředek ve službě Media Services:

Jednoduše kontejner úložiště
Složka pro uspořádání a uložení více verzí stejné prezentace v
Složka pro odesílání dávkového zpracování více audiovizuálních prezentací do Azure Media Encoderu

Nesmíte například ukládat film, jeho upoutávku, reklamu a mezinárodní verzi stejného filmu v jednom assetu.

Toto téma poskytuje přehled Asset entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitě ve službě Media Services musíte v požadavcích HTTP nastavit konkrétní pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Vlastnosti entity majetku

Vlastnost	Typ	Description
`Id` Jen pro čtení. Nastavení službou Media Services při vytváření.	Řetězec	Jedinečný identifikátor.
`State` Jen pro čtení. Nastaveno službou Media Services.	Edm.Int32	Hodnota výčtu, která popisuje stav aktiva. Hodnoty jsou: - Inicializováno = 0 - Publikováno = 1 Upozornění: Akce `Publish` je zastaralá. Odeberte kód, který kontroluje, jestli je prostředek ve `Published` stavu. - Odstraněno = 2 Prostředek je vždy v inicializovaném stavu, dokud není odstraněn.
`Created` Jen pro čtení. Nastavení službou Media Services při vytváření.	Edm.DateTime	Tato hodnota je nastavena službou Media Services při vytváření.
`LastModified` Jen pro čtení. Nastaveno službou Media Services.	Edm.DateTime	Tato hodnota je aktualizována službou Media Services po provedení jakýchkoli změn vlastností.
`AlternateId` Nepovinný parametr.	Edm.String	Alternativní hodnota ID, která odpovídá ID v jiném systému pro správu obsahu. Maximální délka je 4000.
`Name` Nepovinný parametr.	Edm.String	Popisný název vašeho prostředku Maximální délka je 512.
`Options` Povinná hodnota. Po vytvoření entity nelze aktualizovat.	Edm.Int32	Hodnota výčtu, která popisuje možnosti šifrování, se kterými lze prostředek vytvořit. Platná hodnota je jedna hodnota z následujícího seznamu, nikoli kombinace hodnot z tohoto seznamu: - None = 0: Určuje žádné možnosti vytvoření prostředku. - StorageEncrypted = 1: Určuje, že při vytváření prostředku se mají šifrovat soubory prostředku pro nahrání a ukládání. - CommonEncryptionProtected = 2: Určuje, že soubory prostředku jsou chráněné pomocí společné metody šifrování (například PlayReady). - EnvelopeEncryptionProtected = 4
`Uri` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	Identifikátor URI kontejneru úložiště objektů blob zadaného prostředku
`Locators` Jen pro čtení. Nastaveno službou Media Services.	Sada entit lokátoru	Vrácená sada entit obsahuje všechny entity lokátoru, které jsou propojeny se zadaným assetem.
`ContentKeys` Nepovinný parametr.	Sada entit ContentKey	Vrácená sada entit obsahuje všechny entity ContentKey, které jsou propojeny se zadaným assetem.
`Files` Jen pro čtení. Nastaveno službou Media Services.	Souborová sada entit	Vrácená sada entit obsahuje všechny entity File, které jsou propojeny se zadaným assetem.
`ParentAssets` Nepovinný parametr.	Sada entit nadřazených prostředků	Vrácená sada entit obsahuje všechny nadřazené entity assetu, které jsou propojeny se zadaným assetem.
`StorageAccountName` Nepovinný parametr. Po vytvoření entity nelze aktualizovat.	Edm.String	Název účtu úložiště, který obsahuje kontejner objektů blob prostředku. Pokud není při vytváření zadaný, služba Media Services nastaví výchozí název účtu úložiště.
`StorageAccount` Jen pro čtení. Nastaveno službou Media Services.	Sada entit StorageAccount	Vrácená sada entit obsahuje všechny entity StorageAccount, které jsou propojené se zadaným assetem.
`DeliveryPolicies`	Sada entit AssetDeliveryPolicy	Vrácená sada entit obsahuje zásady doručení přidružené k assetu.
`FormatOption`	Edm.Int32	Určuje různé možnosti formátování, pomocí které lze prostředek vytvořit. Povolené hodnoty jsou: 0 (výchozí) – určuje možnost žádného formátu assetu; 1 – Určuje, že formát prostředku bude AdaptiveStreaming.

Vytvoření prostředku

Prostředky je možné vytvořit pomocí požadavku POST HTTP a zadáním hodnot vlastností.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<umístění.media.azure.net/api/Assets>	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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" }

Výpis prostředku

Prostředky je možné načíst pomocí požadavku GET HTTP.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	<https:// název_účtu.restv2>.<umístění.media.azure.net/api/Assets>	HTTP/1.1

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	<https:// název_účtu.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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

Aktualizace prostředku

Prostředky je možné aktualizovat pomocí požadavku SLOUČIT HTTP a konkrétních vlastností, které chcete změnit.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
SLOUČIT	<https:// název_účtu.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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" }

Odstranění prostředku

Prostředky lze odstranit odkazem na hodnotu ID prostředku. Když se prostředek odstraní, odstraní Microsoft Azure Media Services všechny jeho lokátory. Pokud prostředek obsahoval lokátory původu, budou tyto lokátory odvolány a odstraněny také. Všechny odkazy na ContentKeys budou odstraněny a všechny klíče Obsahu, které nejsou propojeny s jinými prostředky, budou odstraněny.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
DELETE	<https:// název_účtu.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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

Publikování prostředku

Poznámka

Akce Publish je zastaralá. Od nejnovější verze Publish Media Services by se neměla používat.

Pokud váš kód používá Publish, mějte na paměti následující aspekty:

Akce Publish neodstraní lokátory přidružené k prostředku. Po volání Publishje nutné explicitně odstranit lokátory v kódu.
Akce Publish nenastaví stav prostředku na Publishedhodnotu . Odeberte kód, který kontroluje, jestli je prostředek ve Published stavu . V současné době může mít prostředek pouze Initialized stav nebo Deleted .

Propojení klíčů obsahu s prostředky

ContentKey můžete propojit s assetem odkazem na ID prostředku s požadavkem HTTP POST. Identifikátor URI ContentKey musí být součástí textu požadavku. Propojit můžete pouze typ ContentKey, který odpovídá typu zadanému v objektu CreationOptions prostředku. Pokud má například asset možnosti nastavené na StorageEncrypted(1), contentKey musí být typu StorageEncryption(1).

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Assets>('Id assetu')/$links/ContentKeys	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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')"}

Odebrání odkazů ContentKey

Odkazy ContentKey můžete z prostředku odebrat odkazem na ID prostředku a ID ContentKey v požadavku HTTP DELETE. Pokud ContentKey není propojený s žádnými jinými prostředky, odstraní se.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
DELETE	<https:// název_účtu.restv2>.<location.media.azure.net/api/Assets>('Id prostředku')/$links/ContentKeys('ID klíče_obsahu')	HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu 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

Viz také

Zásady přístupu
Klíč obsahu
AssetFile
Úloha
Pracovní pozice
Lokátor
MediaProcessor
Úkol
TaskTemplate
Ingestování prostředků pomocí rozhraní REST API služby Media Services
Kvóty a omezení

Sdílet prostřednictvím

Prostředek

Vlastnosti entity majetku

Vytvoření prostředku

Ukázkový požadavek

Výpis prostředku

Ukázkový požadavek

Aktualizace prostředku

Ukázkový požadavek

Odstranění prostředku

Ukázkový požadavek

Publikování prostředku

Propojení klíčů obsahu s prostředky

Ukázkový požadavek

Odebrání odkazů ContentKey

Ukázkový požadavek

Viz také

Další materiály