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
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 ediscoverySearch .
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) | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
Solicitação HTTP
PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}
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 do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
| Propriedade | Tipo | Descrição |
|---|---|---|
| contentQuery | Cadeia de caracteres | A cadeia de consulta na consulta KQL (QL por palavra-chave). Para obter detalhes, veja Consultas de palavras-chave e condições de pesquisa para Pesquisa de Conteúdos e Deteção de Dados Eletrónicos. Pode refinar as pesquisas utilizando campos emparelhados com valores; por exemplo, subject:"Quarterly Financials" AND Date>=06/01/2016 AND Date<=07/01/2016. |
| dataSourceScopes | microsoft.graph.security.dataSourceScopes | Quando especificado, a coleção irá abranger um serviço para toda uma carga de trabalho. Os valores possíveis são: none,allTenantMailboxes,allTenantSites,allCaseCustodians,allCaseNoncustodialDataSources.
Nota: É necessário um depositário ou especificar dataSourceScope quando cria uma coleção de origem. |
| description | Cadeia de caracteres | A descrição da pesquisa de Deteção de Dados Eletrónicos. |
| displayName | Cadeia de caracteres | O nome a apresentar da pesquisa de Deteção de Dados Eletrónicos. |
Resposta
Se for bem-sucedido, este método devolve um 204 No Content código de resposta e um objeto microsoft.graph.security.ediscoverySearch atualizado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}
Content-Type: application/json
{
"displayName": "Teams search"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content