bulkUpload-Ressourcentyp

Artikel
04/09/2024

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt die Fähigkeit des Microsoft Entra-Synchronisierungsdiensts dar, Massenuploads zu verarbeiten. Weitere Informationen finden Sie unter API-gesteuerte Konzepte für die eingehende Bereitstellung.

Methoden

Methode	Rückgabetyp	Beschreibung
Ausführen von bulkUpload	Keine	Führen Sie mithilfe des Synchronisierungsauftrags einen neuen Massenupload durch.

Eigenschaften

Der Ressourcentyp bulkUpload akzeptiert die folgenden Eigenschaften in der Nutzlast:

Der Schemas-Parameter auf Stammebene, der auf urn:ietf:params:scim:api:messages:2.0:BulkRequestfestgelegt werden muss. Erforderlich. Der folgende JSON-Block zeigt eine Darstellung des Schemas-Parameters .
```
"schemas": [
  "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
]
```
Der Operations-Parameter enthält ein Array von Schlüssel-Wert-Paaren. Jede Anforderung kann maximal 50 Benutzervorgänge unter diesem Parameter enthalten. Die folgenden Schlüssel-Wert-Paare sind in jedem Objekt im Array erforderlich .
- Der Methodenschlüssel muss auf festgelegt werden. POST
Hinweis

Wenn der Methodenschlüssel auf POSTfestgelegt ist, bestimmt der Bereitstellungsdienst basierend auf der Attributzuordnungskonfiguration den richtigen Vorgang für das Ziel (erstellen/aktualisieren/aktivieren/deaktivieren). Wenn Sie beispielsweise {externalId,employeeId} als übereinstimmende Bezeichnerpaar festgelegt haben, überprüft der Bereitstellungsdienst, ob ein Benutzer mit der employeeId in Microsoft Entra ID vorhanden ist. Wenn er nicht vorhanden ist, erstellt der Bereitstellungsdienst den Benutzer. Falls vorhanden, aktualisiert der Bereitstellungsdienst den Benutzerdatensatz.
- Pfadschlüssel immer auf den Wert festgelegt /Users
- BulkId-Schlüssel , der auf einen eindeutigen ID-Wert festgelegt ist. Wenn die Daten beispielsweise aus einer HR-Quelle stammen, können Sie diesen Wert employeeId auf festlegen, der im HR-System garantiert eindeutig ist.
- Datenobjekt . Erforderlich. Das Datenobjekt muss über die folgenden Objekte verfügen:
- Das schemas Array unter dem data -Objekt muss über die Schemas und urn:ietf:params:scim:schemas:extension:enterprise:2.0:User verfügen, urn:ietf:params:scim:schemas:core:2.0:User die den SCIM-Schema-URI für die Core User Resource bzw. die Enterprise User Extension darstellen. Sie können zusätzliche benutzerdefinierte SCIM-Schemanamen bei Attributerweiterungen einschließen.
- externalId-Schlüssel , der auf einen eindeutigen Bezeichner im Quellsystem festgelegt ist. Beispiel: employeeId oder personId oder studentId.
Das folgende JSON-Beispiel zeigt ein Beispiel für ein Operations-Objekt .
```
{
    "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.]
    }
  }    
```

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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