次の方法で共有


承認の更新手順

名前空間: microsoft.graph

重要

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

approvalStep オブジェクトに対して承認または拒否の決定を適用します。

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

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

アクセス許可

次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

エンタイトルメント管理のためにこの API を呼び出す際に必要なアクセス許可

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

ヒント

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、次のいずれかのオプションを使用して、サポートされているロールのアクセス許可を持つ管理者ロールも割り当てる必要があります。

  • アクセス パッケージのポリシーの specificAllowedTargets プロパティで指定されているユーザー。 これは最小限の特権オプションです
  • この操作で最小特権ロールがサポートされている エンタイトルメント管理システムの その他の特権ロール:
    • パッケージ割り当てマネージャーにアクセスする
    • Access パッケージ マネージャー
    • カタログ所有者
  • この操作では、次の最小特権ロールがサポートされている、より特権の高いMicrosoft Entraロール。
    • ID ガバナンス管理者

アプリのみのシナリオでは、呼び出し元のアプリに、 EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可ではなく、前述のサポートされているロールのいずれかを割り当てることができます。 アクセス パッケージのポリシーの specificAllowedTargets プロパティで指定されたユーザーは、 EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可よりも特権が低くなります。

詳細については、「エンタイトルメント管理での委任とロール」および「エンタイトルメント管理でパッケージ マネージャーにアクセスするためのアクセス ガバナンスを委任する方法」を参照してください。

Microsoft Entra ロールの PIM の場合

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

グループに対して PIM 用にこの API を呼び出す場合に必要なアクセス許可

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

HTTP 要求

エンタイトルメント管理で承認の決定を更新するには:

PATCH /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps/{id}

MICROSOFT ENTRA ロールの PIM の承認決定を更新するには:

PATCH /roleManagement/directory/roleAssignmentApprovals/{id}/steps/{id}

グループの PIM の承認決定を更新するには:

PATCH /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps/{id}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

次の表は、このメソッドに必要なプロパティを示しています。

プロパティ 説明
reviewResult String 承認者の決定。 可能な値は、ApproveDeny です。
ジャスティフィケーション String 承認者の決定に関連する正当な理由。

応答

成功した場合、このメソッドは応答本文で 204 No Content 応答コードを返します。 ただし、呼び出し元に適切なアクセス許可がない場合、メソッドは 403 Forbidden 応答コードを返すか、承認 ID が見つからない場合は、 404 Not foundを返します。 要求が同じ承認ステージで別の承認者によって既に承認されている場合、メソッドは応答本文で 409 Conflict を返します。

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/steps/d4fa4045-4716-436d-aec5-57b0a713f095

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 204 No Content
Content-Type: application/json