Создание импортированногоAppleDeviceIdentity

Пространство имен: microsoft.graph

Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создайте новый объект importedAppleDeviceIdentity .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/importedAppleDeviceIdentities

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса укажите представление json для объекта importedAppleDeviceIdentity.

В следующей таблице показаны свойства, необходимые при создании импортируемого объекта AppleDeviceIdentity.

Свойство	Тип	Описание
id	String	Ключ объекта.
serialNumber	String	Серийный номер устройства.
requestedEnrollmentProfileId	String	Администратор профиля регистрации идентификатора намерен применить к устройству во время следующей регистрации
requestedEnrollmentProfileAssignmentDateTime	DateTimeOffset	Время, назначенное профилю регистрации устройству
isSupervised	Логический	Указывает, находится ли устройство Apple под контролем.
discoverySource	discoverySource;	Источник обнаружения устройств Apple. Возможные значения: unknown, adminImport, deviceEnrollmentProgram.
isDeleted	Логический	Указывает, удалено ли устройство из Apple Business Manager.
createdDateTime	DateTimeOffset	Дата создания устройства
lastContactedDateTime	DateTimeOffset	Дата последнего контакта устройства
description	String	Описание устройства
enrollmentState	enrollmentState	Состояние устройства в Intune. Возможные значения: unknown, enrolled, pendingReset, failed, notContacted, blocked.
платформа	Платформы	Платформа устройства. Возможные значения: unknown, ios, android, windows, windowsMobile, macOS.

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и объект importedAppleDeviceIdentity в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/importedAppleDeviceIdentities
Content-type: application/json
Content-length: 519

{
  "@odata.type": "#microsoft.graph.importedAppleDeviceIdentity",
  "serialNumber": "Serial Number value",
  "requestedEnrollmentProfileId": "Requested Enrollment Profile Id value",
  "requestedEnrollmentProfileAssignmentDateTime": "2017-01-01T00:02:32.8167841-08:00",
  "isSupervised": true,
  "discoverySource": "adminImport",
  "isDeleted": true,
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "description": "Description value",
  "enrollmentState": "enrolled",
  "platform": "ios"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 627

{
  "@odata.type": "#microsoft.graph.importedAppleDeviceIdentity",
  "id": "352e3c2f-3c2f-352e-2f3c-2e352f3c2e35",
  "serialNumber": "Serial Number value",
  "requestedEnrollmentProfileId": "Requested Enrollment Profile Id value",
  "requestedEnrollmentProfileAssignmentDateTime": "2017-01-01T00:02:32.8167841-08:00",
  "isSupervised": true,
  "discoverySource": "adminImport",
  "isDeleted": true,
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "description": "Description value",
  "enrollmentState": "enrolled",
  "platform": "ios"
}