Cloudflare Workflows, 실행 인스턴스 개별·최대 100개 일괄 삭제 지원

핵심 요약

Cloudflare Workflows가 실행 인스턴스와 저장된 상태를 개별 또는 최대 100개까지 일괄 삭제할 수 있는 기능을 추가했습니다. Workflows API와 Wrangler 4.125.0 이상에서 사용할 수 있으며, 인스턴스를 삭제하면 저장된 상태가 해제되고 현재 실행도 중단됩니다.

주요 변경

• 단일 인스턴스는 핸들의 delete() 메서드로 삭제할 수 있습니다.
• 여러 인스턴스는 Workflow 바인딩의 deleteBatch()로 한 번에 최대 100개까지 처리할 수 있습니다.
• 일괄 삭제 결과에는 성공한 ID와 인스턴스별 오류가 반환되며, 존재하지 않는 ID는 오류로 처리됩니다.
• 중복 ID도 100개 제한에 포함되지만 실제 삭제는 한 번 수행되고 입력 위치별 결과가 반환됩니다.
• Wrangler 4.125.0 이상에서는 개별 ID, JSON 파일, latest, 로컬 wrangler dev 세션의 --local 옵션을 이용해 인스턴스를 삭제할 수 있습니다.

개발자 영향

장시간 실행되거나 실패 후 남아 있는 Workflow 인스턴스를 API·CLI에서 직접 정리할 수 있어 운영 자동화가 단순해집니다. 실행 중인 인스턴스를 삭제하면 현재 실행도 중단되므로, 정리 작업을 자동화할 때는 삭제 대상 ID를 검증해야 합니다. Workflow가 자기 자신의 인스턴스를 삭제하는 경우 await instance.delete() 중 실행이 멈추며 이후 코드는 실행되지 않습니다.

발표 시각(KST): 2026년 9월 17일 · 세부 시각 미공개

원문 출처 보기 →