customDataProvidedResourceUploadSession オブジェクトを一覧表示する

名前空間: microsoft.graph

customDataProvidedResourceUploadSession オブジェクトとそのプロパティの一覧を取得します。

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

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

アクセス許可

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

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

ヒント

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

アプリのみのシナリオでは、呼び出し元のアプリに、 EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可の代わりに、前述のサポート対象ロールの 1 つを割り当てることができます。 カタログ所有者ロールの特権は、EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可よりも低くなります。

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

ヒント

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

アプリのみのシナリオでは、呼び出し元のアプリに、 EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可の代わりに、前述のサポート対象ロールの 1 つを割り当てることができます。 カタログ所有者ロールの特権は、EntitlementManagement.ReadWrite.All アプリケーションのアクセス許可よりも低くなります。

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

HTTP 要求

GET /identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするために、 $expand、 $filter、 $top、 $skip、 $orderby、 $count OData クエリ パラメーターをサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

入れ子になった $filter と $orderby の次のクエリ例は、customDataProvidedResourceFile 型のファイル リレーションシップでサポートされています。

プロパティ 演算子 例
name eq, ne $expand=files($filter=name eq 'building-a-access.csv')
size eq, ne, gt, ge, lt, le $expand=files($filter=size gt 1000000)
uploadedDateTime eq, ne, gt, ge, lt, le $expand=files($filter=uploadedDateTime ge 2026-01-01T00:00:00Z)

次の例に示すように、 name、 size、 uploadedDateTime プロパティも $orderby をサポートしています。

uploadedDateTime で並べ替えられたファイルを含むアップロード セッションを取得します。

GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$expand=files($orderby=uploadedDateTime desc)

サイズ (1 MB より大きい) でフィルター処理されたファイルを含むアップロード セッションを取得します。

GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$expand=files($filter=size gt 1000000)

ファイルを 名前で並べ替えたアップロード セッションを取得します。

GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$expand=files($orderby=name asc)

要求ヘッダー

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

要求本文

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

応答

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

例

要求

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

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions

応答

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/catalogs('3c9f2b1e-8a4d-4e7f-9d2a-6b3e1c7f5a9d')/resources('15eeb4df-bd15-4d8b-9679-e75791dbc1d9')/uploadSessions",
  "value": [
    {
      "@odata.type": "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
      "id": "2fa3bc17-de50-4f48-91f0-dd4aede5c424",
      "referenceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81",
      "status": "complete",
      "isUploadDone": true,
      "createdDateTime": "2026-03-24T21:34:56.220345Z",
      "stats": {
        "filesUploaded": 1,
        "totalBytesUploaded": 10331
      },
      "data": {
        "@odata.type": "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
        "reviewDefinitionId": "a89003b1-d457-4b8a-b060-42a3b6ad6c44",
        "reviewInstanceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81"
      }
    }
  ]
}
  • 最終更新: