Benutzerdefinierte Felder und Wartungsfenster aktualisieren, Automatisierungen ausführen und Schreibvorgänge sicher wiederholen.
Die API und MCP unterstützen geplante Jobs, geplante Strombefehle, Agent-Deinstallation, Endpunktdiagnosen, Befehlsstornierung und Drittanbieter-Patch-Richtlinien. Wiederverwenden von Idempotenzschlüsseln und Prüfen von Belegen. Vorübergehende Administrator-Anmeldeinformationen werden einmal zurückgegeben. Die Verkehrsüberwachung erfordert eine bestehende Berechtigung; die Abrechnung bleibt in der Anwendung.
Berechtigungen prüfen
Voreinstellungen wählen einzelne Funktionen aus; sie ändern nicht die Zugriffsebene. Neue Anmeldeinformationen in den Einstellungen verwenden standardmäßig FullAccess, jedoch sind nur die ausgewählten Funktionen zulässig. Ältere Anmeldeinformationen (ReadWrite) erlauben genehmigte Änderungen an benutzerdefinierten Feldern und Wartungsfenstern. Automatisierung und Gerätesteuerung benötigen FullAccess sowie ihre spezifischen Funktionen. GET und /v1/operations/capabilities vor dem Schreiben prüfen. Der Unternehmensbereich und die Berechtigungen des aktuellen Besitzers gelten weiterhin.
Vermeiden, eine andere Änderung zu überschreiben
Benutzerdefiniertes Feld und seine Version lesen Senden Sie Ihren neuen Wert und die gelesene Version an PATCH /v1/custom-fields/{fieldId}.. Ein 409 version_conflict bedeutet, dass die Daten bereits geändert wurden. Lesen Sie die Daten erneut und entscheiden Sie, ob Ihre Aktualisierung noch zulässig ist.
: Sicher wiederholen
: Senden Sie für POST /v1/maintenance-windows einen Idempotency-Key-Header. Wiederholen Sie nach einem unklaren Ergebnis denselben Schlüssel und denselben Body, um das ursprüngliche Fenster wiederherzustellen, anstatt ein Duplikat zu erstellen. Ein geänderter Body mit demselben Schlüssel wird abgelehnt. DELETE /v1/maintenance-windows/{windowId} bricht ein Fenster ab.
: Aktionsbestätigungen folgen
: Automatisierungs- und Verwaltungsschreibvorgänge verwenden idempotencyKey im JSON-Body und geben eine Vorgangsbestätigung zurück. Completed bedeutet, dass die Anfrageverarbeitung abgeschlossen ist. Überprüfen Sie das Ergebnis oder den Domänenlauf, um festzustellen, ob das Gerät die Arbeit beendet hat. Bei OutcomeUnknown prüfen Sie die Empfangsbestätigung und den aktuellen Status, bevor Sie weitere Schritte einleiten. Senden Sie niemals automatisch mit einem neuen Schlüssel erneut: Die Aktion könnte zweimal ausgeführt werden.