Arbeiten mit der Upsert-Places-API in Microsoft Graph

Mit der Upsert-Orte-API können Sie mehrere Orte in einem einzigen asynchronen Vorgang effizient erstellen und aktualisieren.

Unterstützte Szenarien

Die folgenden Szenarien werden bei Verwendung der API für Upsert-Orte unterstützt:

• Erstellen Sie mehrere unabhängige Orte.
• Erstellen Sie Orte mit Hierarchie, einschließlich neuer untergeordneter Orte unter einem vorhandenen Ort.
• Aktualisieren sie mehrere unabhängige Orte.
• Aktualisieren Sie die Hierarchie der Orte, einschließlich des Verschiebens eines vorhandenen Orts unter einen neuen Ort.

Grundlegendes zur Anforderungsnutzlast

Die folgenden Überlegungen gelten beim Ausführen von Massenerstellungs- oder Aktualisierungsvorgängen an Orten:

• Erstellen und aktualisieren: Places ohne id-Eigenschaft werden erstellt, und Orte mit einer ID-Eigenschaft werden durch ID aktualisiert.
• Platzhierarchie: Verwenden Sie die eigenschaft children@delta , um untergeordnete Orte an einem übergeordneten Ort zu erstellen oder zu aktualisieren. Die parentId-Eigenschaft wird automatisch für untergeordnete Orte festgelegt.
• Der zugewiesene Modus wird an Upsert-Stellen noch nicht unterstützt.
• Es wird nicht unterstützt, einen vorhandenen untergeordneten Ort unter einem vorhandenen übergeordneten Ort mithilfe children@delta -Eigenschaft zu aktualisieren. Sie sollten separat aktualisiert werden.

Parallelität auf Auftragsebene

Parallelität auf Auftragsebene begrenzt die Anzahl von Vorgängen für Upsert-Orte, die gleichzeitig innerhalb eines Mandanten ausgeführt werden können.

• Auf Mandantenebene sind nur drei gleichzeitige Upsert-Vorgänge zulässig.
• Wenn bereits drei Vorgänge erstellt wurden oder ausgeführt werden, wird ein anderer PATCH API-Aufruf mit einem 429 Too Many Requests Antwortcode abgelehnt.

Verwandte Inhalte

• ressourcentyp "place"
• Upsert-Orte
• Vorgang abrufen
• Vorgänge auflisten