Tipo de recurso governanceRoleAssignment

Namespace: microsoft.graph > [!IMPORTANT] > As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Cuidado

Esta versão do Privileged Identity Management (PIM) API para recursos Azure será depreciada em breve. Use a nova API DE PIM REST do Azure para funções de recurso do Azure.

Representa a atribuição de um usuário ou grupo a uma função.

Privileged Identity Management (PIM) dá suporte a dois tipos de atribuições:

  1. Atribuição ativa – representa o acesso direto/ativado aos recursos.
  2. Atribuição qualificada – representa um estágio intermediário de acesso privilegiado a recursos, entre nenhum acesso e acesso direto. Os administradores podem atribuir usuários/eligible assignmentgrupos com antecedência e, sempre que o acesso for necessário, eligible assignment activation no necessário para obter o acesso instantâneo ao recurso por várias horas. Após a ativação active assignment , um será criado para os usuários/membros do grupo indicarem o status ativado.

Métodos

Método Tipo de retorno Descrição
Get governanceRoleAssignment Ler propriedades e relações de uma entidade de atribuição de função.
Listar coleção governanceRoleAssignment Listar uma coleção de atribuições de função em um recurso.
Export octet-stream Baixe uma coleção de atribuições de função em um recurso e salve como um .csv arquivo.

Não POST, PUT, PATCHou operações DELETE têm suporte no conjunto roleAssignments de entidades. Todas as operações de criação, atualização e exclusão são governanceRoleAssignment feitas por governanceRoleAssignmentRequest.

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres A ID da atribuição de função. Ele está no formato GUID.
resourceId Cadeia de caracteres Obrigatório. A ID do recurso ao qual a atribuição de função está associada.
roleDefinitionId Cadeia de caracteres Obrigatório. A ID da definição de função à qual a atribuição de função está associada.
subjectId Cadeia de caracteres Obrigatório. A ID do assunto ao qual a atribuição de função está associada.
linkedEligibleRoleAssignmentId Cadeia de caracteres Se este for um e active assignment criado devido à ativação em um eligible assignment, ele representará a ID disso eligible assignment; Caso contrário, o valor será null.
externalId Cadeia de caracteres A ID externa do recurso que é usado para identificar a atribuição de função no provedor.
startDateTime DateTimeOffset A hora de início da atribuição de função. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
endDateTime DateTimeOffset Para uma atribuição de função não permanente, essa é a hora em que a atribuição de função expirará. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
assignmentState Cadeia de caracteres O estado da atribuição. O valor pode ser Eligible para Active Active atribuição qualificada ou se for atribuído diretamente por administradores ou ativado em uma atribuição qualificada pelos usuários.
Membertype Cadeia de caracteres O tipo de membro. O valor pode ser: Inherited (se a atribuição de função for herdada de um escopo de recurso pai), Group (se a atribuição de função não for herdada, mas vier da associação de uma atribuição de grupo) User ou (se a atribuição de função não for herdada nem de uma atribuição de grupo).

Relações

Relação Tipo Descrição
recurso governanceResource Somente leitura. O recurso associado à atribuição de função.
roleDefinition governanceRoleDefinition Somente leitura. A definição de função associada à atribuição de função.
assunto governanceSubject Somente leitura. O assunto associado à atribuição de função.
linkedEligibleRoleAssignment governanceRoleAssignment Somente leitura. Se este for um e active assignment criado devido à ativação em um eligible assignment, ele representará o objeto disso eligible assignment; Caso contrário, o valor será null.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "id": "String (identifier)",
  "resourceId": "String",
  "roleDefinitionId": "String",
  "subjectId": "String",
  "linkedEligibleRoleAssignmentId": "String",
  "externalId": "String",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "assignmentState": "String",
  "memberType": "String",
}