Mettez à jour les champs personnalisés et les fenêtres de maintenance, exécutez l'automatisation et réessayez les écritures en toute sécurité.
L'API et le MCP prennent en charge les travaux en file d'attente, l'alimentation planifiée, la désinstallation de l'agent, le diagnostic des points de terminaison, l'annulation de commande et les politiques de correctifs tiers. Réutilisez les clés d'idempotence et inspectez les reçus. Les identifiants administrateur temporaires sont retournés une seule fois. La surveillance du trafic nécessite un droit existant ; la facturation reste dans l'application.
Vérifiez vos autorisations.
Les préréglages sélectionnent des fonctionnalités individuelles ; ils ne modifient pas le niveau d'accès. Les nouvelles informations d'identification dans les Paramètres utilisent FullAccess par défaut, mais seules les fonctionnalités sélectionnées sont autorisées. Les anciennes informations d'identification ReadWrite permettent les modifications approuvées des champs personnalisés et de la maintenance. L'automatisation et le contrôle des périphériques nécessitent FullAccess ainsi que leurs fonctionnalités spécifiques. Vérifiez GET et /v1/operations/capabilities avant d'écrire. La portée de l'entreprise et les autorisations du propriétaire actuel s'appliquent toujours.
Évitez d'écraser une autre modification.
Lisez le champ personnalisé et sa version. Envoyez votre nouvelle valeur et la version lue à PATCH et /v1/custom-fields/{fieldId}.. Une erreur 409 (version_conflict) signifie que quelqu'un l'a déjà modifié. Relisez le message et déterminez si votre mise à jour est toujours appropriée.
Réessayez en toute sécurité.
Pour POST et /v1/maintenance-windows, envoyez un en-tête Idempotency-Key. En cas de résultat incertain, répétez la même clé et le même corps pour récupérer la fenêtre d'origine plutôt que d'en créer une copie. Un corps modifié avec la même clé est rejeté. DELETE et /v1/maintenance-windows/{windowId} annulent une fenêtre.
Suivre les accusés de réception d'actions.
Les écritures d'automatisation et de gestion utilisent idempotencyKey dans le corps de JSON et renvoient un accusé de réception d'opération. Completed indique que le gestionnaire de requêtes a terminé ; vérifiez le résultat ou l'exécution du domaine pour savoir si le périphérique a terminé le travail. Pour OutcomeUnknown, examinez l'accusé de réception et l'état actuel avant de décider de la marche à suivre. Ne jamais renvoyer automatiquement avec une nouvelle clé : l’action pourrait s’exécuter deux fois.