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
Квоты и ограничения