Crear libro

Espacio de nombres: microsoft.graph.security

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Cree un libro con un identificador generado por el servidor.

Para implementar un libro con un GUID estable seleccionado por el cliente, use en su lugar Actualizar libro .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global	Administración pública de EE. UU.	Gobierno de EE. UU. L5 (DOD)	China operado por 21Vianet
✅	❌	❌	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Workbooks.ReadWrite.All	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Workbooks.ReadWrite.All	No disponible.

El inquilino debe estar activo e incorporado para usar las API de Workbooks. Los permisos delegados de trabajo o escuela y aplicación requieren el consentimiento del administrador. El acceso delegado también requiere que el usuario que ha iniciado sesión tenga la autorización RBAC unificada de Microsoft Defender XDR aplicable. No se admiten cuentas personales de Microsoft.

Solicitud HTTP

POST /security/workbooks

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto microsoft.graph.security.workbook .

Puede especificar las siguientes propiedades al crear un libro.

Propiedad	Tipo	Descripción
contenido	microsoft.graph.security.workbookContent	El documento JSON completo del libro. Proporciona un objeto JSON, no una cadena codificada en JSON. Obligatorio.
name	Cadena	El nombre para mostrar del libro. La longitud máxima es de 256 caracteres. Obligatorio.

No proporcione id., etag, createdByUpn, lastUpdatedByUpn, createdAtDateTime o updatedAtDateTime. El servicio genera el identificador y establece las propiedades de simultaneidad y auditoría.

Respuesta

Si se realiza correctamente, este método devuelve un 201 Created código de respuesta y un objeto microsoft.graph.security.workbook en el cuerpo de la respuesta.

El Location encabezado contiene la dirección URL de Microsoft Graph del nuevo libro. El ETag encabezado contiene el token de simultaneidad actual, que puede usar sin cambios como If-Match valor en una actualización posterior.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/security/workbooks
Content-Type: application/json

{
  "name": "Threat hunting overview",
  "content": {
    "version": "1.0",
    "title": "Threat hunting overview",
    "items": [
      {
        "type": "text",
        "text": "Investigate recent security activity."
      }
    ],
    "settings": {
      "showTitle": true
    }
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json
Location: https://graph.microsoft.com/beta/security/workbooks/ba989c62-af63-b8de-286d-7474ec579357
ETag: W/"0x8DE000000000001"

{
  "@odata.type": "#microsoft.graph.security.workbook",
  "id": "ba989c62-af63-b8de-286d-7474ec579357",
  "name": "Threat hunting overview",
  "content": {
    "version": "1.0",
    "title": "Threat hunting overview",
    "items": [
      {
        "type": "text",
        "text": "Investigate recent security activity."
      }
    ],
    "settings": {
      "showTitle": true
    }
  },
  "createdByUpn": "adelev@contoso.com",
  "lastUpdatedByUpn": "adelev@contoso.com",
  "createdAtDateTime": "2026-09-22T10:00:00Z",
  "updatedAtDateTime": "2026-09-22T10:00:00Z"
}