unifiedRoleAssignmentScheduleRequest resource type
Namespace: microsoft.graph
Importante
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 Versão.
No PIM, representa um pedido de atribuição de função ativa a um principal. A atribuição de função pode ser permanentemente ativa com ou sem uma data de expiração ou temporariamente ativada após a ativação de uma atribuição elegível. Herda do pedido.
Para obter mais informações sobre cenários PIM que pode definir através do tipo de recurso unifiedRoleAssignmentScheduleRequest, veja Descrição geral da gestão de funções através da API de gestão de identidades privilegiadas (PIM).
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | unifiedRoleAssignmentScheduleRequest collection (coleção unifiedRoleAssignmentScheduleRequest ) | Obtenha os pedidos de atribuições de funções ativas efetuadas através do objeto unifiedRoleAssignmentScheduleRequest . |
| Create | unifiedRoleAssignmentScheduleRequest | Crie um pedido para uma atribuição de função ativa e persistente ou ative, desative, expanda ou renove uma atribuição de função elegível. |
| Get | unifiedRoleAssignmentScheduleRequest | Obtenha um pedido para uma atribuição de função ativa feita através do objeto unifiedRoleAssignmentScheduleRequest . |
| Cancel | Nenhum | Cancelar um pedido para uma atribuição de função ativa. |
| Filtrar por utilizador atual | unifiedRoleAssignmentScheduleRequest collection (coleção unifiedRoleAssignmentScheduleRequest ) | Obtenha os pedidos de atribuições de funções ativas para um principal específico. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| ação | Cadeia de caracteres | Representa o tipo da operação no pedido de atribuição de função. Os valores possíveis são adminAssign, adminUpdate, adminRemove, selfActivate, selfDeactivate, adminExtend, adminRenew, selfExtend, selfRenew, unknownFutureValue.
|
| approvalId | Cadeia de caracteres | O identificador da aprovação do pedido. Herdado do pedido. |
| appScopeId | Cadeia de caracteres | Identificador do âmbito específico da aplicação quando a atribuição está confinada a uma aplicação. O âmbito de uma atribuição determina o conjunto de recursos ao qual foi concedido acesso ao principal. Os âmbitos da aplicação são âmbitos definidos e compreendidos apenas por esta aplicação. Utilize / para âmbitos de aplicações ao nível do inquilino. Utilize directoryScopeId para limitar o âmbito a determinados objetos de diretório, por exemplo, unidades administrativas.
$filter Suporta (eq, nee em null valores). |
| completedDateTime | DateTimeOffset | A data de conclusão do pedido. Herdado do pedido. |
| createdBy | identitySet | O principal que criou este pedido. Herdado do pedido. Somente leitura.
$filter Suporta (eq, nee em null valores). |
| createdDateTime | DateTimeOffset | A data de criação do pedido. Herdado do pedido. Somente leitura. |
| customData | Cadeia de caracteres | Campo de texto livre para definir quaisquer dados personalizados para o pedido. Não usado. Herdado do pedido. |
| directoryScopeId | Cadeia de caracteres | Identificador do objeto de diretório que representa o âmbito da atribuição. O âmbito de uma atribuição determina o conjunto de recursos ao qual foi concedido acesso ao principal. Os âmbitos de diretório são âmbitos partilhados armazenados no diretório que são compreendidos por várias aplicações. Utilize / para o âmbito ao nível do inquilino. Utilize appScopeId para limitar o âmbito apenas a uma aplicação.
$filter Suporta (eq, nee em null valores). |
| id | Cadeia de caracteres | O identificador exclusivo do objeto unifiedRoleAssignmentScheduleRequest . Chave, não anulável, Só de leitura. Herdado da entidade. Suporta $filter (eq, ne). |
| isValidationOnly | Booliano | Determina se a chamada é uma validação ou uma chamada real. Defina esta propriedade apenas se quiser verificar se uma ativação está sujeita a regras adicionais, como a MFA, antes de submeter realmente o pedido. |
| justificação | Cadeia de caracteres | Uma mensagem fornecida por utilizadores e administradores ao criar criam o objeto unifiedRoleAssignmentScheduleRequest . |
| principalId | Cadeia de caracteres | Identificador do principal ao qual foi concedida a atribuição. Pode ser um utilizador, um grupo atribuível a funções ou um principal de serviço. Suporta $filter (eq, ne). |
| roleDefinitionId | Cadeia de caracteres | Identificador do objeto unifiedRoleDefinition que está a ser atribuído ao principal. Suporta $filter (eq, ne). |
| scheduleInfo | requestSchedule | O período da atribuição de função. Atualmente, as agendas periódicas não são suportadas. |
| status | Cadeia de caracteres | O estado do pedido de atribuição de função. Herdado do pedido. Somente leitura. Suporta $filter (eq, ne). |
| targetScheduleId | Cadeia de caracteres | Identificador do objeto de agendamento associado ao pedido de atribuição. Suporta $filter (eq, ne). |
| ticketInfo | ticketInfo | Detalhes do pedido de permissão associados ao pedido de atribuição de função, incluindo detalhes do número da permissão e do sistema de pedidos. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| activatedUsing | unifiedRoleEligibilitySchedule | Se o pedido for de um administrador elegível para ativar uma função, este parâmetro mostrará a atribuição elegível relacionada para essa ativação. Caso contrário, é null.
$expand Suporta e $select aninhado no $expand. |
| appScope | appScope | Propriedade só de leitura com detalhes do âmbito específico da aplicação quando a atribuição está confinada a uma aplicação. Anulável. Suporta o $expand. |
| directoryScope | directoryObject | O objeto de diretório que é o âmbito da atribuição. Somente leitura. Oferece suporte para $expand. |
| principal | directoryObject | O principal que está a obter uma atribuição de função através do pedido.
$expand Suporta e $select aninhado $expand apenas para ID. |
| roleDefinition | unifiedRoleDefinition | Informações detalhadas para o objeto unifiedRoleDefinition que é referenciado através da propriedade roleDefinitionId .
$expand Suporta e $select aninhado no $expand. |
| targetSchedule | unifiedRoleAssignmentSchedule | A agenda de uma atribuição de função elegível referenciada através da propriedade targetScheduleId .
$expand Suporta e $select aninhado no $expand. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.unifiedRoleAssignmentScheduleRequest",
"id": "String (identifier)",
"status": "String",
"completedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)",
"approvalId": "String",
"customData": "String",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"action": "String",
"principalId": "String",
"roleDefinitionId": "String",
"directoryScopeId": "String",
"appScopeId": "String",
"isValidationOnly": "Boolean",
"targetScheduleId": "String",
"justification": "String",
"scheduleInfo": {
"@odata.type": "microsoft.graph.requestSchedule"
},
"ticketInfo": {
"@odata.type": "microsoft.graph.ticketInfo"
}
}