사용자 정의 필드 및 유지 관리 기간을 업데이트하고 자동화를 실행한 다음 쓰기 작업을 안전하게 다시 시도합니다.
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}는 창을 취소합니다.
작업 영수증을 따르세요.
자동화 및 관리 쓰기는 JSON 본문에 idempotencyKey를 사용하고 작업 영수증을 반환합니다. Completed 오류는 요청 처리가 완료되었음을 의미합니다. 장치가 작업을 완료했는지 확인하려면 결과 또는 도메인 실행을 확인하십시오. OutcomeUnknown 오류의 경우, 수신 및 현재 상태를 검토한 후 조치를 결정하십시오. 새 키로 자동 재전송하지 마십시오. 작업이 두 번 실행될 수 있습니다.