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

IngestManifestFile

  • Статья

IngestManifestFile представляет собой реальный большой двоичный объект видео или аудио, который будет передан как часть пакетного использования. Дополнительные сведения о массовом приеме см. в статье Прием ресурсов в пакетной службе с помощью REST API. IngestManifestFile всегда связан с IngestManifest и IngestManifestAsset.

В данном разделе приводится описание сущности IngestManifestFile и демонстрируется выполнение различных операций с API REST служб мультимедиа.

Важно!

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

Свойства сущности IngestManifestFile

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

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

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

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

Обязательный.		 Edm.String Реальное имя файла, которое будет передано в контейнер больших двоичных объектов свойством IngestManifest BlobStorageUriForUpload. Службы мультимедиа отслеживают отправку файла в этом контейнере по имени.

Имя файла не может быть пустым или содержать пробелы. Уникально в IngestManifest. Максимальная длина — 4000.
State

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

- Pending = 0: файл еще не отправлен для завершения создания ресурса. Службы мультимедиа ожидают отправки файла.
- Завершено = 1: обнаружена отправка файла и обновлен связанный ресурс.
- Ошибка = 2: произошла ошибка при обработке этого файла. Сведения об ошибке см. в свойстве ErrorDetails.
ParentIngestManifestId

Обязательный.		 Edm.String Идентификатор IngestManifest манифеста, который содержит этот файл.
ParentIngestManifestAssetId

Обязательный.		 Edm.String Идентификатор IngestManifestAsset объекта IngestManifestAsset, с которым связан этот файл.
ErrorDetail

Только для чтения. Задается Media Services.		 Edm.String Сведения об ошибках, возникших при обработке этого файла.
MimeType

Необязательный элемент.		 Edm.String Служба Media Services не проверяет переданный большой двоичный объект, поэтому необходимо вручную задать тип MIME. Например, допустимыми значениями для использования будут «text/plain» или «video/x-ms-wmv».
IsPrimary

Необязательный элемент.		 Edm.Boolean Определяет, является ли IngestManifestFile первичным файлом в многофайловом ресурсе.
EncryptionVersion

Необязательный элемент.		 Edm.String В настоящее время для StorageEncryption, CommonEncryption и EnvelopeEncryption поддерживается версия 1.0.
EncryptionScheme

Необязательный элемент.		 Edm.String Для этого файла используется схема шифрования. Допустимые значения: StorageEncryption, CommonEncryption или EnvelopeEncryption.
IsEncrypted

Необязательный элемент.		 Edm.Boolean Это значение должно быть установлено на true, если этот файл хранится в зашифрованном состоянии.
EncryptionKeyId

Необязательный элемент.		 Edm.String Идентификатор зашифрованного ContentKey.
InitializationVector

Необязательный элемент.		 Edm.String Для шифрования хранилища используется вектор инициализации.

Создание IngestManifestFile

Файлы IngestManifestFile могут быть созданы с помощью HTTP-запроса POST. Необходимо передать текст запроса, который содержит название Name нового IngestManifestFile, а также ParentIngestManifestId и ParentIngestManifestAssetId.

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

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

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

POST https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles 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: 200  
Expect: 100-continue  
  
{ "Name" : "REST_Example_File.wmv", "ParentIngestManifestId" : "nb:mid:UUID:bfe2d76c-17bd-884a-b9be-21bdfda65984", "ParentIngestManifestAssetId" : "nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6" }

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

Файлы IngestManifestFile могут быть получены с помощью HTTP-запроса GET. Можно запросить IngestManifestFile по его идентификатору или запросить все файлы IngestManifestFile, пропустив идентификатор.

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

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

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

GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

Удаление IngestManifestFile

Файлы IngestManifestFile можно удалить посредством ссылки на значение идентификатора IngestManifestFile с HTTP-запросом DELETE.

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

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

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

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

См. также:

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Квоты и ограничения