Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Espaço de nomes: microsoft.graph.security.securityCopilot
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.
Obtenha uma lista das sessões no Security Copilot.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | SecurityCopilotWorkspaces.Read.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | SecurityCopilotWorkspaces.Read.All | Indisponível. |
Importante
Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída uma função de Microsoft Security Copilot suportada ao utilizador com sessão iniciada. Security Copilot Contribuidor é a função com menos privilégios suportada para esta operação.
Solicitação HTTP
GET /security/securityCopilot/workspaces/{workspaceId}/sessions
Parâmetros de consulta opcionais
Este método suporta os $countparâmetros de consulta , $filter$select e $top OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos de sessão no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/security/securityCopilot/workspaces/default/sessions
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/securityCopilot/workspaces('default')/sessions",
"@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET security/securityCopilot/workspaces('<key>')/sessions?$select=createdDateTime,displayName",
"value": [
{
"id": "f0f54c69-8f8a-4f33-b6e3-386d58b408db",
"createdDateTime": "2025-10-15T15:54:58.4862768Z",
"lastModifiedDateTime": "2025-10-15T15:54:58.4862768Z",
"displayName": null
},
{
"id": "8e95c36e-c9bd-4e14-8317-3cd4332e1e3b",
"createdDateTime": "2025-09-17T19:23:41.1506601Z",
"lastModifiedDateTime": "2025-09-17T19:28:21.2902705Z",
"displayName": "who am i"
}
]
}