Utilisation de l’API upsert Places dans Microsoft Graph

L’API upsert places vous permet de créer et de mettre à jour efficacement plusieurs emplacements en une seule opération asynchrone.

Scénarios pris en charge

Les scénarios suivants sont pris en charge lors de l’utilisation de l’API upsert places :

  • Créez plusieurs emplacements indépendants.
  • Créez des emplacements avec une hiérarchie, y compris de nouveaux emplacements enfants sous un emplacement existant.
  • Mettre à jour plusieurs emplacements indépendants.
  • Mettez à jour la hiérarchie des lieux, y compris le déplacement d’un emplacement existant sous un nouvel emplacement.

Comprendre la charge utile de la requête

Les considérations suivantes s’appliquent lors de l’exécution d’opérations de création ou de mise à jour en bloc sur des emplacements :

  • Créer ou mettre à jour : Places sans propriété id sont créés et les emplacements avec une propriété id sont mis à jour par ID.
  • Hiérarchie de lieux : utilisez la propriété children@delta pour créer ou mettre à jour des emplacements enfants au sein d’un emplacement parent. La propriété parentId est automatiquement définie pour les emplacements enfants.
  • Le mode affecté n’est pas encore pris en charge dans les emplacements d’upsert .
  • La mise à jour d’un emplacement enfant existant sous un emplacement parent existant à l’aide de children@delta propriété n’est pas prise en charge. Ils doivent être mis à jour séparément.

Accès concurrentiel au niveau du travail

L’accès concurrentiel au niveau du travail limite le nombre d’opérations upsert places qui peuvent s’exécuter simultanément au sein d’un locataire.

  • Seules trois opérations d’upsertes simultanées sont autorisées au niveau du locataire.
  • Si trois opérations sont déjà créées ou en cours, un autre PATCH appel d’API est rejeté avec un 429 Too Many Requests code de réponse.