Share via


accessReviewScheduleDefinition を更新する

名前空間: microsoft.graph

既存の accessReviewScheduleDefinition オブジェクトを更新して、そのプロパティの 1 つ以上を変更します。

注:

accessReviewScheduleDefinition に対して行われた更新は、将来のインスタンスにのみ適用されます。 現在実行中のインスタンスは更新できません。 さらに、この API は、accessReviewInstance レベルで決定を含むプロパティを更新するためのものではありません。 インスタンスの詳細については、「 accessReviewInstance 」を参照してください。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) AccessReview.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション AccessReview.ReadWrite.All 注意事項なし。

HTTP 要求

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

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-type application/json. 必須です。

要求本文

要求本文で、 accessReviewScheduleDefinition オブジェクトの JSON 表現を指定します。

次の表は、accessReviewScheduleDefinition を更新するために受け入れられたプロパティを示しています。

プロパティ 説明
descriptionForAdmins String 管理者に提供されるレビューのコンテキスト。
descriptionForReviewers String レビュー担当者に提供されるレビューのコンテキスト。
displayName String アクセス レビュー シリーズの名前。
fallbackReviewers accessReviewReviewerScope コレクション 指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されるフォールバック レビュー担当者の一覧を定義するために使用されるレビュー担当者スコープのコレクション。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。
レビュー accessReviewReviewerScope コレクション レビュー担当者を定義します。 何も指定されていない場合、レビューは自己レビューです (ユーザーは自分のアクセス権を確認します)。 レビュー担当者プロパティは、個々のユーザーがレビュー担当者として割り当てられている場合にのみ更新できます。 accessReviewReviewerScope に関するページを参照してください。
stageSettings accessReviewStageSettings コレクション アクセス レビュー シリーズの各インスタンスに含まれるステージの数を定義します。 ステージは dependsOn プロパティに基づいて順番に作成されます。 各ステージには、レビュー担当者、フォールバック レビュー担当者、設定のセットが異なる場合があります。 レビュー担当者とフォールバック レビュー担当者のみが更新可能です。 accessReviewStageSettings に関するページを参照してください。
settings accessReviewScheduleSettings アクセス レビュー シリーズの設定。 「accessReviewScheduleSettings」を参照してください。

PUT 要求では、更新されるプロパティだけでなく、すべての書き込み可能なプロパティを含む、完全なオブジェクトが渡されることを想定しています。

応答

成功した場合、このメソッドは応答コードを 204 No Content 返し、応答本文は返しません。

これは、既存のアクセス レビュー シリーズの displayName を更新する例です。

要求

要求本文で、 accessReviewScheduleDefinition オブジェクトの新しいプロパティの JSON 表現を指定します。

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"
      }
    }
  }
}

応答

HTTP/1.1 204 No Content