名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
グループ メンバーシップまたは所有権の割り当て要求に対するカスタム拡張機能の評価の結果を使用して、 privilegedAccessGroupAssignmentScheduleRequest オブジェクトを更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup | 注意事項なし。 |
重要
職場または学校アカウントを使用して委任されたアクセスの場合、サインインしたユーザーはグループの所有者またはメンバーであるか、サポートされている Microsoft Entra ロール、またはこの操作に必要なアクセス許可を付与するカスタム ロールが割り当てられている必要があります。 この操作では、必要最小限の特権のみを提供する次の組み込みロールがサポートされます。
- 役割割り当て可能なグループの場合: 特権ロール管理者
- 役割を割り当てられないグループの場合: ディレクトリ作成者、 グループ管理者、アイ デンティティ管理管理者、または ユーザー管理者
呼び出し元ユーザーの役割の割り当ては、ディレクトリ レベルでスコープを設定する必要があります。
グループを管理するアクセス許可を持つその他のロール (役割を割り当てできない Microsoft 365 グループの Exchange 管理者など) と、管理単位レベルでスコープが指定された割り当てを持つ管理者は、グループ API を介してグループを管理し、グループ API の PIM を介して Microsoft Entra PIM に加えられた変更をオーバーライドできます。
HTTP 要求
POST /identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequestId}/updateRequest
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
| evaluationId | 文字列 | カスタム拡張機能評価の一意識別子。 省略可能。 |
| 評価結果 | 評価結果 | カスタム拡張機能の評価結果。 使用可能な値: approved、denied、unknownFutureValue。 省略可能。 |
| 理由 | 文字列 | 評価結果の理由。 省略可能。 |
| scheduleInfo | requestSchedule | グループ割り当ての更新されたスケジュール。 省略可能。 |
応答
成功した場合、このアクションは応答本文で 200 OK 応答コードと privilegedAccessGroupAssignmentScheduleRequest オブジェクトを返します。
例
要求
次の例では、承認されたカスタム拡張機能の評価を送信します。
POST https://graph.microsoft.com/beta/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/f4b57a8c-da56-4ae0-8aef-65c3a043dab4/updateRequest
Content-Type: application/json
{
"evaluationId": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
"evaluationOutcome": "approved",
"reason": "The ticket information is valid.",
"scheduleInfo": {
"startDateTime": "2026-09-16T19:00:00Z",
"expiration": {
"type": "afterDuration",
"duration": "PT8H"
}
}
}
応答
次の例は応答を示しています。 読みやすさのために応答が短縮される場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.privilegedAccessGroupAssignmentScheduleRequest",
"id": "f4b57a8c-da56-4ae0-8aef-65c3a043dab4",
"status": "Granted",
"action": "selfActivate",
"principalId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
"accessId": "member",
"groupId": "55aa55aa-bb66-cc77-dd88-99ee99ee99ee",
"justification": "Respond to the service incident"
}