Criar pasta de trabalho

Namespace: microsoft.graph.security

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Crie uma pasta de trabalho com uma ID gerada pelo servidor.

Para implantar uma pasta de trabalho com um GUID estável selecionado pelo cliente, use Atualizar pasta de trabalho .

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante)	Workbooks.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	Workbooks.ReadWrite.All	Indisponível.

O locatário deve estar ativo e integrado para usar as APIs de Pastas de Trabalho. As permissões delegadas de trabalho ou escola e aplicativo exigem o consentimento do administrador. O acesso delegado também exige que o usuário conectado tenha a autorização RBAC Unificada aplicável do Microsoft Defender XDR. Não há suporte para contas Microsoft pessoais.

Solicitação HTTP

POST /security/workbooks

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto microsoft.graph.security.workbook .

Você pode especificar as propriedades a seguir ao criar uma pasta de trabalho.

Propriedade	Tipo	Descrição
conteúdo	microsoft.graph.security.workbookContent	O documento JSON completo da pasta de trabalho. Forneça um objeto JSON, não uma cadeia de caracteres codificada em JSON. Obrigatório.
nome	Cadeia de caracteres	O nome de exibição da pasta de trabalho. O comprimento máximo é de 256 caracteres. Obrigatório.

Não forneça id, etag, createdByUpn, lastUpdatedByUpn, createdAtDateTime ou updatedAtDateTime. O serviço gera a ID e define as propriedades de simultaneidade e auditoria.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto microsoft.graph.security.workbook no corpo da resposta.

O Location cabeçalho contém a URL do Microsoft Graph da nova pasta de trabalho. O ETag cabeçalho contém o token de simultaneidade atual, que você pode usar inalterado como valor If-Match em uma atualização subsequente.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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