프로비저닝 결과 조회

작업과 생성된 세트, 건너뛴 작업, 부분적으로 실패한 내역을 확인하세요.

생성 시 반환된 식별자로 프로비저닝 작업을 조회하세요.

http
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEY

작업 필드 #

필드의미
id, organizationId, engineId작업 식별 정보와 작업이 속한 조직 및 엔진입니다.
statusRunning, Completed 또는 Failed 태그로 표시된 상태입니다. Failed에는 message이 포함됩니다.
kinds요청한 glossary, ruleset, brandVoice 작업의 결과입니다. 요청하지 않은 유형은 생략될 수 있습니다.
sources선택적으로 제공되는 소스 읽기 진행 상황 또는 보고서입니다.
website처음 제공된 웹사이트 주소입니다. 텍스트만 입력한 경우에는 생략됩니다.
createdAtISO 형식의 생성 타임스탬프입니다.
finishedAtISO 형식의 완료 타임스탬프로, 처리가 확정된 후에 제공됩니다.

유형별 상태 #

최상위 작업의 상태가 Completed인 경우에도 요청한 모든 유형을 확인하세요.

kinds.<kind>._tag필드 및 의미
Pending아직 작업 중입니다. 선택적 필드인 step의 값은 reading, generating 또는 saving이며, startedAt은 해당 단계가 시작된 시점을 나타냅니다.
DonesetId은 연결된 세트를 식별하며, itemCount는 생성된 항목 수를 나타냅니다.
Skippedreason은 해당 유형이 변경되지 않은 이유를 설명합니다.
Failedmessage은 해당 유형을 채우지 못한 이유를 설명합니다.

예를 들어 다음 결과 발췌에는 생성된 용어집과 생성에 실패한 규칙 세트가 포함되어 있습니다.

json
{
  "glossary": { "_tag": "Done", "setId": "YOUR_GLOSSARY_ID", "itemCount": 12 },
  "ruleset": { "_tag": "Failed", "message": "Could not generate rules from the supplied material." }
}

각 유형은 개별적으로 저장됩니다. 다른 유형의 생성이 실패해도 성공적으로 생성된 지침은 계속 사용할 수 있습니다. 또한 생성이 진행되는 동안 엔진에 세트가 연결될 수 있으며, 이 경우 비어 있을 때만 채우는 작업이나 브랜드 보이스를 채우는 작업은 건너뛸 수 있습니다.

생성된 레코드 확인 #

Studio에서 엔진을 열고 연결된 용어집, 규칙 세트 또는 브랜드 보이스로 이동하세요. API로 조회하려면 다음을 사용하세요.

  • 용어집 항목을 조회하려면 GET /v2/glossaries/:id/terms을 사용하세요.
  • 규칙을 조회하려면 GET /v2/rulesets/:id/rules을 사용하세요.
  • 보이스 변형을 조회하려면 GET /v2/brand-voices/:id/variations을 사용하세요.

해당하는 setId을 사용하고, 각 목록의 페이지 구분에 따라 조회하세요. 용어와 언어별 적용 여부, 번역하지 않는 이름, 모델이 추가한 가정을 확인하세요. 항목 수는 생성된 레코드 수를 나타낼 뿐, 정확성을 나타내지는 않습니다.

실패한 유형은 재시도 및 복구를 이용하세요. 대체 엔진을 만들어 모든 작업을 반복하지 말고, 완료된 세트를 보존하세요.