프로비저닝 작업 복구
미완료 프로비저닝 작업을 찾아, 성공적으로 생성된 세트는 그대로 두고 실패한 지침 생성을 다시 시도하세요.
생성에 성공하는 즉시 프로비저닝 작업의 id 및 engineId을 저장하세요. 클라이언트 연결이 끊겼거나 대기 후에도 상태가 불확실하다면 GET /v2/provisioning/jobs/:id을 사용하세요. 작업 및 유형별 상태를 보면 복구가 필요한 항목을 알 수 있습니다.
실행 중인 작업 찾기 #
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEYstatus=running은 필수입니다. 응답에는 조회 가능한 실행 중인 작업의 배열인 data이 포함되며, 커서 기반 페이지 나누기는 지원하지 않습니다. 인증된 사용자가 시작한 작업만 조회하려면 startedBy=me을 추가하세요. 서비스 키에는 사용자 식별 정보가 없으므로 이 필터를 적용하면 빈 목록이 반환됩니다.
새 엔진 생성 응답을 받지 못했다면 GET /v2/organizations/:orgId/engines과 대시보드에서도 생성된 엔진을 확인하세요. 작업이 이미 완료되어 실행 중인 작업 목록에서 사라졌을 수 있습니다. 생성 요청을 다시 보내면 엔진이 하나 더 생성될 수 있습니다.
실패한 유형 재시도 #
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEY이 요청에는 본문이 없습니다. 원래 소스를 사용해 같은 엔진에서 새 작업을 생성하고 반환합니다. 실패한 유형 중 아직 비어 있는 유형만 선택되며, 완료된 세트는 유지됩니다. 반환된 작업 식별자를 저장하고 완료될 때까지 상태를 추적하세요.
NothingToProvision (409)은 재시도할 수 있는 실패 유형이 더 이상 없다는 뜻입니다. 예를 들어 그사이에 다른 동작으로 세트가 연결되었을 수 있습니다. ProvisioningJobRunning (409)은 해당 엔진에서 이미 실행 중인 작업을 나타냅니다. 다시 시도하기 전에 해당 리소스를 조회하세요.
원래 소스를 변경해야 한다면 소스를 수정하고 Empty 또는 Requested을 의도에 맞게 선택해 기존 엔진에서 새 작업을 제출하세요. 재시도 경로는 원래 입력을 재사용합니다.
제한 및 시작 미완료 문제 해결 #
ProvisioningLimitReached (429)에는 retryAt이 포함됩니다. 해당 시각까지 기다린 후 다시 제출하세요. 크레딧, 요금제, 접근 권한 관련 오류는 해당 계정이나 권한 문제를 해결해야 합니다.
워크플로 시작에 실패하면 요청이 서버 오류를 반환하더라도 새로 생성된 빈 엔진이 남을 수 있습니다. 새 엔진 생성 요청을 다시 보내기 전에 엔진 목록을 확인하세요. 기존 엔진이 원래 설정하려던 엔진이라면 재사용하세요.
작업이 종료되면 생성된 지침을 번역에 사용하기 전에 Studio에서 검토하세요.