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

AssetFile

  • Статья

Объект AssetFile представляет фактический видео- или аудиофайл, который хранится в контейнере BLOB-объектов. Файл ресурса всегда связан с ресурсом, а ресурс может содержать один или несколько файлов. Задача кодировщика служб мультимедиа завершится с ошибкой, если объект файла ресурса не связан с цифровым файлом в контейнере больших двоичных объектов.

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

Важно!

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

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

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

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

Обязательный.		 Edm.String Понятное имя AssetFile. Значение по умолчанию — имя файла, использованное при загрузке файла. Максимальная длина — 260. Примечание: Службы мультимедиа используют значение Name свойства при создании URL-адресов для содержимого потоковой передачи (например, http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters. По этой причине кодирование в процентах запрещено. Значение свойства Name не может содержать такие зарезервированные знаки, используемые для кодировки URL-адресов: !*'();:@&=+$,/?%#[]". Кроме того, может использоваться только один знак ".". Кроме того, может использоваться только один символ "." для расширения имени файла.
ContentFileSize

Необязательный элемент.		 Edm.Int64 Размер AssetFile (в байтах).
ParentAssetId

Обязательный. Нельзя обновить после создания сущности.		 Edm.String Код ресурса, с которым связан этот файл.
EncryptionVersion

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

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

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

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

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

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

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

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

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

Необязательный элемент.		 Edm.String Шестнадцатеричное число, представляющее значение дайджеста сообщения MD5 (RFC 1321). Это значение задает клиент или клиентская библиотека для проверки успешной загрузки контента. Максимальная длина — 4000.

Создание сущности AssetFile

Функция CreateFileInfos используется для создания объекта AssetFile. Дополнительные сведения см. в разделе Функции REST API.

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

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

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

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

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

GET https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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

Обновление AssetFile

Объекты AssetFile обновляются с помощью HTTP-запроса MERGE.

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

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

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

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Удаление AssetFile

Объекты AssetFile удаляются при удалении связанных ресурсов. Пример см. в разделе Удаление ресурса.

См. также:

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