Liste des objets de classeur

Espace de noms : microsoft.graph.security

Obtenez les classeurs dans le locataire.

La réponse omet du contenu par défaut. Pour récupérer des documents de classeur dans la réponse de collection, sélectionnez explicitement du contenu, par exemple, $select=id,name,content.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Le client doit être actif et intégré pour utiliser les API Classeurs. Les autorisations déléguées de travail, d’école ou d’application nécessitent le consentement de l’administrateur. L’accès délégué exige également que l’utilisateur connecté dispose de l’autorisation RBAC unifiée de Microsoft Defender XDR applicable. Les comptes Microsoft personnels ne sont pas pris en charge.

Requête HTTP

GET /security/workbooks

Paramètres facultatifs de la requête

Cette méthode prend en charge le paramètre de $select requête OData pour choisir les propriétés à retourner. Pour des informations générales, consultez paramètres de la requête OData.

Si une réponse contient @odata.nextLink, demandez que l’URL complète reste inchangée pour récupérer la page suivante. Continuez jusqu’à ce que la réponse ne contienne @odata.nextLinkplus . Traitez le jeton de saut dans l’URL comme opaque ; Ne le décodez pas et ne construisez pas vous-même un jeton.

En-têtes de demande

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

En cas de réussite, cette méthode renvoie un 200 OK code de réponse et une collection d’objets microsoft.graph.security.workbook dans le corps de la réponse.

Exemples

Exemple 1 : répertorier les métadonnées du classeur

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/beta/security/workbooks

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.workbook",
      "id": "ba989c62-af63-b8de-286d-7474ec579357",
      "name": "Threat hunting overview",
      "createdByUpn": "adelev@contoso.com",
      "lastUpdatedByUpn": "adelev@contoso.com",
      "createdAtDateTime": "2026-09-22T10:00:00Z",
      "updatedAtDateTime": "2026-09-22T10:00:00Z"
    }
  ]
}

Exemple 2 : inclure le contenu du classeur

Demande

L’exemple suivant sélectionne l’ID de classeur, le nom et le document de contenu complet.

GET https://graph.microsoft.com/beta/security/workbooks?$select=id,name,content

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@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
        }
      }
    }
  ]
}