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)"
}