Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph.security
Obtenha uma lista dos objetos ediscoveryCase e suas propriedades.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
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) | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função com suporte do Microsoft Purview por meio de uma das seguintes opções:
- Gerente de Descoberta Eletrônica. Permite que os membros visualizem e acessem os casos de Descoberta Eletrônica que criam, incluindo pesquisa e acesso a dados de casos. No entanto, os Gerentes de Descoberta Eletrônica só podem acessar e gerenciar os casos que criam. Esta é a opção menos privilegiada para gerenciar seus próprios casos.
- Administrador de Descoberta. Fornece todas as permissões do Gerenciador de Descoberta Eletrônica, além da capacidade de exibir e acessar todos os casos de Descoberta Eletrônica na organização.
Funções adicionais que fornecem acesso de leitura a casos de Descoberta Eletrônica:
- Administrador de Conformidade. Inclui permissões de Gerenciamento de Casos e Pesquisa de Conformidade.
- Gestão da Organização. Inclui permissões de Gerenciamento de Casos e Pesquisa de Conformidade.
- Revisor. Fornece acesso somente leitura a conjuntos de revisão em casos de Descoberta Eletrônica em que o usuário é membro.
As funções de Gerente de Descoberta Eletrônica e Administrador de Descoberta Eletrônica fazem parte dos grupos de funções do Microsoft Purview e fornecem acesso aos recursos de Descoberta Eletrônica por meio do RBAC (controle de acesso baseado em função).
Para obter mais informações sobre permissões e funções da Descoberta Eletrônica, consulte Atribuir permissões na Descoberta Eletrônica.
Solicitação HTTP
GET /security/cases/ediscoveryCases
Parâmetros de consulta opcionais
Este método dá suporte a alguns parâmetros de consulta 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, esse método retornará um 200 OK código de resposta e uma coleção de objetos microsoft.graph.security.ediscoveryCase no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases
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/v1.0/$metadata#security/cases/ediscoveryCases",
"@odata.count": 22,
"value": [
{
"description": "",
"lastModifiedDateTime": "2022-05-19T23:30:41.23Z",
"status": "active",
"closedDateTime": null,
"externalId": "",
"id": "60f86305-ac3e-408b-baa2-ea585dd8b0c0",
"displayName": "My case 1",
"createdDateTime": "2022-05-19T23:30:41.23Z",
"lastModifiedBy": {
"application": null,
"user": {
"id": null,
"displayName": "MOD Administrator"
}
},
"closedBy": {
"application": null,
"user": {
"id": null,
"displayName": ""
}
}
},
{
"description": "",
"lastModifiedDateTime": "2022-05-18T23:05:07.82Z",
"status": "active",
"closedDateTime": null,
"externalId": "",
"id": "7acdda75-3559-4f93-9827-cbd4c89db033",
"displayName": "My case 2",
"createdDateTime": "2022-05-18T23:05:07.82Z",
"lastModifiedBy": {
"application": null,
"user": {
"id": null,
"displayName": "MOD Administrator"
}
},
"closedBy": {
"application": null,
"user": {
"id": null,
"displayName": ""
}
}
}
]
}