次の方法で共有


accessReviewScheduleDefinition を更新する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

注:

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

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

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

アクセス許可

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

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

重要

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • グループまたはアプリのアクセス レビューを記述するには: ユーザー管理者ID ガバナンス管理者
  • Microsoft Entra ロールのアクセス レビューを記述するには: ID ガバナンス管理者特権ロール管理者

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」を参照してください。
backupReviewers (非推奨) accessReviewReviewerScope コレクション このプロパティは 、fallbackReviewers に置き換えられました。 ただし、 backupReviewers または fallbackReviewers を指定すると、同じ値が他のプロパティに自動的に設定されます。

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

応答

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

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

要求

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

PUT https://graph.microsoft.com/beta/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