tipo de recurso retentionLabel

Namespace: 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 como as organizações, para fins de conformidade e governança, podem gerenciar seus dados em um nível de item (email ou documento), incluindo se e por quanto tempo manter ou excluir o item.

As organizações podem usar rótulos de retenção para diferentes tipos de conteúdo que exigem diferentes configurações de retenção. Por exemplo, eles podem aplicar um rótulo de retenção a formulários fiscais e documentos de suporte para mantê-los pelo período exigido por lei.

As organizações podem configurar rótulos de retenção com os períodos de retenção e ações com base em fatores como a data modificada ou criada pela última vez. Eles também podem iniciar períodos de retenção diferentes especificando um evento que pode disparar a retenção quando o evento ocorre.

Para obter mais informações sobre como os rótulos de retenção funcionam, quando usá-los e como o Microsoft Purview dá suporte a rótulos de retenção para permitir que você configure as configurações de retenção e exclusão, consulte Saiba mais sobre políticas de retenção e rótulos de retenção.

Métodos

Método	Tipo de retorno	Descrição
Retenção de listaLabels	coleção microsoft.graph.security.retentionLabel	Obtenha uma lista dos objetos retentionLabel e suas propriedades.
retenção de Create Label	microsoft.graph.security.retentionLabel	Create um novo objeto retentionLabel.
Obter retentionLabel	microsoft.graph.security.retentionLabel	Leia as propriedades e as relações de um objeto retentionLabel .
Atualizar retentionLabel	microsoft.graph.security.retentionLabel	Atualize as propriedades de um objeto retentionLabel .
Excluir retentionLabel	Nenhum	Excluir um objeto retentionLabel .
Retenção de listaEventType	coleção microsoft.graph.security.retentionEventType	Obtenha os recursos retentionEventType da propriedade de navegação exapnd eventType.
Adicionar retentionEventType	microsoft.graph.security.retentionEventType	Adicione eventType adicionando a propriedade odata relevante ao criar um rótulo.

Propriedades

Propriedade	Tipo	Descrição
actionAfterRetentionPeriod	microsoft.graph.security.actionAfterRetentionPeriod	Especifica a ação a ser executada no documento rotulado após o período especificado pela propriedade retentionDuration expirar. Os valores possíveis são: none, delete, startDispositionReview, unknownFutureValue.
behaviorDuringRetentionPeriod	microsoft.graph.security.behaviorDuringRetentionPeriod	Especifica como o comportamento de um documento com esse rótulo deve ser durante o período de retenção. Os valores possíveis são: doNotRetain, retain, retainAsRecord, retainAsRegulatoryRecord, unknownFutureValue.
createdBy	microsoft.graph.identitySet	Representa o usuário que criou a retentionLabel.
createdDateTime	DateTimeOffset	Representa a data e a hora em que a retençãoLabel é criada.
descriptionForAdmins	Cadeia de caracteres	Fornece informações de rótulo para o administrador. Opcional.
descriptionForUsers	Cadeia de caracteres	Fornece as informações de rótulo para o usuário. Opcional.
displayName	Cadeia de caracteres	Cadeia de caracteres exclusiva que define um nome de rótulo.
id	Cadeia de caracteres	ID exclusiva da retentionLabel.
isInUse	Booliano	Especifica se o rótulo está sendo usado no momento.
lastModifiedBy	microsoft.graph.identitySet	O usuário que modificou pela última vez a retençãoLabel.
lastModifiedDateTime	DateTimeOffset	A data mais recente em que a retençãoLabel foi modificada.
retentionDuration	microsoft.graph.security.retentionDuration	Especifica o número de dias para manter o conteúdo.
retentionTrigger	microsoft.graph.security.retentionTrigger	Especifica se a duração da retenção é calculada a partir da data de criação do conteúdo, da data rotulada ou da última modificação. Os valores possíveis são: dateLabeled, dateCreated, dateModified, dateOfEvent, unknownFutureValue.
defaultRecordBehavior	microsoft.graph.security.defaultRecordBehavior	Especifica o estado bloqueado ou desbloqueado de uma gravadora quando ele é criado. Os valores possíveis são: startLocked, , unknownFutureValuestartUnlocked.
labelToBeApplied	Cadeia de caracteres	Especifica o rótulo de substituição a ser aplicado automaticamente após o término do período de retenção do rótulo atual.

Relações

Relação	Tipo	Descrição
dispositionReviewStages	coleção microsoft.graph.security.dispositionReviewStage	Quando a ação no final da retenção é escolhida como 'dispositionReview', dispositionReviewStages especifica um conjunto sequencial de estágios com pelo menos um revisor em cada estágio.
retentionEventType	microsoft.graph.security.retentionEventType	Representa o tipo associado a um evento de retenção.
Descritores	microsoft.graph.security.filePlanDescriptor	Representa valores fora da caixa que fornecem mais opções para melhorar a capacidade de gerenciamento e a organização do conteúdo que você precisa rotular.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.security.retentionLabel",
  "id": "String (identifier)",
  "displayName": "String",
  "behaviorDuringRetentionPeriod": "String",
  "actionAfterRetentionPeriod": "String",
  "retentionTrigger": "String",
  "retentionDuration": {
    "@odata.type": "microsoft.graph.security.retentionDuration"
  },
  "isInUse": "Boolean",
  "descriptionForAdmins": "String",
  "descriptionForUsers": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "labelToBeApplied": "String",
  "defaultRecordBehavior": "String"
}