Compartilhar via


legalHold resource type

Espaço de nomes: microsoft.graph.ediscovery

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.

Representa uma suspensão legal. As suspensões legais são retenções que estão ligadas a um caso de Deteção de Dados Eletrónicos. As retenções legais não devem ser confundidas com retenções de retenção, que são utilizadas para controlar políticas de retenção para conteúdos do Microsoft 365. As retenções legais da Deteção de Dados Eletrónicos destinam-se à detenção de conteúdos indefinidamente para litígios, investigações internas e outras ações legais em que o conteúdo tem de ser protegido contra a eliminação. Para obter mais informações, veja Gerir suspensões no Advanced eDiscovery

Herda de entidade.

Methods

Método Tipo de retorno Descrição
List microsoft.graph.ediscovery.legalHold collection Obtenha uma lista dos objetos legalHold e respetivas propriedades.
Create microsoft.graph.ediscovery.legalHold Create um novo objeto legalHold.
Get microsoft.graph.ediscovery.legalHold Leia as propriedades e relações de um objeto legalHold .
Atualizar microsoft.graph.ediscovery.legalHold Atualize as propriedades de um objeto legalHold .
Delete Nenhum Eliminar um objeto legalHold .
Listar siteOrigems coleção microsoft.graph.ediscovery.siteSource Obtenha a lista de objetos siteSource associados a uma retenção legal.
Create siteSource microsoft.graph.ediscovery.siteSource Create um novo objeto siteSource.
Listar userSources microsoft.graph.ediscovery.userSource collection Obtenha a lista de objetos userSource associados a uma retenção legal.
Create userSource microsoft.graph.ediscovery.userSource Create um novo objeto userSource.

Propriedades

Propriedade Tipo Descrição
contentQuery Cadeia de caracteres Consulta KQL que especifica o conteúdo a ser mantido nas localizações especificadas. Para saber mais, veja Consultas de palavras-chave e condições de pesquisa para Pesquisa de Conteúdos e Deteção de Dados Eletrónicos. Para manter todo o conteúdo nas localizações especificadas, deixe contentQuery em branco.
createdBy identitySet O utilizador que criou a retenção legal.
createdDateTime DateTimeOffset A data e hora em que a suspensão legal foi criada.
description Cadeia de caracteres A descrição da suspensão legal.
displayName Cadeia de caracteres O nome a apresentar da suspensão legal.
erros Coleção de cadeias de caracteres Listas quaisquer erros que ocorreram ao colocar a suspensão.
id Cadeia de caracteres O ID do caso de Deteção de Dados Eletrónicos. Somente leitura. Herdado da entidade.
isEnabled Booliano Indica se a suspensão está ativada e ativamente a conter conteúdo.
lastModifiedBy identitySet o utilizador que modificou a retenção legal pela última vez.
lastModifiedDateTime DateTimeOffset A data e hora em que a suspensão legal foi modificada pela última vez.
status microsoft.graph.ediscovery.legalHoldStatus A status da suspensão legal. Os valores possíveis são: Pending, Error, Success, UnknownFutureValue.

valores legalHoldStatus

Member Descrição
Pending O processo de distribuição de suspensão está em curso.
Erro Ocorreu um erro quando a suspensão foi aplicada. Para obter detalhes, veja a propriedade errors do objeto legalHold.
Êxito A suspensão foi aplicada com êxito e contém o conteúdo especificado.

Relações

Relação Tipo Descrição
siteSources coleção microsoft.graph.ediscovery.siteSource Entidade de origem de dados para sites do SharePoint associados à retenção legal.
userSources microsoft.graph.ediscovery.userSource collection Entidade de origem de dados para uma retenção legal. Este é o contentor de uma caixa de correio e OneDrive for Business site.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.ediscovery.legalHold",
  "id": "String (identifier)",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "isEnabled": "Boolean",
  "status": "String",
  "contentQuery": "String",
  "errors": [
    "String"
  ],
  "displayName": "String",
  "createdDateTime": "String (timestamp)"
}