Zasób

  • Artykuł

Jednostka Asset zawiera pliki cyfrowe (w tym pliki wideo, audio, obrazy, kolekcje miniatur, ścieżki tekstowe i zamknięte pliki podpis) oraz metadane dotyczące tych plików. Po przekazaniu plików cyfrowych do elementu zawartości można ich używać w przepływach pracy kodowania i przesyłania strumieniowego usługi Media Services.

Podczas kodowania zasobu tworzony jest zasób wyjściowy po zakończeniu zadania kodowania. Wśród plików wymienionych powyżej zasób wyjściowy zawiera pliki metadanych XML opisujące zasób wejściowy i zasób wyjściowy. Aby uzyskać więcej informacji, zobacz artykuły Input Metadata and Output Metadata (Metadane wejściowe i wyjściowe).

Następujące cechy mają zastosowanie do elementu zawartości w usłudze Media Services:

  • Element zawartości jest jednostką logiczną, która reprezentuje pojedynczą prezentację audiowizualną.

  • Zasób zawiera kolekcję jednego do wielu plików multimedialnych.

  • Pliki zasobu znajdują się w jednym kontenerze magazynu obiektów blob.

Niektóre przykłady elementu zawartości to: pełny film, program telewizyjny, konkretna edycja; klip z filmu, programu telewizyjnego, animacji, pliku ISO aparatu lub zdarzenia; zwiastun filmu lub film promocyjny; anons; plik audio, program radiowy, podcast lub plik dźwiękowy.

Następujące cechy nie mają zastosowania do elementu zawartości w usłudze Media Services:

  • Po prostu kontener magazynu

  • Folder do organizowania i przechowywania wielu wersji tej samej prezentacji w programie

  • Folder do przesyłania wsadowego przetwarzania wielu prezentacji audiowizuanych do usługi Azure Media Encoder

Na przykład nie można przechowywać filmu, jego zwiastuna, reklamy i międzynarodowej wersji edycji tego samego filmu w jednym elemecie Asset.

Ten temat zawiera omówienie Asset jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).

Właściwości jednostki zasobu

Właściwość Typ Opis
Id

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Ciąg Unikatowy identyfikator.
State

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.Int32 Wartość wyliczenia opisując stan zasobu. Wartości są następujące:

- Zainicjowane = 0
- Opublikowano = 1 Ostrzeżenie:Publish akcja została wycofana. Usuń kod, który sprawdza, czy element zawartości jest w Published stanie .
- Usunięte = 2

Zasób jest zawsze w stanie Inicjowanie, dopóki nie zostanie usunięty.
Created

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Ta wartość jest ustawiana przez usługę Media Services w czasie tworzenia.
LastModified

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.DateTime Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu jakichkolwiek zmian właściwości.
AlternateId

Opcjonalny.		 Edm.String Alternatywna wartość identyfikatora odpowiadająca identyfikatorowi w innym systemie zarządzania zawartością. Maksymalna długość to 4000.
Name

Opcjonalny.		 Edm.String Przyjazna nazwa zasobu. Maksymalna długość to 512.
Options

Wymagane. Nie można zaktualizować po utworzeniu jednostki.		 Edm.Int32 Wartość wyliczenia opisując opcje szyfrowania, za pomocą których można utworzyć zasób. Prawidłowa wartość to jedna wartość z poniższej listy, a nie kombinacja wartości z tej listy:

- Brak = 0: określa brak opcji tworzenia zasobów.
- StorageEncrypted = 1: określa, że pliki elementu zawartości powinny być szyfrowane na potrzeby przekazywania i przechowywania podczas tworzenia zasobu.
- CommonEncryptionProtected = 2: określa, że pliki elementu zawartości są chronione przy użyciu typowej metody szyfrowania (takiej jak PlayReady).
- KopertaEncryptionProtected = 4
Uri

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Edm.String Identyfikator URI kontenera magazynu obiektów blob określonego zasobu.
Locators

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek lokalizatora Zwrócony zestaw jednostek zawiera wszystkie jednostki lokalizatora połączone z określonym zasobem.
ContentKeys

