Creación de deviceManagementCollectionSettingDefinition

  • Artículo

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 string 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"
}