Compartilhar via


tipo de recurso directoryRoleTemplate

Namespace: microsoft.graph

Observação

A Microsoft recomenda que utilize a API RBAC unificada em vez desta API. A API RBAC unificada proporciona mais funcionalidade e flexibilidade. Para obter mais informações, veja unifiedRoleDefinition resource type (Tipo de recurso unifiedRoleDefinition).

Representa um modelo de função de diretório. Um modelo de função de diretório especifica os valores de propriedade de uma função de diretório (directoryRole). Existe um objeto de modelo de função de diretório associado para cada uma das funções de diretório que pode ser ativada num inquilino. Para ler uma função de diretório ou atualizar seus membros, primeiro ela deve ser ativada no locatário. Apenas a função de diretório Administradores de Empresa é ativada por padrão. Para ativar outras funções de diretório disponíveis, envie um pedido POST para o /directoryRoles ponto final com o ID do modelo de função de diretório no qual a função de diretório se baseia especificada no parâmetro roleTemplateId do pedido. Após a conclusão bem-sucedida da solicitação, você pode começar a ler e atribuir membros à função de diretório. Observação: Um modelo de função de diretório é exposto para a função de diretório Usuários. A função de diretório Utilizadores está implícita e não está visível para os clientes de diretório. Todos os usuários do locatário são atribuídos a essa função pela infraestrutura. A função já está ativada. Não utilize este modelo.

Métodos

Método Tipo de retorno Descrição
Get directoryRoleTemplate Leia as propriedades e os relacionamentos do objeto directoryRoleTemplate.
List Coleção directoryRoleTemplate Recupere uma lista de objetos directoryRoleTemplate.

Propriedades

Propriedade Tipo Descrição
description String A descrição definida para a função de diretório. Somente leitura.
displayName String O nome de exibição para definir para a função de diretório. Somente leitura.
id String O identificador exclusivo do modelo. Herdado de directoryObject. Você especifica a id do modelo de função do diretório para a propriedade roleTemplateId na solicitação POST para ativar um directoryRole em um locatário. Chave, Não anulável. Somente leitura.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)"
}