Opcjonalny.		 Zestaw jednostek ContentKey Zwrócony zestaw jednostek zawiera wszystkie jednostki ContentKey połączone z określonym zasobem.
Files

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek plików Zwrócony zestaw jednostek zawiera wszystkie jednostki File połączone z określonym zasobem.
ParentAssets

Opcjonalny.		 Nadrzędny zestaw jednostek zasobów Zwrócony zestaw jednostek zawiera wszystkie nadrzędne jednostki zasobów połączone z określonym zasobem.
StorageAccountName

Opcjonalny. Nie można zaktualizować po utworzeniu jednostki.		 Edm.String Nazwa konta magazynu zawierającego kontener obiektów blob zasobu.

Jeśli nie zostanie określony w czasie tworzenia, usługa Media Services ustawi domyślną nazwę konta magazynu.
StorageAccount

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek StorageAccount Zwrócony zestaw jednostek zawiera wszystkie jednostki StorageAccount połączone z określonym zasobem.
DeliveryPolicies AssetDeliveryPolicy , zestaw jednostek Zwrócony zestaw jednostek zawiera zasady dostarczania skojarzone z zasobem.
FormatOption Edm.Int32 Określa różne opcje formatu, za pomocą których można utworzyć zasób. Dozwolone wartości to: 0 (wartość domyślna) — określa opcję bez formatu zasobu; 1 — określa, że format elementu zawartości będzie Adaptacyjnystreaming.

Tworzenie zasobu

Zasoby można tworzyć przy użyciu żądania HTTP POST i określania wartości właściwości.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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" }

Wyświetlanie listy elementów zawartości

Zasoby można pobrać przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1
Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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

Aktualizowanie zasobu

Zasoby można zaktualizować przy użyciu żądania HTTP MERGE i określonych właściwości, które chcesz zmienić.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
SCALANIA <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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" }

Usuwanie elementu zawartości

Zasoby można usunąć, odwołując się do wartości Identyfikator zasobu. Po usunięciu elementu zawartości wszystkie jego lokalizatory są usuwane przez Microsoft Azure Media Services. Jeśli zasób miał lokalizatory pochodzenia, te lokalizatory również zostaną odwołane i usunięte. Wszystkie linki do elementów ContentKey zostaną usunięte, a wszystkie elementy ContentKey, które nie są połączone z innymi elementami zawartości, zostaną usunięte.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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

Publikowanie elementu zawartości

Uwaga

Akcja Publish została przestarzała. Począwszy od najnowszej wersji usługi Media Services, Publish nie należy jej używać.

Jeśli kod używa Publishprogramu , należy pamiętać o następujących kwestiach:

  1. Akcja Publish nie usuwa lokalizatorów skojarzonych z zasobem. Należy jawnie usunąć lokalizatory w kodzie po wywołaniu metody Publish.
  2. Akcja Publish nie ustawia stanu zasobu na Published. Usuń kod, który sprawdza, czy element zawartości jest w Published stanie. Obecnie zasób może mieć Initialized tylko stan lub Deleted .

Łączenie kluczy zawartości z elementami zawartości

Klucz zawartości można połączyć z zasobem, odwołując się do identyfikatora zasobu za pomocą żądania HTTP POST. Identyfikator URI klucza zawartości musi być uwzględniony w treści żądania. Typ ContentKey można połączyć tylko z typem określonym w obszarze CreationOptions elementu zawartości. Jeśli na przykład zasób ma opcje ustawione na StorageEncrypted(1), wartość ContentKey musi być typu StorageEncryption(1).

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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')"}

Linki ContentKey można usunąć z zasobu, odwołując się do identyfikatora zasobu i identyfikatora ContentKey w żądaniu HTTP DELETE. Jeśli element ContentKey nie jest połączony z żadnymi innymi elementami zawartości, zostanie on usunięty.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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

Zobacz też

AccessPolicy
ContentKey
AssetFile
Zadanie
JobTemplate
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Pozyskiwanie zasobów za pomocą interfejsu API REST usługi Media Services
Limity przydziału i ograniczenia