Update approvalStep

名前空間: microsoft.graph

重要

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

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

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

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

アクセス許可

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

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

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

ヒント

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

  • アクセス パッケージのポリシーの specificAllowedTargets プロパティで指定されたユーザー。 これは最低特権オプションです
  • この操作で最低特権ロールがサポートされている、 権利管理システム内の その他の特権ロール:
    • アクセス パッケージの割り当てマネージャー
    • アクセス パッケージのマネージャー
    • カタログ所有者
  • より多くの特権を持つ Microsoft Entra ロール。この操作では次の最小特権ロールがサポートされています:
    • Identity Governance 管理者

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

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

PIM for Microsoft Entra ロールの場合

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

PIM for Groups のためにこの API を呼び出すために必要なアクセス許可

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

HTTP 要求

資格管理で承認の決定を更新するには:

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

Microsoft Entra ロールの PIM で承認の決定を更新するには:

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

PIM for Groups で承認の決定を更新するには:

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

要求ヘッダー

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

要求本文

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

プロパティ 説明
reviewResult 文字列 承認者の決定。 可能な値は ApproveDeny です。
正当な理由 文字列 承認者の決定に関連する正当な理由。

応答

成功した場合、このメソッドは応答本文で 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