Task Run 생성
- 印刷する
- PDF
Task Run 생성
- 印刷する
- PDF
The content is currently unavailable in Ja - 日本語. You are viewing the default Korean version.
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC 환경에서 이용 가능합니다.
Task Model Run을 생성합니다.
사용자가 Task Run 생성을 요청하면 NCLUE 시스템은 요청 작업을 등록하고 Task Run ID를 반환합니다. 생성 과정은 다음과 같습니다.
생성 과정
| 순서 | 생성 상태 | 설명 |
|---|---|---|
| Step 1 | 등록됨 registered | 생성 작업이 시스템에 등록된 상태. 작업 시작 전 상태로 이 때는 삭제하여 작업을 취소할 수 있습니다. |
| Step 2 | 대기 중 pending | 생성 작업이 시스템 대기열에 올라간 상태 |
| Step 3 | 생성 중 in_progress | 작업이 서버에서 실행되는 상태. 서비스 가용 자원 상황에 따라 생성 시간은 달라집니다 |
| Step 4 | 생성 완료
| 생성이 완료되면, 성공했을 때 '사용 가능' 상태가 되어 정상적으로 사용 가능. 만약 작업에 오류가 발생한 경우, '실패' 상태가 되고, 오류 메시지를 참고하여 문제 해결 가능 |
Task Run 생성은 서비스 가용 자원 상황에 따라 작업 시간에 차이가 있습니다. 생성 진행 단계는 Task Run 조회 API를 호출하여 응답 바디의 'status'필드를 확인해 주십시오.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /api/v1/task-runs |
요청 헤더
NCLUE API에서 공통으로 사용하는 헤더 정보는 NCLUE 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
name | String | Required | Task Run 이름 (40자 제한) |
task_id | String | Required | 성능을 확인하려는 Task ID |
feature_id | String | Required | Task에 적용된 Feature ID |
result_bucket | String | Required | Task Run 작업 결과를 저장할 Object Storage 버킷명 |
result_file_path | String | Required | result_bucket 버킷 내 결과를 저장할 파일 경로
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://nclue.apigw.ntruss.com/api/v1/task-runs' \
--header 'X-NCP-APIGW-TIMESTAMP: {Timestamp}' \
--header 'X-NCP-IAM-ACCESS-KEY: {Access Key}' \
--header 'X-NCP-APIGW-SIGNATURE-V2: {API Gateway Signature}'
--data '{
"name":"펫푸드 구매관심 사용자 추정",
"task_id":"b5e742f1-0558-465a-8485-3b7808b0e125",
"feature_id":"79eb85b5-8ec5-4e1a-8617-64a1977c8062",
"result_bucket":"your.bucket.name",
"result_file_path":"petfood_predict.tsv"
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
run_id | String | - | Task Run ID |
run_name | String | - | 사용자가 입력한 Task Run 이름 |
task_id | String | - | 성능을 확인하려는 Task ID |
task_name | String | - | 성능을 확인하려는 Task 이름 |
feature_id | String | - | Task에 적용된 Feature ID |
feature_name | String | - | Task에 적용된 Feature 이름 |
created_at | String | - | Task Run 생성 요청 날짜 (ISO 8601 형식) |
result_bucket | String | - | Task Run 작업 결과를 저장할 Object Storage 버킷명 |
result_file_path | String | - | result_bucket 버킷 내 결과를 저장할 파일 경로 |
응답 예시
응답 예시는 다음과 같습니다.
성공
호출이 성공한 경우의 응답 예시는 다음과 같습니다.
{
"run_id":"9e6fecc9-0079-4c5e-a0c6-f387e6221afa",
"run_name":"펫푸드 구매관심 사용자 추정",
"task_id":"b5e742f1-0558-465a-8485-3b7808b0e125",
"task_name":"펫푸드 구매관심 예측모델",
"feature_id":"79eb85b5-8ec5-4e1a-8617-64a1977c8062",
"feature_name":"쇼핑 행동시퀀스 - 2024년",
"created_at":"2024-11-03T15:02:24",
"result_bucket":"your.bucket.name",
"result_file_path":"petfood_predict.tsv"
}
실패
호출이 실패한 경우의 응답 예시는 응답 상태 코드를 참고해 주십시오.
この記事は役に立ちましたか?