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