idempotencyKey는 제출에 선택적으로 넣는 문자열입니다. 같은 키로 다시 보내면 첫 제출이 만든 태스크를 받으며, 새 작업이 큐에 들어가거나 새 크레딧 보류가 걸리지 않습니다.
엔드포인트별 반복 키 처리
단건 엔드포인트는 명시적 생성 의미를 유지합니다. 이미 있는 태스크를 만들라고 요청했으므로 충돌을 받습니다. 오류의
error.details.taskId에 기존 태스크 id가 있으므로, 제출 응답을 받지 못했어도 그 id로 결과를 조회할 수 있습니다.
위치 그리드
그리드의idempotencyKey는 그리드 id가 됩니다(생략하면 UUID가 생성됩니다). 각 지점의 태스크 키는 <grid id>:r<row>c<col>입니다. 같은 id로 같은 그리드를 다시 보내면 기존 지점을 반환하고 없는 지점만 받습니다. 같은 id로 중심, 크기, 반경이 다른 그리드를 보내면 좌표가 다른 지점은 RESOURCE_ALREADY_EXISTS로 실패합니다. 새 그리드에는 새 키를 쓰세요.
범위와 길이
키는 계정 단위로 적용됩니다. 다른 계정이 같은 문자열을 써도 충돌하지 않습니다.
UUID 형식일 필요는 없습니다.
결과를 제출과 짝짓기
키를 보내지 않았다면
idempotencyKey는 null로 반환되지 않고 태스크 객체에서 생략됩니다.
키 수명
키는 요청 후 최소 30일 동안 예약된 상태로 남습니다. 태스크가 완료되거나 실패한 뒤에도, 24시간 폴링 기간이 끝난 뒤에도 마찬가지입니다. 폴링이404를 반환해도 키는 풀리지 않습니다. 한 제출의 전송 재시도에는 같은 키를, 같은 작업의 별도 실행에는 새 키(예: :r1 접미사 추가)를 쓰세요.
다음 단계
배치와 그리드
세 가지 대량 제출 엔드포인트 비교.
오류
모든 요청 오류 코드.