Compartilhar via


tipo de recurso de contrato

Namespace: microsoft.graph

Representa os termos de uso personalizáveis de um locatário que é criado e gerenciado com Microsoft Entra ID Governance. Você pode usar os métodos a seguir para criar e gerenciar o recurso Microsoft Entra Termos de Uso de acordo com seu cenário.

Métodos

Método Tipo de retorno Descrição
List coleção agreement Obtenha uma coleção de objetos de contrato.
Create contrato Crie um novo contrato postando na coleção de contratos.
Get contrato Leia propriedades e relações de um objeto agreement.
Atualizar Nenhum(a) Atualize um objeto de contrato.
Delete Nenhum Exclua um objeto de contrato.

Propriedades

Propriedade Tipo Descrição
displayName Cadeia de caracteres Nome de exibição do contrato. O nome de exibição é usado para acompanhamento interno do contrato, mas não é mostrado para usuários finais que exibem o contrato. Suporta $filter (eq).
id Cadeia de caracteres O identificador do contrato. Somente leitura. Suporta $filter (eq).
isPerDeviceAcceptanceRequired Booliano Indica se os usuários finais são obrigados a aceitar esse contrato em todos os dispositivos dos quais eles o acessam. O usuário final será obrigado a registrar seu dispositivo em Microsoft Entra ID, se ainda não o tiver feito. Suporta $filter (eq).
isViewingBeforeAcceptanceRequired Booliano Indica se o usuário precisa expandir o contrato antes de aceitar. Suporta $filter (eq).
termsExpiration termsExpiration Agenda de expiração e frequência de contrato para todos os usuários. Suporta $filter (eq).
userReacceptRequiredFrequency Duração A duração após a qual o usuário deve reaceitar os termos de uso. O valor é representado no formato ISO 8601 para durações. Suporta $filter (eq).

Relações

Relação Tipo Descrição
Aceitações Coleção agreementAcceptance Somente leitura. Informações sobre aceitações desse contrato.
file agreementFile PDF padrão vinculado a este contrato.
arquivos coleção agreementFileLocalization PDFs vinculados a esse contrato. Essa propriedade está em processo de preterida. Em vez disso, use a propriedade do arquivo . Suporta o $expand.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.agreement",
  "displayName": "String",
  "id": "String (identifier)",
  "isPerDeviceAcceptanceRequired": "Boolean",
  "isViewingBeforeAcceptanceRequired": "Boolean",
  "termsExpiration": {
    "@odata.type": "microsoft.graph.termsExpiration"
  },
  "userReacceptRequiredFrequency": "String (duration)"
}