Cập nhật các trường tùy chỉnh và cửa sổ bảo trì, chạy tự động hóa và thử lại ghi một cách an toàn.
API và MCP hỗ trợ các tác vụ đang xếp hàng, lập lịch nguồn điện, gỡ cài đặt agent, chẩn đoán điểm cuối, hủy lệnh và các chính sách vá lỗi của bên thứ ba. Tái sử dụng các khóa idempotency và kiểm tra biên nhận. Thông tin đăng nhập quản trị tạm thời được trả về một lần. Giám sát lưu lượng yêu cầu quyền hiện có; việc thanh toán vẫn giữ trong ứng dụng.
Kiểm tra quyền của bạn
Các thiết lập sẵn chọn các khả năng riêng lẻ; chúng không thay đổi cấp độ truy cập. Thông tin đăng nhập mới trong Cài đặt sử dụng FullAccess theo mặc định, nhưng chỉ các khả năng đã chọn mới được cho phép. Thông tin đăng nhập ReadWrite cũ hơn cho phép các thay đổi trường tùy chỉnh và bảo trì đã được phê duyệt. Tự động hóa và điều khiển thiết bị cần FullAccess cộng với các khả năng cụ thể của chúng. Kiểm tra GET /v1/operations/capabilities trước khi ghi. Phạm vi công ty và quyền của chủ sở hữu hiện tại vẫn được áp dụng.
Tránh ghi đè lên một thay đổi khác
Đọc trường tùy chỉnh và phiên bản của nó. Gửi giá trị mới và phiên bản bạn đã đọc đến PATCH /v1/custom-fields/{fieldId}.. Mã lỗi 409 version_conflict có nghĩa là ai đó đã thay đổi nó trước. Hãy đọc lại và quyết định xem bản cập nhật của bạn có còn phù hợp hay không.
Thử lại một cách an toàn
Đối với POST /v1/maintenance-windows, hãy gửi tiêu đề Idempotency-Key. Sau khi có kết quả không chắc chắn, hãy lặp lại cùng một khóa và nội dung để khôi phục cửa sổ gốc thay vì tạo bản sao. Nội dung đã thay đổi với cùng một khóa sẽ bị từ chối. DELETE /v1/maintenance-windows/{windowId} hủy một cửa sổ.
Theo dõi biên nhận hành động
Tự động hóa và quản lý ghi sử dụng idempotencyKey trong nội dung JSON và trả về biên nhận hoạt động. Completed có nghĩa là trình xử lý yêu cầu đã hoàn tất; hãy kiểm tra kết quả hoặc quá trình chạy miền để biết thiết bị đã hoàn thành công việc hay chưa. Đối với OutcomeUnknown, hãy kiểm tra biên nhận và trạng thái hiện tại trước khi quyết định phải làm gì. Không bao giờ tự động gửi lại bằng khóa mới: hành động có thể chạy hai lần.