Partilhar via


Create assignmentScheduleRequest

Namespace: microsoft.graph

Create um novo objeto privilegedAccessGroupAssignmentScheduleRequest.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup PrivilegedAssignmentSchedule.Remove.AzureADGroup
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup PrivilegedAssignmentSchedule.Remove.AzureADGroup

O usuário de chamada também deve ser o proprietário ou membro do grupo ou receber uma das seguintes funções de Microsoft Entra.

  • Para grupos atribuíveis a função: Administrador de Funções Privilegiadas
  • Para grupos não atribuíveis a função: Directory Writer, Groups Administrator, Identity Governance Administrator ou User Administrator

As atribuições de função para o usuário chamador devem ser escopo no nível do diretório.

Outras funções com permissões para gerenciar grupos (como administradores do Exchange para grupos microsoft 365 não atribuíveis à função) e administradores com atribuições no nível da unidade administrativa podem gerenciar grupos por meio da API de grupos e substituir as alterações feitas em Microsoft Entra PIM por meio do PIM para APIs de grupos.

Solicitação HTTP

POST /identityGovernance/privilegedAccess/group/assignmentScheduleRequests

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto privilegedAccessGroupAssignmentScheduleRequest .

Você pode especificar as propriedades a seguir ao criar um privilegedAccessGroupAssignmentScheduleRequest.

Propriedade Tipo Descrição
accessId privilegedAccessGroupRelationships O identificador da relação de associação ou atribuição de propriedade com o grupo. Os valores possíveis são: owner, member. Obrigatório.
ação Cadeia de caracteres Representa o tipo da operação na solicitação de associação de grupo ou atribuição de propriedade. Os valores possíveis são adminAssign, adminUpdate, adminRemove, selfActivate, selfDeactivate, adminExtend, adminRenew.
  • adminAssign: para que os administradores atribuam associação de grupo ou propriedade a entidades de segurança.
  • adminRemove: para os administradores removerem as entidades de associação ou propriedade do grupo.
  • adminUpdate: para os administradores alterarem as atribuições de associação de grupo ou propriedade existentes.
  • adminExtend: para os administradores estenderem as atribuições expirando.
  • adminRenew: para os administradores renovarem atribuições expiradas.
  • selfActivate: para as entidades de segurança ativarem suas atribuições.
  • selfDeactivate: para as entidades de segurança desativarem suas atribuições ativas.
Obrigatório.
Customdata Cadeia de caracteres Campo de texto gratuito para definir quaisquer dados personalizados para a solicitação. Opcional.
groupId Cadeia de caracteres O identificador do grupo que representa o escopo da atribuição de associação ou propriedade por meio do PIM para grupos. Obrigatório.
Justificação Cadeia de caracteres Uma mensagem fornecida por usuários e administradores quando eles criam o objeto privilegedAccessGroupAssignmentScheduleRequest . Opcional.
principalId Cadeia de caracteres O identificador da entidade de segurança cuja atribuição de associação ou propriedade é concedida por meio do PIM para grupos. Obrigatório.
scheduleInfo requestSchedule O período da associação de grupo ou atribuição de propriedade para PIM para grupos. Atualmente, os agendamentos recorrentes não têm suporte. Obrigatório.
ticketInfo ticketInfo Detalhes do tíquete vinculados à associação ao grupo ou à solicitação de atribuição de propriedade, incluindo detalhes do número do tíquete e do sistema de tíquetes. Opcional.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto privilegedAccessGroupAssignmentScheduleRequest no corpo da resposta.

Exemplos

Exemplo 1: Create uma solicitação de agendamento de atribuição

A solicitação a seguir cria uma solicitação de agenda de atribuição para atribuir uma associação ativa principal ao grupo especificado. A associação ativa expira após duas horas.

Solicitação

POST https://graph.microsoft.com/v1.0/identityGovernance/privilegedAccess/group/assignmentScheduleRequests
Content-Type: application/json

{
  "accessId": "member", 
  "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2", 
  "groupId": "68e55cce-cf7e-4a2d-9046-3e4e75c4bfa7", 
  "action": "adminAssign", 
  "scheduleInfo": { 
    "startDateTime": "2022-12-08T07:43:00.000Z", 
    "expiration": { 
      "type": "afterDuration", 
      "duration": "PT2H" 
    } 
  }, 
  "justification": "Assign active member access."
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/privilegedAccess/group/assignmentScheduleRequests/$entity",
  "id": "34e963f6-150f-cf79-678c-6fcaf978bb49",
  "status": "Provisioned",
  "completedDateTime": "2023-02-07T07:05:55.3404527Z",
  "createdDateTime": "2023-02-07T07:05:53.7895614Z",
  "approvalId": null,
  "customData": null,
  "createdBy": {
      "user": {
          "id": "3cce9d87-3986-4f19-8335-7ed075408ca2"
      }
  },
  "action": "adminAssign",
  "isValidationOnly": false,
  "justification": "Assign active member access.",
  "scheduleInfo": {
      "startDateTime": "2023-02-07T07:05:55.3404527Z",
      "expiration": {
        "type": "afterDuration",
         "duration": "PT2H"
      }
  },
  "ticketInfo": {
      "ticketNumber": null,
      "ticketSystem": null
  },
  "accessId": "member", 
  "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2", 
  "groupId": "68e55cce-cf7e-4a2d-9046-3e4e75c4bfa7",
  "targetScheduleId": "2b5ed229-4072-478d-9504-a047ebd4b07d_member_6aacaee8-4089-4048-9510-3119367fc943"
}

Exemplo 2: o usuário ativa sua atribuição qualificada para PIM para Grupos

Na solicitação a seguir, um usuário identificado por principalId3cce9d87-3986-4f19-8335-7ed075408ca2 ativa sua associação qualificada a um grupo gerenciado pelo PIM identificado pelo groupId2b5ed229-4072-478d-9504-a047ebd4b07d.

Solicitação

POST https://graph.microsoft.com/v1.0/identityGovernance/privilegedAccess/group/assignmentScheduleRequests
Content-Type: application/json

{
  "accessId": "member", 
  "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2", 
  "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d", 
  "action": "selfActivate", 
  "scheduleInfo": { 
    "startDateTime": "2023-02-08T07:43:00.000Z", 
    "expiration": { 
      "type": "afterDuration", 
      "duration": "PT2H" 
    } 
  }, 
  "justification": "Activate assignment."
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/privilegedAccess/group/assignmentScheduleRequests/$entity",
  "id": "6aacaee8-4089-4048-9510-3119367fc943",
  "status": "Provisioned",
  "completedDateTime": "2023-02-07T07:05:55.3404527Z",
  "createdDateTime": "2023-02-07T07:05:53.7895614Z",
  "approvalId": null,
  "customData": null,
  "createdBy": {
      "user": {
          "id": "3cce9d87-3986-4f19-8335-7ed075408ca2"
      }
  },
  "action": "selfActivate",
  "isValidationOnly": false,
  "justification": "Activate assignment.",
  "scheduleInfo": {
      "startDateTime": "2023-02-07T07:05:55.3404527Z",
      "expiration": {
        "type": "afterDuration",
         "duration": "PT2H"
      }
  },
  "ticketInfo": {
      "ticketNumber": null,
      "ticketSystem": null
  },
  "accessId": "member", 
  "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2", 
  "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d",
  "targetScheduleId": "2b5ed229-4072-478d-9504-a047ebd4b07d_member_6aacaee8-4089-4048-9510-3119367fc943"
}