Creación de deviceManagementCollectionSettingDefinition

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Cree un nuevo objeto deviceManagementCollectionSettingDefinition .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

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

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto deviceManagementCollectionSettingDefinition.

En la tabla siguiente se muestran las propiedades necesarias al crear deviceManagementCollectionSettingDefinition.

Propiedad	Tipo	Descripción
id	Cadena	Identificador de la definición de configuración heredada de deviceManagementSettingDefinition
valueType	deviceManangementIntentValueType	Tipo de datos del valor Heredado de deviceManagementSettingDefinition. Los valores posibles son: integer, boolean, string, complex, collection, abstractComplex.
displayName	Cadena	Nombre para mostrar de la configuración Heredado de deviceManagementSettingDefinition
isTopLevel	Booleano	Si la configuración es de nivel superior, se puede configurar sin necesidad de encapsularse en una colección o una configuración compleja Heredada de deviceManagementSettingDefinition
description	Cadena	Descripción de la configuración Heredada de deviceManagementSettingDefinition
placeholderText	Cadena	Texto de marcador de posición como ejemplo de entrada válida heredada de deviceManagementSettingDefinition
documentationUrl	Cadena	Dirección URL para establecer la documentación heredada de deviceManagementSettingDefinition
headerTitle	Cadena	title del encabezado de configuración representa una categoría o sección de una configuración o configuración heredada de deviceManagementSettingDefinition
headerSubtitle	Cadena	subtítulo del encabezado de configuración para obtener más detalles sobre la categoría o sección Heredada de deviceManagementSettingDefinition
keywords	Colección de cadenas	Palabras clave asociadas a la configuración Heredada de deviceManagementSettingDefinition
Restricciones	colección deviceManagementConstraint	Colección de restricciones para el valor de configuración Heredado de deviceManagementSettingDefinition
Dependencias	colección deviceManagementSettingDependency	Colección de dependencias en otras configuraciones heredadas de deviceManagementSettingDefinition
elementDefinitionId	Cadena	Identificador de definición de configuración que describe el aspecto de cada elemento de la colección

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto deviceManagementCollectionSettingDefinition en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "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"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id value"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "id": "0419c4a7-c4a7-0419-a7c4-1904a7c41904",
  "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"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id value"
}