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
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.
Leia as propriedades e relações de um objeto ediscoveryReviewSetQuery .
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/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/queries/{queryId}
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 código de 200 OK resposta e um objeto microsoft.graph.security.ediscoveryReviewSetQuery no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries/fcb86cd1-50e0-427c-840e-ba6f087364e5
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/cases/ediscoveryCases('58399dff-cebe-478f-b1af-d3227f1fd645')/reviewSets('273f11a1-17aa-419c-981d-ff10d33e420f')/queries/$entity",
"description": null,
"lastModifiedDateTime": "2022-05-29T23:39:51.3307953Z",
"contentQuery": "((Author=\"edison\"))",
"id": "fcb86cd1-50e0-427c-840e-ba6f087364e5",
"displayName": "My Query 1",
"createdDateTime": "2022-05-29T23:39:51.3307953Z",
"createdBy": {
"application": null,
"user": {
"id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
"displayName": null,
"userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
}
},
"lastModifiedBy": {
"application": null,
"user": {
"id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
"displayName": null,
"userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
}
}
}