unifiedRoleDefinition resource type (Tipo de recurso unifiedRoleDefinition)

Namespace: microsoft.graph

Uma definição de função é uma coleção de permissões no Microsoft Entra que lista as operações que podem ser executadas e os recursos nos quais podem ser executadas.

Métodos

Método	Tipo de retorno	Descrição
List	unifiedRoleDefinition collection	Leia uma lista de objetos unifiedRoleDefinition e as respetivas propriedades.
Get	unifiedRoleDefinition	Leia as propriedades de um objeto unifiedRoleDefinition.
Create	unifiedRoleDefinition	Crie um objeto unifiedRoleDefinition.
Atualizar	unifiedRoleDefinition	Atualizar um objeto unifiedRoleDefinition.
Delete	Nenhum	Eliminar um objeto unifiedRoleDefinition.

Propriedades

Propriedade	Tipo	Descrição
description	Cadeia de caracteres	A descrição da unifiedRoleDefinition. Só de leitura quando isBuiltIn é true.
displayName	Cadeia de caracteres	O nome a apresentar para unifiedRoleDefinition. Só de leitura quando isBuiltIn é true. Obrigatório. Suporta $filter (eq, in).
id	Cadeia de caracteres	O identificador exclusivo da definição de função. Chave, não anulável, Só de leitura. Herdado da entidade. Suporta $filter (eq, in).
isBuiltIn	Booliano	Sinalizador que indica se a definição de função faz parte do conjunto predefinido incluído no Microsoft Entra ou uma definição personalizada. Somente leitura. Suporta $filter (eq, in).
isEnabled	Booliano	Sinalizador que indica se a função está ativada para atribuição. Se false a função não estiver disponível para atribuição. Só de leitura quando isBuiltIn é verdadeiro.
resourceScopes	String collection	Lista dos âmbitos ou permissões a que a definição de função se aplica. Atualmente, só / é suportado. Só de leitura quando isBuiltIn é verdadeiro. NÃO UTILIZE. Isto será preterido em breve. Anexar âmbito à atribuição de função.
rolePermissions	unifiedRolePermission collection (coleção unifiedRolePermission )	Lista de permissões incluídas na função. Só de leitura quando isBuiltIn é true. Obrigatório.
templateId	Cadeia de caracteres	Identificador de modelo personalizado que pode ser definido quando isBuiltIn é false mas é só de leitura quando isBuiltIn é true. Normalmente, este identificador é utilizado se precisar que um identificador seja o mesmo em diretórios diferentes.
versão	Cadeia de caracteres	Indica a versão da definição de função. Só de leitura quando isBuiltIn é true.

Relações

Relação	Tipo	Descrição
herdaPermissionsFrom	unifiedRoleDefinition collection	Coleção só de leitura de definições de funções das quais a definição de função especificada herda. Apenas as funções incorporadas do Microsoft Entra (isBuiltIn é true) suportam este atributo. Suporta o $expand.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.unifiedRoleDefinition",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isBuiltIn": "Boolean",
  "isEnabled": "Boolean",
  "resourceScopes": [
    "String"
  ],
  "rolePermissions": [
    {
      "@odata.type": "microsoft.graph.unifiedRolePermission"
    }
  ],
  "templateId": "String",
  "version": "String"
}