Создание macOsVppApp
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Создайте новый объект macOsVppApp .
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-запрос
POST /deviceAppManagement/mobileApps
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта macOsVppApp в формате JSON.
В следующей таблице показаны свойства, необходимые при создании macOsVppApp.
Свойство | Тип | Описание |
---|---|---|
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 | Поддерживаемый тип лицензии. |
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 | Коллекция macOsVppAppRevokeLicensesActionResult | Результаты действий по отзыву лицензии для этого приложения. |
Отклик
В случае успешного 201 Created
выполнения этот метод возвращает код отклика и объект macOsVppApp в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1926
{
"@odata.type": "#microsoft.graph.macOsVppApp",
"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
},
"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.macOsVppAppRevokeLicensesActionResult",
"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 201 Created
Content-Type: application/json
Content-Length: 2098
{
"@odata.type": "#microsoft.graph.macOsVppApp",
"id": "10b95265-5265-10b9-6552-b9106552b910",
"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
},
"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.macOsVppAppRevokeLicensesActionResult",
"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 как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по