Aangepaste velden en onderhoudsvensters bijwerken, automatisering uitvoeren en schrijfbewerkingen veilig opnieuw proberen.
De API en MCP ondersteunen in de wachtrij geplaatste taken, geplande stroom, agentverwijdering, eindpuntdiagnoses, opdrachtannulering en patchbeleid van derden. Hergebruik idempotentie-sleutels en controleer ontvangstbewijzen. Tijdelijke beheerdersreferenties worden eenmaal teruggegeven. Verkeersmonitoring vereist bestaande toestemming; facturering blijft in de toepassing.
Controleer uw machtigingen
Voorinstellingen selecteren individuele mogelijkheden; ze wijzigen het toegangsniveau niet. Nieuwe referenties in Instellingen gebruiken standaard FullAccess, maar alleen de geselecteerde mogelijkheden zijn toegestaan. Oudere referenties ReadWrite staan goedgekeurde wijzigingen in aangepaste velden en onderhoudsvensters toe. Automatisering en apparaatbeheer vereisen FullAccess plus hun specifieke mogelijkheden. Controleer GET /v1/operations/capabilities voordat u schrijft. Bedrijfsbereik en de huidige eigenaarsmachtigingen blijven van toepassing.
Voorkom dat een andere wijziging wordt overschreven
Lees het aangepaste veld en de versie ervan. Stuur uw nieuwe waarde en de versie die u hebt gelezen naar PATCH /v1/custom-fields/{fieldId}.. Een 409 version_conflict betekent dat iemand deze eerder heeft gewijzigd. Lees deze opnieuw en bepaal of uw update nog steeds geschikt is.
Probeer het veilig opnieuw
Voor POST /v1/maintenance-windows, stuur een Idempotency-Key-header. Herhaal na een onzeker resultaat dezelfde sleutel en body om het oorspronkelijke venster op te halen in plaats van een duplicaat te maken. Een gewijzigde body met dezelfde sleutel wordt geweigerd. DELETE /v1/maintenance-windows/{windowId} annuleert een venster.
Volg actiebonnen
Automatisering en beheer gebruiken idempotencyKey in de JSON-body en retourneren een bewerkingsbon. Completed betekent dat de aanvraagverwerker klaar is; controleer het resultaat of de domeinuitvoering om te zien of het apparaat de taak heeft voltooid. Controleer bij OutcomeUnknown de ontvangstbevestiging en de huidige status voordat u besluit wat u moet doen. Nooit automatisch opnieuw verzenden onder een nieuwe sleutel: de actie kan dubbel worden uitgevoerd.