Поделиться через

IngestManifest

  • Статья

IngestManifest представляет набор ресурсов, которые необходимо создать с помощью массовой передачи вместе со связанными файлами ресурсов. Массовый прием позволяет отделить процесс отправки файлов от создания ресурса. В результате для больших наборов файлов во время создания ресурса можно использовать высокопроизводительный метод отправки файлов. После создания IngestManifestAssets вместе со связанным с ним IngestManifestFiles Cлужбы мультимедиа Microsoft Azure следит за контейнером хранилища BLOB-объектов, связанным с IngestManifest, через свойство BlobStorageUriForUpload. По мере завершения отправки каждого файла в контейнер хранилища BLOB-объектов Cлужбы мультимедиа Microsoft Azure завершает новый ресурс для соответствующего набора IngestManifestAsset, содержащего этот файл.

В этой статье представлен обзор сущности IngestManifest , а также показано, как выполнять различные операции с помощью REST API Служб мультимедиа.

Важно!

При доступе к сущностям в службах мультимедиа необходимо задать определенные поля и значения заголовков в HTTP-запросах.
Дополнительные сведения см. в статье Настройка rest API Служб мультимедиа Разработка и подключение к Службам мультимедиа с помощью REST API Служб мультимедиа.

Примечание

Каждый файл IngestManifestAssetFile, связанный с IngestManifest, должен иметь уникальное имя файла в манифесте.

Свойства объекта IngestManifest

Свойство Тип Описание
Id

Только для чтения. Устанавливается Службами мультимедиа во время создания.		 Edm.String Уникальный идентификатор.
Created

Только для чтения. Устанавливается Службами мультимедиа во время создания.		 Edm.DateTime Представляет количество миллисекунд с полуночи 1 января 1970 г.
LastModified

Только для чтения. Задается Media Services.		 Edm.DateTime Это значение обновляется Службами мультимедиа после внесения любых изменений свойств. Оно представляет количество миллисекунд с полуночи 1 января 1970 г.
Name

Необязательный элемент.		 Edm.String Понятное имя IngestManifest.
State

Только для чтения. Задается Media Services.		 Edm.Int32 Текущее состояние манифеста. Значение может быть одним из следующих.

- Неактивно = 0: ожидающих создания ресурсов не остается. Все они завершились или вызвали ошибку.
- Активация = 1: манифест еще не готов к получению файлов, отправленных в контейнер BLOB-объектов.
- Активный = 2. Существуют IngestManifestAssets, ожидающие создания, и контейнер BLOB-объектов отслеживается.
BlobStorageUriForUpload

Только для чтения. Задается Media Services.		 Edm.String Это значение задается Службами мультимедиа. Это значение указывает универсальный код ресурса (URI) контейнера хранилища BLOB-объектов, который получает отправляемые файлы, необходимые для завершения IngestManifestAssets.
Statistics

Только для чтения. Задается Media Services.		 IngestManifestStatistics Этот сложный тип содержит статистические сведения, которые помогают определить текущий ход создания IngestManifestAssets на основе всех файлов ресурсов, связанных с манифестом.
IngestManifestAssets

Только для чтения. Задается Media Services.		 Набор сущностей IngestManifestAsset Свойство навигации, доступ к которому можно получить с помощью кода IngestManifestAsset. Возвращенный набор объектов содержит все объекты IngestManifestAssets в IngestManifest.
PendingIngestManifestAssets

Только для чтения. Задается Media Services.		 Набор сущностей IngestManifestAsset Свойство навигации, доступ к которому можно получить с помощью кода IngestManifestAsset. Возвращенный набор объектов содержит все объекты IngestManifestAssets, ожидающие загрузки файлов или создания ресурсов.
StorageAccountName

Необязательный элемент. Нельзя обновить после создания сущности.		 Edm.String Имя учетной записи хранения, которая содержит контейнер BLOB-объектов, в который загружаются файлы.

Если во время создания не указано, Службы мультимедиа задают имя учетной записи хранения по умолчанию.

Ресурс должен использовать ту же учетную запись хранения, указанную в IngestManifest.
StorageAccount

Только для чтения. Задается Media Services.		 Набор объектов StorageAccount. Возвращенный набор объектов содержит все объекты StorageAccount, связанные с указанным ресурсом.

Создание IngestManifest

Объекты IngestManifest можно создать с помощью HTTP-запроса POST, передавая текст запроса, который содержит имя нового объекта IngestManifest.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

POST https:// media.windows.net/API/IngestManifests 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: 36  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestREST" }

Перечисление IngestManifest

Объекты IngestManifest можно получить с помощью HTTP-запроса GET. Вы можете запросить манифест по коду или запросить все манифесты.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:a2f9a230-831e-5e40-bafa-fbf8decbee26') 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

Обновление IngestManifest

IngestManifests можно обновить, ссылаясь на идентификатор IngestManifest с помощью HTTP-запроса MERGE. Текст запроса содержит свойства, которые необходимо обновить.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

MERGE https:// media.windows.net /API/IngestManifests('nb:mid:UUID:076faa09-8f5d-ce41-9de3-32ba66190271') 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: 43  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestUpdated" }

Удаление IngestManifest

Объекты IngestManifest можно удалить, указав ссылку на значение кода IngestManifest в HTTP-запросе DELETE.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Пример запроса

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:45ea3cd0-b3cf-994b-8e4d-03c9620c22da') 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

См. также:

AccessPolicy
AssetFile
Ресурс
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Задание
JobTemplate
Локатор
MediaProcessor
Задача
TaskTemplate
Квоты и ограничения