Compartilhar via


Atualizar accessReviewScheduleDefinition

Namespace: microsoft.graph

Atualize um objeto accessReviewScheduleDefinition existente para alterar uma ou mais de suas propriedades.

Observação

Todas as atualizações feitas a um accessReviewScheduleDefinition só se aplicam a instâncias futuras. Atualmente, as instâncias em execução não podem ser atualizadas. Além disso, essa API não se destina a atualizar propriedades, incluindo decisões, no nível accessReviewInstance. Consulte accessReviewInstance para obter mais informações sobre instâncias.

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) AccessReview.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application AccessReview.ReadWrite.All Indisponível.

Solicitação HTTP

PUT /identityGovernance/accessReviews/definitions/{review-id}

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 de um objeto accessReviewScheduleDefinition .

A tabela a seguir mostra as propriedades aceitas para atualizar um accessReviewScheduleDefinition.

Propriedade Tipo Descrição
descriptionForAdmins Cadeia de caracteres Contexto da revisão fornecida aos administradores.
descriptionForReviewers Cadeia de caracteres Contexto da revisão fornecida aos revisores.
displayName Cadeia de caracteres Nome da série de revisão de acesso.
fallbackReviewers coleção accessReviewReviewerScope Uma coleção de escopos de revisor usada para definir a lista de revisores de fallback que são notificados a agir se nenhum usuário for encontrado na lista de revisores especificados. Isso pode ocorrer quando o proprietário do grupo é especificado como o revisor, mas o proprietário do grupo não existe ou o gerenciador é especificado como revisor, mas o gerenciador de um usuário não existe.
Revisores coleção accessReviewReviewerScope Define quem são os revisores. Se nenhum for especificado, a revisão será uma auto-revisão (os usuários revisam seu próprio acesso). A propriedade revisores só será atualizada se usuários individuais forem atribuídos como revisores. Consulte accessReviewReviewerScope.
stageSettings coleção accessReviewStageSettings Define quantos estágios cada instância de uma série de revisão de acesso terá. Os estágios serão criados sequencialmente com base na propriedade dependOn . Cada estágio pode ter um conjunto diferente de revisores, revisores de fallback e configurações. Somente revisores e revisores de fallback são atualizáveis. Consulte accessReviewStageSettings.
settings accessReviewScheduleSettings As configurações de uma série de revisão de acesso. Consulte accessReviewScheduleSettings.

Uma solicitação PUT espera que o objeto completo seja passado, o que inclui todas as propriedades graváveis, não apenas as propriedades que estão sendo atualizadas.

Resposta

Se for bem-sucedido, esse método retornará um código de 204 No Content resposta e nenhum corpo de resposta.

Exemplos

Este é um exemplo de atualização do displayName de uma série de revisão de acesso existente.

Solicitação

No corpo da solicitação, forneça uma representação JSON das novas propriedades do objeto accessReviewScheduleDefinition .

PUT https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/60860cdd-fb4d-4054-91ba-f75e04444aa6
Content-type: application/json

{
  "id": "60860cdd-fb4d-4054-91ba-f75e04444aa6",
  "displayName": "Test world UPDATED NAME!",
  "descriptionForAdmins": "Test world",
  "descriptionForReviewers": "Test world",
  "scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/b7a059cb-038a-4802-8fc9-b9d1ed0cf11f/transitiveMembers",
    "queryType": "MicrosoftGraph"
  },
  "instanceEnumerationScope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/b7a059cb-038a-4802-8fc9-b9d1ed0cf11f",
    "queryType": "MicrosoftGraph"
  },
  "reviewers": [],
  "settings": {
    "mailNotificationsEnabled": true,
    "reminderNotificationsEnabled": true,
    "justificationRequiredOnApproval": true,
    "defaultDecisionEnabled": false,
    "defaultDecision": "None",
    "instanceDurationInDays": 3,
    "autoApplyDecisionsEnabled": false,
    "recommendationsEnabled": true,
    "recurrence": {
      "pattern": {
        "type": "weekly",
        "interval": 1
      },
      "range": {
        "type": "noEnd",
        "startDate": "2020-09-15"
      }
    }
  }
}

Resposta

HTTP/1.1 204 No Content