bulkUpload リソースの種類

[アーティクル]
07/23/2024

名前空間: 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"
}

次の方法で共有