Compartir a través de

Creación de securityBaselineTemplate

  • 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 securityBaselineTemplate .

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/templates
POST /deviceManagement/templates/{deviceManagementTemplateId}/migratableTo

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 securityBaselineTemplate.

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

Propiedad Tipo Descripción
id Cadena Identificador de plantilla heredado de deviceManagementTemplate
displayName Cadena Nombre para mostrar de la plantilla Heredado de deviceManagementTemplate
description Cadena Descripción de la plantilla heredada de deviceManagementTemplate
versionInfo Cadena Información de versión de la plantilla Heredada de deviceManagementTemplate
isDeprecated Booleano La plantilla está en desuso o no. Las intenciones no se pueden crear a partir de una plantilla en desuso. Heredado de deviceManagementTemplate
intentCount Int32 Número de intenciones creadas a partir de esta plantilla. Heredado de deviceManagementTemplate
templateType deviceManagementTemplateType Tipo de la plantilla. Se hereda de deviceManagementTemplate. Los valores posibles son: securityBaseline, specializedDevices, advancedThreatProtectionSecurityBaseline, deviceConfiguration, custom, securityTemplate, microsoftEdgeSecurityBaseline, microsoftOffice365ProPlusSecurityBaseline, deviceCompliance, deviceConfigurationForOffice365, cloudPC y firewallSharedSettings.
platformType policyPlatformType Plataforma de la plantilla. Se hereda de deviceManagementTemplate. Los valores posibles son: android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, androidWorkProfile, windows10XProfile y all.
templateSubtype deviceManagementTemplateSubtype Subtipo de la plantilla. Se hereda de deviceManagementTemplate. Los valores posibles son: none, firewall, diskEncryption, attackSurfaceReduction, endpointDetectionReponse, accountProtection, antivirus, firewallSharedAppList, firewallSharedIpList y firewallSharedPortlist.
publishedDateTime DateTimeOffset Cuando se publicó la plantilla Se heredó de deviceManagementTemplate

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

{
  "@odata.type": "#microsoft.graph.securityBaselineTemplate",
  "displayName": "Display Name value",
  "description": "Description value",
  "versionInfo": "Version Info value",
  "isDeprecated": true,
  "intentCount": 11,
  "templateType": "specializedDevices",
  "platformType": "androidForWork",
  "templateSubtype": "firewall",
  "publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}

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: 454

{
  "@odata.type": "#microsoft.graph.securityBaselineTemplate",
  "id": "3f61d4c2-d4c2-3f61-c2d4-613fc2d4613f",
  "displayName": "Display Name value",
  "description": "Description value",
  "versionInfo": "Version Info value",
  "isDeprecated": true,
  "intentCount": 11,
  "templateType": "specializedDevices",
  "platformType": "androidForWork",
  "templateSubtype": "firewall",
  "publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}