Update iosVppApp
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта iosVppApp.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-запрос
PATCH /deviceAppManagement/mobileApps/{mobileAppId}
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Тело запроса
В теле запроса добавьте представление объекта iosVppApp в формате JSON.
Ниже показаны свойства, которые необходимо указывать при создании объекта iosVppApp.
Свойство | Тип | Описание |
---|---|---|
id | String | Ключ объекта. Это свойство доступно только для чтения. Наследуется от mobileApp. |
displayName | String | Название приложения, которое предоставил или импортировал администратор. Наследуется от mobileApp. |
description | String | Описание приложения. Наследуется от mobileApp. |
publisher | String | Издатель приложения. Наследуется от mobileApp. |
largeIcon | mimeContent | Представляет большой значок, который отображается в сведениях о приложении, используется для отправки значка. Наследуется от mobileApp. |
createdDateTime | DateTimeOffset | Дата и время создания приложения. Это свойство доступно только для чтения. Наследуется от mobileApp. |
lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения приложения. Это свойство доступно только для чтения. Наследуется от mobileApp. |
isFeatured | Boolean | Значение, которое показывает, отмечено ли приложение как подобранное администратором. Наследуется от объекта mobileApp. |
privacyInformationUrl | String | URL-адрес заявления о конфиденциальности. Наследуется от mobileApp. |
informationUrl | String | URL-адрес страницы с дополнительными сведениями. Наследуется от mobileApp. |
owner | String | Владелец приложения. Наследуется от mobileApp. |
developer | String | Разработчик приложения. Наследуется от mobileApp. |
notes | String | Заметки для приложения. Наследуется от mobileApp. |
uploadState | Int32 | Состояние отправки. Возможные значения: 0 - Not Ready , 1 - Ready , 2 - Processing . Это свойство доступно только для чтения. Наследуется от mobileApp. |
publishingState | mobileAppPublishingState | Состояние публикации для приложения. Приложение невозможно назначить, если оно не опубликовано. Это свойство доступно только для чтения. Наследуется от mobileApp. Возможные значения: notPublished , processing , published . |
isAssigned | Логический | Значение, указывающее, назначено ли приложение хотя бы одной группе. Это свойство доступно только для чтения. Наследуется от mobileApp. |
roleScopeTagIds | Коллекция строк | Список идентификаторов тегов область для этого мобильного приложения. Наследуется от mobileApp. |
dependentAppCount | Int32 | Общее количество зависимостей, которые имеет дочернее приложение. Это свойство доступно только для чтения. Наследуется от mobileApp. |
supersedingAppCount | Int32 | Общее число приложений, которое прямо или косвенно заменяет это приложение. Это свойство доступно только для чтения. Наследуется от mobileApp. |
supersededAppCount | Int32 | Общее количество приложений, которыми это приложение прямо или косвенно заменено. Это свойство доступно только для чтения. Наследуется от mobileApp. |
usedLicenseCount | Int32 | Количество используемых лицензий VPP. |
totalLicenseCount | Int32 | Общее количество лицензий VPP. |
releaseDateTime | DateTimeOffset | Дата и время выпуска приложения, на которое распространяется программа VPP. |
appStoreUrl | String | URL-адрес магазина. |
licensingType | vppLicensingType | Поддерживаемый тип лицензии. |
applicableDeviceType | iosDeviceType | Применимый тип устройства с iOS. |
vppTokenOrganizationName | String | Организация, связанная с токеном Apple Volume Purchase Program. |
vppTokenAccountType | vppTokenAccountType | Тип программы оптовых покупок, с которой связан заданный токен Apple Volume Purchase Program. Возможные значения: business , education . Возможные значения: business , education . |
vppTokenAppleId | String | Идентификатор Apple ID, связанный с заданным токеном Apple Volume Purchase Program. |
bundleId | String | Имя удостоверения. |
vppTokenId | String | Идентификатор токена VPP, связанного с этим приложением. |
revokeLicenseActionResults | коллекция iosVppAppRevokeLicensesActionResult | Результаты действий по отзыву лицензии для этого приложения. |
Отклик
В случае успешного выполнения этот метод возвращает код ответа 200 OK
и обновленный объект iosVppApp в теле ответа.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 2056
{
"@odata.type": "#microsoft.graph.iosVppApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportUserLicensing": true,
"supportDeviceLicensing": true,
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value",
"vppTokenId": "Vpp Token Id value",
"revokeLicenseActionResults": [
{
"@odata.type": "microsoft.graph.iosVppAppRevokeLicensesActionResult",
"userId": "User Id value",
"managedDeviceId": "Managed Device Id value",
"totalLicensesCount": 2,
"failedLicensesCount": 3,
"actionFailureReason": "appleFailure",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
]
}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2228
{
"@odata.type": "#microsoft.graph.iosVppApp",
"id": "a0ac9b6f-9b6f-a0ac-6f9b-aca06f9baca0",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportUserLicensing": true,
"supportDeviceLicensing": true,
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value",
"vppTokenId": "Vpp Token Id value",
"revokeLicenseActionResults": [
{
"@odata.type": "microsoft.graph.iosVppAppRevokeLicensesActionResult",
"userId": "User Id value",
"managedDeviceId": "Managed Device Id value",
"totalLicensesCount": 2,
"failedLicensesCount": 3,
"actionFailureReason": "appleFailure",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
]
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по