ediscoverySearch: purgeData

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.

Eliminar itens de caixa de correio do Exchange ou mensagens do Microsoft Teams contidas numa pesquisa de Deteção de Dados Eletrónicos.

Nota: Este pedido remove um máximo de 100 itens apenas por localização.

Pode recolher e remover as seguintes categorias de conteúdos do Teams:

  • Conversas do Teams 1:1 – mensagens de chat, mensagens e anexos partilhados numa conversação do Teams entre duas pessoas. As conversas do Teams 1:1 também são denominadas conversações.
  • Conversas de grupo do Teams – mensagens de chat, mensagens e anexos partilhados numa conversação do Teams entre três ou mais pessoas. Também denominada conversas de grupo ou chats 1:N.
  • Canais do Teams – mensagens de chat, mensagens, respostas e anexos partilhados num canal padrão do Teams.
  • Canais privados – mensagens, respostas e anexos partilhados num canal privado do Teams.
  • Canais partilhados – mensagens, respostas e anexos partilhados num canal partilhado do Teams.

Para obter mais informações sobre como remover mensagens do Teams, consulte:

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.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application eDiscovery.ReadWrite.All Indisponível.

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 do pedido, forneça uma representação JSON dos parâmetros.

A tabela seguinte mostra os parâmetros que pode utilizar com esta ação.

Parâmetro Tipo Descrição
purgeAreas microsoft.graph.security.purgeAreas Opções para definir as localizações a definir no âmbito da ação de remoção. Os valores possíveis são: mailboxes, teamsMessages, unknownFutureValue.
purgeType microsoft.graph.security.purgeType Opções que controlam se a ação é eliminação recuperável ou eliminação rígida. Os valores possíveis são recoverable, unknownFutureValue, permanentlyDelete.

Resposta

Se tiver êxito, esta ação retornará um código de resposta 202 Accepted.

Se a operação de remoção de dados for iniciada com êxito, esta ação devolve um 202 Accepted código de resposta. A resposta também contém um Location cabeçalho, que contém a localização da operação de remoção de dados que foi criada para consolidar a remoção. Para marcar a status da operação de remoção de dados, faça um pedido GET para o URL de localização.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/purgeData

{
  "purgeType": "recoverable",
  "purgeAreas": "teamsMessages"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted