Compartir a través de

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

Actualice las propiedades de un 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

PATCH /deviceManagement/templates/{deviceManagementTemplateId}
PATCH /deviceManagement/templates/{deviceManagementTemplateId}/migratableTo/{deviceManagementTemplateId}

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 200 OK código de respuesta y un objeto securityBaselineTemplate actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/templates/{deviceManagementTemplateId}
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 200 OK
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"
}