용량이 확보될 때까지 배달을 대기시키세요.
동시 실행 한도나 최근 1시간의 시도 허용량이 부족하면 Letter나 Letterflow를 계정 대기열에서 기다리게 할 수 있습니다. 대기열은 리전, 대시보드 전송, API 실행, 해당 일정을 모두 공유합니다. 대기 중인 배달은 재시작 후에도 유지되며 자동으로 만료되지 않습니다.
대기할 수 있는 배달 선택
설정에서 대기열 환경설정을 저장하세요. 일정 페이지에서도 일정 전송의 대기열 사용 여부를 확인할 수 있습니다.
| 설정 | 기본값 | 동작 |
|---|---|---|
| 실행 용량이 부족하면 전송을 대기열에 추가 | 켜짐 | 대시보드와 연동 API 전송이 용량을 기다릴 수 있습니다. |
| 예약 전송에도 대기열 적용 | 꺼짐 | 기본 대기열 설정도 켜져 있으면 일정 전송을 대기열에 추가할 수 있습니다. |
기본 대기열 설정이 꺼져 있으면 일정 전송 설정을 조작할 수 없지만 저장된 값은 유지됩니다. 어느 설정이든 끄면 새 제출에만 적용되며 이미 수락된 대기 배달은 계속 유지됩니다.
해당 대기열 설정이 꺼져 있으면 실행 용량을 확보할 수 없는 제출은 즉시 용량 오류를 반환합니다. 먼저 대기 중인 작업이 있으면 새 배달에 필요한 시도 수가 더 적더라도 앞서 실행할 수 없습니다.
설정 →용량과 실행 승인 순서
각 Letterflow는 대기 항목 하나를 차지합니다. 대기 한도는 계정별 예외를 포함한 실제 동시 실행 한도의 두 배입니다.
| 플랜 | 동시 실행 | 대기 가능한 전송 수 |
|---|---|---|
| Tinkerer | 1 | 2 |
| Aspiring | 3 | 6 |
새 배달은 끝에 추가되며 표시된 순서대로 실행이 승인됩니다. 허용량, 계정 정책, 리전 가용성 때문에 막힌 항목도 위치를 유지합니다. 뒤의 항목이 추월할 수 없으므로 계속 진행하려면 막힌 항목을 이동하거나 제거하세요. 동시에 승인된 배달은 다른 순서로 완료될 수 있습니다.
대기열 한도가 줄어도 기존 항목은 유지됩니다. 항목 수가 줄어든 한도 이상인 동안 새 항목은 거부됩니다. 대기 용량을 늘려도 실행 처리량은 늘어나지 않습니다.
대기 중인 배달은 동시 실행 슬롯이나 시간당 시도 허용량을 사용하지 않습니다. 실행 승인 시 재시도, 리디렉션, 가능한 가장 긴 Letterflow 경로를 포함한 전체 실행 예산을 예약합니다. Letterflow는 실행 정산이 끝날 때까지 계정 슬롯 하나를 사용하며 내부 Letter가 이 대기열에 다시 들어가거나 계정 슬롯을 추가로 확보하지 않습니다.
용량이 바뀌면, 그리고 약 5초마다 실행 승인을 다시 시도합니다. 실행 제한 시간은 대기 시간과 별개로 승인 시점부터 시작됩니다. 무기한 대기가 성공을 보장하지는 않습니다. 잘못된 입력으로 실패하거나 제한으로 승인이 막힐 수 있으며 인증 정보나 요청한 작업이 오래되어 유효하지 않을 수 있습니다.
확인, 순서 변경, 제거
- 대기열을 여세요.
대시보드 사용량 패널에서 대기열을 클릭하세요. 대기 수/한도를 누르면 각 배달의 위치, 제출 출처, 대기 시간, 차단 이유가 표시됩니다.
- 위로 이동 또는 아래로 이동하세요.
대기 중인 배달의 실행 승인 순서를 바꿉니다. 순서 변경 요청이 도착하기 전에 대기열이 바뀌었다면 최신 순서를 덮어쓰지 않고 목록을 새로 고칩니다.
- 대기 중인 배달을 제거하세요.
제거에 성공한 배달은 실행되지 않습니다. 이미 실행이 승인되었다면 제거 시 충돌 오류가 발생하므로 배달 현황의 중지를 사용하세요. 승인된 작업을 중지해도 이미 외부로 전송된 작업은 되돌릴 수 없습니다.
같은 Letter나 Letterflow가 이미 실행 중이거나 대기 중이어도 새로 전송할 때마다 별도 배달이 생성됩니다. 같은 표시된 폼의 중복 클릭과 재전송은 기존 실행을 재사용합니다. 서로 다른 멱등성 키를 사용한 API 요청과 개별 일정 실행도 별도 배달을 생성합니다.
대기 중인 배달이 보존하는 내용
제출 시 실행 옵션과 리전 입력에 대한 참조가 고정됩니다. 이후 Letter, 배달 정책, Letterflow, 일정을 수정해도 수락된 배달은 바뀌지 않습니다. 수정한 설정을 사용하려면 대기 중인 배달을 제거하고 새로 제출하세요.
요청 내용은 지정된 실행 리전에 암호화되어 저장되며 Letterflow 정의는 Coordinator 리전에 남습니다. 대기열을 사용해도 이 내용이 Hub를 통해 이동하지 않습니다. 대기 중인 참조는 필요한 입력을 정리 작업으로부터 보호합니다. 제거하면 참조가 해제되지만 저장된 리소스나 승인된 작업에서 사용하는 입력은 계속 보호됩니다.
저장한 Letterflow나 필수 종속 리소스를 삭제하면 관련 대기 배달이 취소됩니다. 이미 승인된 실행은 보호된 스냅샷을 유지합니다. 단기 실행 권한은 승인 시 발급되므로 오래 기다려도 제출 시점의 만료된 권한에 의존하지 않습니다.
일정 실행 처리
일정 전송이 계정 대기열을 공유하려면 두 대기열 설정이 모두 켜져 있어야 합니다. 일정을 일시 중지하거나 삭제하면 대기 중인 실행은 취소되지만 이미 승인된 작업은 계속됩니다. 일정 수정은 향후 실행에 적용되며 이미 수락된 스냅샷에는 영향을 주지 않습니다.
일회성 및 횟수가 정해진 반복 일정
일정마다 최대 한 번의 실행만 대기할 수 있습니다. 대기는 반복 횟수를 소모하지 않습니다. 실행 승인 시 한 번을 소모하고 승인 시점부터 설정된 간격으로 다음 반복 시각을 계산합니다.
대기 중인 반복 실행을 제거하면 외부 전송 시도 없이 한 번을 건너뛰고 설정된 간격 후에 다음 남은 실행을 예약합니다. 대기 중인 일회성 실행을 제거하면 배달 없이 일정이 종료됩니다. 일시 중지된 일정은 자동으로 재개되지 않습니다.
Cron 일정
Cron 일정을 만들거나 수정할 때 이미 대기 중인 실행이 있는 경우의 동작을 선택하세요.
- 대기 중인 실행 한 건만 유지
- 기본값입니다. 원래 스냅샷과 대기열 위치를 유지하고 대기하는 동안 이후 실행 시각을 건너뜁니다.
- 각 실행을 대기열에 추가
- 공유 대기열 한도 내에서 도래가 확인된 실행 시각마다 별도의 스냅샷을 끝에 추가합니다.
일정 대기열이 꺼져 있어도 Cron 설정을 저장할 수 있지만 두 계정 설정이 모두 켜져 있어야 적용됩니다. 설정을 바꿔도 기존 항목이 합쳐지거나 제거되지 않습니다. 대기열이 가득 차면 새 Cron 실행을 건너뛰고 용량 부족을 기록합니다. 스케줄러가 중단된 동안 놓친 실행 시각은 소급하여 처리하지 않습니다.
연동 API의 대기 상태
새 제출은 대기 중인 경우도 202를 반환하며 멱등성 재요청은 200을 반환합니다. 수락된 키를 재전송하면 취소 후에도 같은 실행을 반환합니다. 새 배달에는 새 키를 사용하세요.
| 실행 상태 | 의미 |
|---|---|
waiting | 계정 용량을 기다리고 있으며 실행 실패가 아닙니다. |
queued | 실행이 승인되어 리전 실행을 기다리며 용량이 예약되어 있습니다. |
실행을 폴링하여 queue_position, wait_reason, admitted_at을 확인하세요. 대기열이 가득 차면 HTTP 429와 error.code=queue_full을 반환합니다. 순서 변경과 제거는 로그인한 대시보드 세션을 사용하며 연동 키에는 대기열 관리 권한이 추가되지 않습니다.
실행 요청 및 상태 확인 →