Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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)"
}