次の方法で共有

bulkUpload リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

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

一括アップロードを処理する Microsoft Entra 同期サービスの機能を表します。 詳細については、「 API 主導の受信プロビジョニングの概念」を参照してください。

メソッド

メソッド 戻り値の種類 説明
一括アップロードを実行する なし 同期ジョブを使用して新しい一括アップロードを実行します。

プロパティ

bulkUpload リソースの種類は、ペイロードで次のプロパティを受け入れます。

  • urn:ietf:params:scim:api:messages:2.0:BulkRequestに設定する必要があるルート レベルの schemas パラメーター。 必須。 次の JSON ブロックは、 schemas パラメーターの表現を示しています。

    "schemas": [
  "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
]

  • Operations パラメーターには、キーと値のペアの配列が含まれています。 各要求には、このパラメーターの下に最大 50 個のユーザー操作を含めることができます。 配列内の各オブジェクトには、次のキーと値のペアが 必要 です。

    • メソッド キーを に設定する必要があります POST

    注:

    メソッド キーが POST に設定されている場合、プロビジョニング サービスは、属性マッピング構成に基づいてターゲットに対して実行する適切な操作 (作成、更新、有効化、無効化) を決定します。 たとえば、{externalId,employeeId} を一致する識別子ペアとして設定している場合、プロビジョニング サービスは employeeId を持つユーザーが Microsoft Entra ID に存在するかどうかを確認します。 存在しない場合は、プロビジョニング サービスによってユーザーが作成されます。 存在する場合は、プロビジョニング サービスによってユーザー レコードが更新されます。

    • path キーは常に値に設定されます /Users
    • bulkId キーを一意の ID 値に設定します。 たとえば、データが人事ソースから送信される場合、この値を人事システムで一意であることが保証される employeeId に設定できます。
    • data オブジェクト。 必須です。 データ オブジェクトには、次のオブジェクトが必要です。
    • data オブジェクトの下のschemas配列には、それぞれ、コア ユーザー リソースとエンタープライズ ユーザー拡張機能の SCIM スキーマ URI を表すurn:ietf:params:scim:schemas:core:2.0:Userとurn:ietf:params:scim:schemas:extension:enterprise:2.0:Userのスキーマが必要です。 属性拡張の場合は、追加のカスタム SCIM スキーマ名を含めることができます。
    • externalId キーは、ソース システムの一意の識別子に設定されます。 たとえば、 employeeId 、 personId 、 studentIdなどです。

    次の JSON サンプルは 、Operations オブジェクトの例を示しています。

    {
    "method": "POST",
    "bulkId": "d63f4f30-a198-43db-a34d-f72bfa1f551e",
    "path": "/Users",
    "data": {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
      ],
      "externalId": "EMP1830"
  ... [You may include other SCIM attributes and extensions under the data object.]
    }
  }

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.bulkUpload"
}