Compartilhar via


retentionEvent resource type

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.

Representa um acionador para etiquetas de retenção baseadas em eventos em que o início do período de retenção é baseado em quando ocorre um tipo específico de evento. Para saber mais, veja Iniciar retenção quando ocorre um evento.

Métodos

Método Tipo de retorno Descrição
Retenção de listaSventos microsoft.graph.security.retentionEvent collection Obtenha uma lista dos objetos retentionEvent e respetivas propriedades.
Criar retentionEvent microsoft.graph.security.retentionEvent Criar um novo objeto retentionEvent .
Obter retentionEvent microsoft.graph.security.retentionEvent Leia as propriedades e relações de um objeto retentionEvent .
Eliminar retentionEvent Nenhum Eliminar um objeto retentionEvent .
Retenção de listaSventType microsoft.graph.security.retentionEventType collection Obtenha os recursos retentionEventType da propriedade de navegação exapnd eventType.
Criar retentionEventType microsoft.graph.security.retentionEventType Adicione eventType ao adicionar a propriedade odata relevante ao criar um evento.

Propriedades

Propriedade Tipo Descrição
createdBy microsoft.graph.identitySet O utilizador que criou o retentionEvent.
createdDateTime DateTimeOffset A data e hora em que o retentionEvent foi criado.
description Cadeia de caracteres Informações opcionais sobre o evento.
displayName Cadeia de caracteres Nome do evento.
eventPropagationResults microsoft.graph.security.eventPropagationResult collection Representa o estado de êxito de um evento criado e informações adicionais.
eventQueries microsoft.graph.security.eventQuery collection Representa a carga de trabalho (SharePoint Online, OneDrive para Empresas, Exchange Online) e informações de identificação associadas a um evento de retenção.
eventStatus microsoft.graph.security.retentionEventStatus Estado da propogação de eventos para as localizações no âmbito após a criação do evento.
eventTriggerDateTime DateTimeOffset Hora opcional em que o evento deve ser acionado.
id Cadeia de caracteres Representa o ID exclusivo do utilizador que criou o retentionEvent. entidade.
lastModifiedBy microsoft.graph.identitySet O utilizador que modificou pela última vez o retentionEvent.
lastModifiedDateTime DateTimeOffset A hora da data mais recente em que retentionEvent foi modificado.
lastStatusUpdateDateTime DateTimeOffset A última vez que o estado do evento foi atualizado.

Relações

Relação Tipo Descrição
retentionEventType microsoft.graph.security.retentionEventType Especifica o evento que iniciará o período de retenção para etiquetas que utilizam este tipo de evento quando um evento é criado.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.security.retentionEvent",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "eventQueries": [
    {
      "@odata.type": "microsoft.graph.security.eventQuery"
    }
  ],
  "eventTriggerDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "eventPropagationResults": [
    {
      "@odata.type": "microsoft.graph.security.eventPropagationResult"
    }
  ],
  "eventStatus": {
    "@odata.type": "microsoft.graph.security.retentionEventStatus"
  },
  "lastStatusUpdateDateTime": "String (timestamp)"
}