Task 삭제

Prev Next

VPC 환경에서 이용 가능합니다.

더 이상 사용하지 않거나 불필요한 Task Model을 삭제합니다.

Task의 삭제 조건은 다음과 같습니다.

삭제 가능 여부 Task 상태 Task 사용 여부
가능
  • registered: 등록됨
  • completed: 사용 가능
  • failed: 실패
  • 삭제하려는 Task를 사용하는 기능(Task Model Run, Shopping Intent 중 하나)이 없는 경우
  • 삭제하려는 Task를 사용하는 기능이 있더라도, 시작 전이거나(registered), 이미 완료된(completed, failed) 경우
불가능
  • pending: 대기 중
  • in_progress: 생성 중
 삭제하려는 Task를 사용하는 기능(Task Model Run, Shopping Intent 중 하나) 중에서 해당 기능이 실행 중(pending, in_progress)인 경우
참고

삭제가 불가능한 경우에는 오류 메시지가 반환됩니다. 삭제 가능한 조건에서 다시 시도해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
DELETE /tasks/{task_id}

요청 헤더

NCLUE API에서 공통으로 사용하는 헤더에 대한 정보는 NCLUE 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
task_id String Required Task ID

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request DELETE 'https://nclue.apigw.ntruss.com/api/v1/tasks/{task_id}' \
--header 'X-NCP-APIGW-TIMESTAMP: {Timestamp}' \
--header 'X-NCP-IAM-ACCESS-KEY: {Access Key}' \
--header 'X-NCP-APIGW-SIGNATURE-V2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
task_id String - Task ID

응답 상태 코드

NCLUE에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 NCLUE 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "task_id": "f5aebc0c-****-****-****-b201bc64b1c9"
}