Partager via

type de ressource bulkUpload

  • Article

Espace de noms: microsoft.graph

Représente la capacité du service de synchronisation Microsoft Entra à traiter les chargements en bloc. Pour plus d’informations, consultez Concepts d’approvisionnement entrant piloté par l’API.

Méthodes

Méthode Type de retour Description
Effectuer un chargement en bloc Aucune Effectuez un nouveau chargement en bloc à l’aide du travail de synchronisation.

Propriétés

Le type de ressource bulkUpload accepte les propriétés suivantes dans la charge utile :

  • Paramètre schemas au niveau racine qui doit être défini sur urn:ietf:params:scim:api:messages:2.0:BulkRequest. Obligatoire. Le bloc JSON suivant montre une représentation du paramètre schemas .

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

  • Le paramètre Operations contient un tableau de paires clé-valeur. Chaque requête peut contenir un maximum de 50 opérations utilisateur sous ce paramètre. Les paires clé-valeur suivantes sont requises dans chaque objet du tableau.

    • la clé de méthode doit être définie sur POST

    Remarque

    Lorsque la clé de méthode est définie POSTsur , le service d’approvisionnement détermine l’opération appropriée à effectuer sur la cible (créer/mettre à jour/activer/désactiver) en fonction de la configuration du mappage d’attributs. Par exemple, si vous avez défini {externalId,employeeId} comme paire d’identificateurs correspondante, le service d’approvisionnement case activée si un utilisateur avec l’employeeId existe dans Microsoft Entra ID. S’il n’existe pas, le service d’approvisionnement crée l’utilisateur. S’il existe, le service d’approvisionnement met à jour l’enregistrement utilisateur.

    • clé de chemin d’accès toujours définie sur la valeur /Users
    • Clé bulkId définie sur une valeur d’ID unique. Par exemple, si les données proviennent d’une source RH, vous pouvez définir cette valeur sur employeeId laquelle il est garanti qu’elles soient uniques dans le système RH.
    • objet de données . Obligatoire. L’objet de données doit avoir les objets suivants :
    • Le schemas tableau sous l’objet data doit avoir les schémas : urn:ietf:params:scim:schemas:core:2.0:User et urn:ietf:params:scim:schemas:extension:enterprise:2.0:User représentant l’URI de schéma SCIM pour la ressource utilisateur principale et l’extension utilisateur entreprise, respectivement. Vous pouvez inclure des noms de schéma SCIM personnalisés supplémentaires en cas d’extensions d’attribut.
    • Clé externalId définie sur un identificateur unique dans le système source. Par exemple, employeeId ou personId ou studentId.

    L’exemple JSON suivant montre un exemple d’objet 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.]
    }
  }

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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