Update mobileAppContentFile
Пространство имен: microsoft.graph
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта mobileAppContentFile.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementApps.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementApps.ReadWrite.All |
HTTP-запрос
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files/{mobileAppContentFileId}
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Тело запроса
В теле запроса добавьте представление объекта mobileAppContentFile в формате JSON.
Ниже показаны свойства, которые необходимо указывать при создании объекта mobileAppContentFile.
Свойство | Тип | Описание |
---|---|---|
azureStorageUri | String | Указывает универсальный код ресурса (URI) службы хранилища Azure, в который передается файл. Создается службой при получении допустимого файла mobileAppContentFile. Только для чтения. Это свойство доступно только для чтения. |
isCommitted | Boolean | Значение, указывающее, является ли файл подтвержденным. Файл содержимого зафиксированного приложения был полностью загружен и проверен службой Intune. ЗНАЧЕНИЕ TRUE означает, что файл содержимого приложения зафиксирован, значение FALSE означает, что файл содержимого приложения не зафиксирован. Значение по умолчанию — FALSE. Только для чтения. Это свойство доступно только для чтения. |
id | String | Уникальный идентификатор для этого mobileAppContentFile. Этот идентификатор присваивается во время создания mobileAppContentFile. Только для чтения. Это свойство доступно только для чтения. |
createdDateTime | DateTimeOffset | Указывает дату и время создания, связанные с файлом содержимого приложения, в формате ISO 8601. Например, значение полуночи 1 января 2014 г. в формате UTC выглядит так: "2014-01-01T00:00:00Z". Только для чтения. Это свойство доступно только для чтения. |
name | String | Указывает имя файла. |
size | Int64 | Размер файла до шифрования. Чтобы быть нерекомендуемой, используйте вместо этого свойство sizeInBytes. |
sizeEncrypted | Int64 | Размер файла после шифрования. Чтобы быть нерекомендуемой, используйте вместо этого свойство sizeEncryptedInBytes. |
sizeInBytes | Int64 | Указывает исходный размер файла в байтах. Допустимые значения от 0 до 9,22337203685478E+18 |
sizeEncryptedInBytes | Int64 | Указывает размер файла после шифрования в байтах. Допустимые значения от 0 до 9,22337203685478E+18 |
azureStorageUriExpirationDateTime | DateTimeOffset | Указывает дату и время истечения срока действия URI хранилища Azure в формате ISO 8601. Например, значение полуночи 1 января 2014 г. в формате UTC выглядит так: "2014-01-01T00:00:00Z". Только для чтения. Это свойство доступно только для чтения. |
manifest | Binary | Указывает сведения о манифесте, содержащие метаданные файла. |
uploadState | mobileAppContentFileUploadState | Указывает состояние текущего запроса на отправку. Возможные значения: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut. Значение по умолчанию — success. Это свойство доступно только для чтения. Возможные значения: success , transientError , error , unknown , azureStorageUriRequestSuccess , azureStorageUriRequestPending , azureStorageUriRequestFailed , azureStorageUriRequestTimedOut , azureStorageUriRenewalSuccess , azureStorageUriRenewalPending , azureStorageUriRenewalFailed , azureStorageUriRenewalTimedOut , commitFileSuccess , commitFilePending , commitFileFailed , commitFileTimedOut . |
isDependency | Логический | Указывает, является ли этот файл содержимого зависимостью для файла содержимого main. ЗНАЧЕНИЕ TRUE означает, что файл содержимого является зависимостью, значение FALSE означает, что файл содержимого не является зависимостью и является файлом main содержимого. Значение по умолчанию — FALSE. |
Отклик
В случае успешного выполнения этот метод возвращает код ответа 200 OK
и обновленный объект mobileAppContentFile в теле ответа.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files/{mobileAppContentFileId}
Content-type: application/json
Content-length: 419
{
"@odata.type": "#microsoft.graph.mobileAppContentFile",
"azureStorageUri": "Azure Storage Uri value",
"isCommitted": true,
"name": "Name value",
"size": 4,
"sizeEncrypted": 13,
"azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
"manifest": "bWFuaWZlc3Q=",
"uploadState": "transientError",
"isDependency": true
}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 527
{
"@odata.type": "#microsoft.graph.mobileAppContentFile",
"azureStorageUri": "Azure Storage Uri value",
"isCommitted": true,
"id": "eab2e29b-e29b-eab2-9be2-b2ea9be2b2ea",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"name": "Name value",
"size": 4,
"sizeEncrypted": 13,
"sizeInBytes": 11,
"sizeEncryptedInBytes": 4,
"azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
"manifest": "bWFuaWZlc3Q=",
"uploadState": "transientError",
"isDependency": true
}