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.
Atualize as propriedades 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 gerenciem custodiantes e fontes de dados para casos de Descoberta Eletrônica que eles criam. No entanto, os Gerentes de Descoberta Eletrônica só podem gerenciar os custodiantes para os casos que eles criarem. Esta é a opção menos privilegiada para gerenciar custodiantes em seus próprios casos.
- Administrador de Descoberta. Fornece todas as permissões do Gerente de Descoberta Eletrônica, além da capacidade de gerenciar custodiantes e fontes de dados para todos os casos de Descoberta Eletrônica na organização.
A função de Custodiante fornece acesso para gerenciar fontes de dados (caixas de correio, sites do SharePoint e Teams) associadas a guardiões em casos de Descoberta Eletrônica. Essa função só está disponível para membros do grupo de funções do Gerente de Descoberta Eletrônica.
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
PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/queries/{queryId}
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 apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayName | Cadeia de caracteres | O nome da consulta. Obrigatório. |
| contentQuery | Cadeia de caracteres | A consulta KQL para o conjunto de revisão. Para obter detalhes, consulte Consultar e filtrar conteúdo em um conjunto de revisão. |
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No content.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/queries/5f426fdc-f027-40db-b7cc-453cf06dc996
Content-Type: application/json
{
"displayName": "My Query 1 (update)",
"contentQuery": "(Author=\"edisons\")"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No content.