Partilhar via


Create eligibilityScheduleRequest

Namespace: microsoft.graph

Create um novo objeto privilegedAccessGroupEligibilityScheduleRequest.

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) PrivilegedEligibilitySchedule.ReadWrite.AzureADGroup PrivilegedEligibilitySchedule.Remove.AzureADGroup
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application PrivilegedEligibilitySchedule.ReadWrite.AzureADGroup PrivilegedEligibilitySchedule.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/eligibilityScheduleRequests

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 privilegedAccessGroupEligibilityScheduleRequest .

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

Propriedade Tipo Descrição
accessId privilegedAccessGroupRelationships O identificador da relação de associação ou elegibilidade de propriedade para o grupo. Os valores possíveis são: owner, member. Obrigatório.
ação Cadeia de caracteres Representa o tipo de operação na solicitação de atribuição de associação de grupo ou de elegibilidade de propriedade. Os valores possíveis são adminAssign, adminUpdate, adminRemove, selfActivate, selfDeactivate, adminExtend, adminRenew.
  • adminAssign: para os administradores atribuirem a associação de grupo ou a elegibilidade de propriedade a entidades de segurança.
  • adminRemove: para os administradores removerem entidades de associação de grupo ou elegibilidade de propriedade.
  • adminUpdate: para os administradores alterarem as atribuições qualificadas existentes.
  • adminExtend: para os administradores estenderem as atribuições qualificadas expirando.
  • adminRenew: para os administradores renovarem atribuições qualificadas expiradas.
  • selfActivate: para que as entidades de segurança ativem suas atribuições qualificadas.
  • selfDeactivate: para as entidades de segurança desativarem suas atribuições qualificadas.
groupId Cadeia de caracteres O identificador do grupo que representa o escopo da associação ou da elegibilidade de 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 .
principalId Cadeia de caracteres O identificador da entidade de segurança cuja associação ou elegibilidade de propriedade para o grupo é gerenciado 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 privilegedAccessGroupEligibilityScheduleRequest no corpo da resposta.

Exemplos

Exemplo 1: um administrador cria uma solicitação de propriedade de grupo qualificada para uma entidade

A solicitação a seguir cria uma solicitação de agendamento de qualificação para tornar uma entidade de segurança qualificada para ser um proprietário do grupo. A propriedade qualificada expira após duas horas.

Solicitação

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

{
    "accessId": "member",
    "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2",
    "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d",
    "action": "AdminAssign",
    "scheduleInfo": {
        "startDateTime": "2023-02-06T19:25:00.000Z",
        "expiration": {
            "type": "AfterDateTime",
            "endDateTime": "2023-02-07T19:56:00.000Z"
        }
    },
    "justification": "Assign eligible request."
}

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.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/$entity",
    "id": "f8bd9e2d-bc15-49b1-8a9b-c571b3cf9555",
    "status": "Provisioned",
    "createdDateTime": "2023-02-07T06:57:54.1633903Z",
    "completedDateTime": "2023-02-07T06:57:55.6183972Z",
    "action": "adminAssign",
    "isValidationOnly": false,
    "justification": "Assign eligible request.",
    "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2",
    "accessId": "member",
    "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d",
    "targetScheduleId": "2b5ed229-4072-478d-9504-a047ebd4b07d_member_f8bd9e2d-bc15-49b1-8a9b-c571b3cf9555",
    "createdBy": {
        "user": {
            "id": "3cce9d87-3986-4f19-8335-7ed075408ca2"
        }
    },
    "scheduleInfo": {
        "startDateTime": "2023-02-07T06:57:55.6183972Z",
        "recurrence": null,
        "expiration": {
            "type": "afterDateTime",
            "endDateTime": "2023-02-07T19:56:00Z",
            "duration": null
        }
    }
}

Exemplo 2: um administrador estende uma associação de grupo qualificada para uma entidade

A solicitação a seguir estende uma solicitação de agendamento de elegibilidade existente antes de expirar.

Solicitação

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

{
    "accessId": "member",
    "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2",
    "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d",
    "action": "AdminExtend",
    "scheduleInfo": {
        "startDateTime": "2023-02-06T19:25:00.000Z",
        "expiration": {
            "type": "AfterDateTime",
            "endDateTime": "2023-02-07T20:56:00.000Z"
        }
    },
    "justification": "Extend eligible request."
}

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.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/$entity",
    "id": "e3405b79-c0d8-4597-87b5-a84451e29224",
    "status": "Provisioned",
    "createdDateTime": "2023-02-07T07:01:25.9239454Z",
    "completedDateTime": "2023-02-07T07:01:27.3379548Z",
    "action": "adminExtend",
    "isValidationOnly": false,
    "justification": "Extend eligible request.",
    "principalId": "3cce9d87-3986-4f19-8335-7ed075408ca2",
    "accessId": "member",
    "groupId": "2b5ed229-4072-478d-9504-a047ebd4b07d",
    "targetScheduleId": "2b5ed229-4072-478d-9504-a047ebd4b07d_member_e3405b79-c0d8-4597-87b5-a84451e29224",
    "createdBy": {
        "user": {
            "id": "3cce9d87-3986-4f19-8335-7ed075408ca2"
        }
    },
    "scheduleInfo": {
        "startDateTime": "2023-02-07T07:01:27.3379548Z",
        "expiration": {
            "type": "afterDateTime",
            "endDateTime": "2023-02-07T20:56:00Z",
            "duration": null
        }
    }
}