次の方法で共有


bulkUpload リソースの種類

名前空間: microsoft.graph

一括アップロードを処理する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} を設定している場合、Microsoft Entra IDに employeeId を持つユーザーが存在する場合、プロビジョニング サービスはチェックします。 存在しない場合は、プロビジョニング サービスによってユーザーが作成されます。 存在する場合は、プロビジョニング サービスによってユーザー レコードが更新されます。

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

    次の 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"
}