割り当てを一覧表示する

  • [アーティクル]

名前空間: microsoft.graph

エンタイトルメント管理Microsoft Entraで、accessPackageAssignment オブジェクトの一覧を取得します。

ディレクトリ全体の管理者の場合、結果の一覧には、呼び出し元がすべてのカタログとアクセス パッケージにわたって読み取りアクセスできるすべての割り当て(現在および期限切れ)が含まれます。 呼び出し元が、カタログ固有の委任された管理ロールにのみ割り当てられている委任されたユーザーの代理である場合、要求では、次のような $filter=accessPackage/id eq 'a914b616-e04e-476b-aa37-91038f0b165b'特定のアクセス パッケージを示すフィルターを指定する必要があります。

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

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

アクセス許可

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

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

HTTP 要求

GET /identityGovernance/entitlementManagement/assignments

クエリ パラメーター

このメソッドは、応答のカスタマイズに $select役立つ、 $filter、および $expand OData クエリ パラメーターをサポートします。

ユーザーまたはアプリがカタログ固有の管理ロールにのみ割り当てられている場合、要求では、次のような $filter=accessPackage/id eq 'a914b616-e04e-476b-aa37-91038f0b165b'特定のアクセス パッケージを示すフィルターを指定する必要があります。

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

  • ターゲットサブジェクトとアクセス パッケージを返すには、 を含めます $expand=target,accessPackage。
  • 配信された割り当てのみを取得するには、クエリ $filter=state eq 'Delivered'を含めることができます。
  • 特定のユーザーの割り当てのみを取得するには、そのユーザーのオブジェクト ID を対象とする割り当てを含むクエリを含めることができます。 $expand=target&$filter=target/objectid+eq+'7deff43e-1f17-44ef-9e5f-d516b0ba11d4'
  • 特定のユーザーと特定のアクセス パッケージに対する割り当てのみを取得するには、そのアクセス パッケージを対象とする割り当てと、そのユーザー $expand=accessPackage,target&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea' and target/objectid eq '7deff43e-1f17-44ef-9e5f-d516b0ba11d4'のオブジェクト ID を含むクエリを含めることができます。

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

要求ヘッダー

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

要求本文

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

応答

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

例

要求

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

応答

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

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

{
  "value": [
    {
      "id": "2a353749-3749-2a35-4937-352a4937352a",
      "state": "delivered",
      "status": "Delivered",
      "expiredDateTime": "2019-04-25T23:45:40.42Z",
      "schedule": {
        "@odata.type": "microsoft.graph.entitlementManagementSchedule"
      }
    }
  ]
}