ediscoverySearch: purgeData
Namespace: microsoft.graph.security
Excluir mensagens do Microsoft Teams contidas em uma pesquisa de descoberta eletrônica.
Nota: Essa solicitação limpa somente dados do Teams. Ele não limpa outros tipos de dados, como itens de caixa de correio.
Você pode coletar e limpar as seguintes categorias de conteúdo do Teams:
- Chats do Teams 1:1 – Mensagens de chat, postagens e anexos compartilhados em uma conversa do Teams entre duas pessoas. Os chats do Teams 1:1 também são chamados de conversas.
- Chats de grupo do Teams – Mensagens de chat, postagens e anexos compartilhados em uma conversa do Teams entre três ou mais pessoas. Também chamado de chats 1:N ou conversas em grupo.
- Canais do Teams – Mensagens de chat, postagens, respostas e anexos compartilhados em um canal padrão do Teams.
- Canais privados – Mensagens, respostas e anexos compartilhados em um canal privado do Teams.
- Canais compartilhados – Mensagens, respostas e anexos compartilhados em um canal compartilhado do Teams.
Para obter mais informações sobre como limpar mensagens do Teams, confira:
- Série de soluções de descoberta eletrônica: cenário de vazamento de dados – Pesquisa e limpeza
- Fluxo de trabalho de descoberta eletrônica (Premium) para conteúdo no Microsoft Teams
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | eDiscovery.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/purgeData
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
No corpo da solicitação, forneça uma representação JSON dos parâmetros.
A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.
Parâmetro | Tipo | Descrição |
---|---|---|
Purgetype | microsoft.graph.security.purgeType | Opções que controlam se a ação é exclusão temporária ou exclusão dura. Os valores possíveis são recoverable , permanentlydeleted , unknownFutureValue . |
purgeAreas | microsoft.graph.security.purgeAreas | Opção para definir os locais a serem no escopo da ação de limpeza. Os valores possíveis são: mailboxes , teamsMessages , unknownFutureValue . |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 202 Accepted
.
Se a operação de dados de limpeza for iniciada com êxito, essa ação retornará um código de 202 Accepted
resposta. A resposta também conterá um Location
cabeçalho, que contém o local da operação Limpar dados que foi criada para confirmar o expurgo.
Para marcar o status da operação de dados de limpeza, faça uma solicitação GET para a URL de localização.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/purgeData
{
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de