Обновите пользовательские поля и окна обслуживания, запустите автоматизацию и безопасно повторите запись.
API и MCP поддерживают очередные задачи, запланированное включение/выключение питания, удаление агента, диагностику конечной точки, отмену команд и политики сторонних патчей. Повторно используйте ключи идемпотентности и проверяйте квитанции. Временные учетные данные администратора возвращаются один раз. Мониторинг трафика требует существующего права; выставление счетов остается в приложении.
Проверьте свои права доступа.
Предустановки выбирают отдельные возможности; они не изменяют уровень доступа. Новые учетные данные в настройках по умолчанию используют FullAccess, но разрешены только выбранные возможности. Более старые учетные данные ReadWrite позволяют вносить утвержденные изменения в пользовательские поля и окна обслуживания. Для автоматизации и управления устройствами необходимы FullAccess и их специфические возможности. Перед записью проверьте GET и /v1/operations/capabilities. Область действия компании и права текущего владельца остаются в силе.
Избегайте перезаписи других изменений.
Прочитайте пользовательское поле и его версию. Отправьте новое значение и версию, которую вы прочитали, в PATCH /v1/custom-fields/{fieldId}.. Ошибка 409 version_conflict означает, что кто-то изменил его первым. Прочитайте его еще раз и решите, подходит ли ваше обновление.
Повторите попытку безопасно.
Для POST /v1/maintenance-windows отправьте заголовок Idempotency-Key. После получения неопределенного результата повторите тот же ключ и тело, чтобы получить исходное окно, а не создавать дубликат. Измененное тело с тем же ключом отклоняется. DELETE /v1/maintenance-windows/{windowId} отменяет окно.
Следуйте квитанциям о действиях.
Запись в автоматизацию и управление использует idempotencyKey в теле JSON и возвращает квитанцию об операции. Completed означает, что обработчик запроса завершил работу; проверьте результат или выполнение домена, чтобы узнать, завершило ли устройство работу. Для OutcomeUnknown проверьте получение и текущее состояние, прежде чем принимать решение о дальнейших действиях. Никогда не отправляйте запрос автоматически под новым ключом: действие может выполниться дважды.