割り当ての一覧表示Requests

  • [アーティクル]

名前空間: microsoft.graph

エンタイトルメント管理Microsoft Entraで、accessPackageAssignmentRequest オブジェクトの一覧を取得します。 結果の一覧には、すべてのカタログとアクセス パッケージにわたって、呼び出し元が読み取りアクセスできるすべての割り当て要求 (現在および期限切れ) が含まれます。

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

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

アクセス許可

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

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

HTTP 要求

GET /identityGovernance/entitlementManagement/assignmentRequests

クエリ パラメーター

このメソッドは、応答のカスタマイズに $select役立つ、および $expand$filter OData クエリ パラメーターをサポートします。 accessPackageAssignmentRequest のすべての属性がフィルター処理でサポートされているわけではありません。

ユーザーまたはアプリケーションに特定のカタログまたはカタログ内のアクセス許可しかない場合は、 などの $expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea'アクセス パッケージを指定するフィルターをクエリに含める必要があります。

クエリ パラメーターを使用するシナリオの例

  • 特定の日付の後に作成された要求を取得するには、クエリに を含めます $filter=createdDateTime gt 2022-04-01T00:00:01Z 。
  • 各要求のアクセス パッケージを取得するには、クエリに を含めます $expand=accessPackage 。
  • 結果の割り当てを取得するには、クエリに を含めます $expand=assignment 。
  • 要求元の詳細を取得するには、クエリに を含めます $expand=requestor 。

一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

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

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の accessPackageAssignmentRequest オブジェクトのコレクションを返します。

例

要求

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests

応答

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "7999249e-249e-7999-9e24-99799e249979",
      "requestType": "userAdd",
      "state": "delivered",
      "status": "Delivered",
      "createdDateTime": "2019-10-25T22:55:11.623Z",
      "completedDateTime": "2019-10-26T22:55:11.623Z",
      "schedule": {
        "@odata.type": "microsoft.graph.entitlementManagementSchedule"
      }
    }
  ]
}