Поделиться через

Создание deviceManagementComplexSettingDefinition

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

Важно: Корпорация Майкрософт поддерживает api Intune /beta, но они могут часто изменяться. Корпорация Майкрософт рекомендует по возможности использовать версию 1.0. Проверьте доступность API в версии 1.0 с помощью селектора версий.

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

Создайте объект deviceManagementComplexSettingDefinition .

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

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

Разрешения

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

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

HTTP-запрос

POST /deviceManagement/settingDefinitions
POST /deviceManagement/categories/{deviceManagementSettingCategoryId}/settingDefinitions
POST /deviceManagement/intents/{deviceManagementIntentId}/categories/{deviceManagementIntentSettingCategoryId}/settingDefinitions
POST /deviceManagement/templates/{deviceManagementTemplateId}/categories/{deviceManagementTemplateSettingCategoryId}/settingDefinitions

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

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

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

В тексте запроса укажите представление объекта deviceManagementComplexSettingDefinition в формате JSON.

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

Свойство Тип Описание
id String Идентификатор определения параметра, наследуемого от deviceManagementSettingDefinition
Valuetype deviceManangementIntentValueType Тип данных значения Наследуется от deviceManagementSettingDefinition. Возможные значения: integer, boolean, string, complex, collection, abstractComplex.
displayName String Отображаемое имя параметра наследуется от deviceManagementSettingDefinition
isTopLevel Логический Если параметр является верхним уровнем, его можно настроить без необходимости упаковки в коллекцию или сложный параметр Наследуется от deviceManagementSettingDefinition.
description String Описание параметра Наследуется от deviceManagementSettingDefinition
заполнительText String Замещающий текст в качестве примера допустимых входных данных Наследуется от deviceManagementSettingDefinition
DocumentationUrl String URL-адрес документации по настройке Наследуется от deviceManagementSettingDefinition
headerTitle String заголовок параметра представляет категорию или раздел параметра/параметры, унаследованные от deviceManagementSettingDefinition
headerSubtitle String подзаголовок заголовка параметра для получения дополнительных сведений о категории или разделе Наследуется от deviceManagementSettingDefinition
keywords Коллекция строк Ключевые слова, связанные с параметром Наследуется от deviceManagementSettingDefinition
Зависимости коллекция deviceManagementConstraint Коллекция ограничений для значения параметра Наследуется от deviceManagementSettingDefinition
Зависимости коллекция deviceManagementSettingDependency Коллекция зависимостей от других параметров Наследуется от deviceManagementSettingDefinition
propertyDefinitionIds Коллекция строк Определения каждого свойства сложного параметра

Отклик

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

Пример

Запрос

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

POST https://graph.microsoft.com/beta/deviceManagement/settingDefinitions
Content-type: application/json
Content-length: 1094

{
  "@odata.type": "#microsoft.graph.deviceManagementComplexSettingDefinition",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "propertyDefinitionIds": [
    "Property Definition Ids value"
  ]
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementComplexSettingDefinition",
  "id": "823ca4f9-a4f9-823c-f9a4-3c82f9a43c82",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "propertyDefinitionIds": [
    "Property Definition Ids value"
  ]
}
  • Last updated on