bulkUpload リソースの種類

[アーティクル]
04/09/2024

名前空間: microsoft.graph

重要

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

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

メソッド

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

プロパティ

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 キーは、ソースシステムの一意の識別子に設定されます。たとえば、 employeeId や personIdstudentIdなどです。
次の 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"
}