콘텐츠로 이동

삭제



POST /api/v1/dialing_task/delete

개요

신서틱 테스트를 일괄 삭제하고 해당 원격 구성을 중지합니다.

호출 전 및 사용 단계

먼저 모든 UUID와 영향을 확인합니다. 일반 작업은 모든 현재 노드에 중지를 전송한 후 구성을 소프트 삭제합니다. 노드가 없는 기존 작업은 원격 배포를 건너뜁니다. 모바일은 원격 작업을 먼저 삭제한 후 로컬을 소프트 삭제합니다. 모바일 서비스 스위치가 꺼져 있어도 중지/삭제는 여전히 허용되지만, 바인딩이 누락되었거나 원격 상태가 불명확하면 실패할 수 있으므로 로컬 삭제를 플랫폼에서 중지된 것으로 간주해서는 안 됩니다. 원시 신서틱 테스트 데이터/기존 이벤트는 이 작업으로 삭제되지 않습니다. 모든 항목의 삭제가 완료된 후에만 신서틱 테스트 태그 참조를 정리합니다. 전체 입력 집합의 잔여 태그 참조도 정리될 수 있으며, 기본 레코드와 일치하지 않는 항목이 전혀 영향을 받지 않는다고 보장하지 않습니다.

기본적으로 이 워크스페이스의 삭제되지 않은 일치 대상만 처리합니다. 빈 배열이거나 모두 일치하지 않는 경우 true로 성공할 수 있으며, 항목별 일치 목록은 반환하지 않습니다. 작업 간/원격과 로컬은 원자적 배치가 아닙니다. 앞 항목이 커밋된 후 뒤 항목이 실패해도 전체가 롤백되지 않습니다. 오류 발생 후 먼저 각 task.status와 목록 존재 여부를 다시 조회합니다. mobile remoteStatus는 항상 unknown이며 미실행을 의미하지 않으므로 오류 taskUUID/outcomeUnknown에 따라 플랫폼을 확인합니다. 결과가 불명확한 상태에서 무분별한 동시 재시도를 피합니다.

이 OpenAPI 모듈에는 Front 디버깅/가져오기와 동일한 이름의 공개 진입점이 없으므로 이를 근거로 URL을 추측하여 구성하지 않습니다. 구성 활성화가 측정 결과 획득 또는 알림 전달 완료를 의미하지는 않습니다.

일반 레거시 HTTP/TCP/ICMP/SSL/multi/browser/NetPath는 중지 또는 삭제를 전송할 때 해당 유형 검증이 여전히 트리거될 수 있습니다. DNS stop/delete만 DNS 계약을 건너뛰고, TCP stop/delete는 success_when 키만 요구하며 timeout/connection을 다시 검증하지 않습니다. 중지/삭제를 일괄적으로 레거시 구성을 무시하는 것으로 설명할 수 없습니다.

요청 헤더

파라미터 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 획득합니다.

Body 요청 파라미터

파라미터 이름 유형 필수 설명
taskUUIDs[*] string 작업 이름, 노드 또는 업스트림 taskId가 아닙니다.
예: dial_example
획득 또는 입력 방법: 이 워크스페이스의 단일 작업 UUID를 가져옵니다.
taskUUIDs array Y 필수 배열이며 비어 있지 않은 것을 권장합니다. dial_ 작업만 선택해야 하며 노드/템플릿/원격 id를 섞을 수 없습니다. 일치하지 않거나 이미 삭제된 UUID는 항목별로 오류가 보고되지 않습니다.
null 허용: False
예: ["dial_example"]
획득 또는 입력 방법: 신서틱 테스트 목록에서 이 워크스페이스의 삭제되지 않은 작업 uuid를 가져옵니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"taskUUIDs":["dial_example"]}'

응답

HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content boolean 성공 시 true입니다. 일치 건수/항목별 결과가 아니며, 원격에서 한 번의 실행이 완료되었음을 보장하지도 않습니다.
{
  "code": 200,
  "content": true,
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

일반 SDK는 dialtesting.invalidRegion을 ft.DialingRegionError로 매핑하고 실제 HTTP를 유지합니다. 기타 다운스트림 4xx는 실제 HTTP 및 error_code/message를 유지하며, 나열되지 않은 코드도 나타날 수 있습니다. 일반 5xx는 500 ft.InternalServerError로 통일됩니다. mobile 실패에는 taskUUID/remoteStatus/outcomeUnknown이 포함될 수 있으며, 오류가 반환될 때 앞 항목은 이미 커밋되었을 수 있습니다. 중지/삭제는 모든 기존 작업의 현재 생성 계약을 강제로 다시 검증하지 않으므로, 이를 근거로 기존 구성을 다시 활성화할 수 있다고 판단해서는 안 됩니다.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방식
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건을 위반함 파라미터 파싱 실패 파라미터 위치, 필드 이름, 유형 및 값을 확인합니다.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정합니다.
400 ft.JsonFormatError Body 최상위가 객체가 아님 일부 json 파일 형식 오류 taskUUIDs 및 해당 스위치를 포함하는 JSON 객체를 제출합니다.
409 ft.MobileDialingOperationBusy 모바일 작업이 포함된 배치가 워크스페이스 동시 작업 잠금을 기다리다 시간 초과되어 이번 작업이 실행되지 않음 현재 워크스페이스에서 다른 작업이 진행 중이므로 이번 작업이 실행되지 않았습니다. 잠시 후 다시 시도하세요. retryable/operationExecuted에 따라 백오프하여 재시도합니다.
404 ft.NotFoundDialTask 대기 중 기존 모바일 작업이 삭제되었거나 집합이 변경됨 지정된 클라우드 신서틱 테스트를 찾을 수 없습니다 현재 목록을 다시 읽은 후 대상을 선택합니다.
406 ft.NotFoundWorkspace 쓰기 대상 워크스페이스가 더 이상 존재하지 않음 지정된 워크스페이스를 찾을 수 없습니다 워크스페이스가 유효한지 확인하고, 이미 해제된 워크스페이스에 대해서는 재시도하지 않습니다.
406 ft.DialingBrandNoSetError 일반 작업 배포 시 해당 서비스 구성이 누락됨 {} 브랜드에 대한 신서틱 테스트 구성이 설정되지 않았습니다. 관리자가 워크스페이스의 신서틱 테스트 서비스를 확인합니다.
400 ft.DialingAKNoSetError 일반 신서틱 테스트 배포 시 서명 정보 누락 신서틱 테스트 AK 정보가 구성되지 않았습니다. Launcher 활성화 구성을 확인하세요. 관리자가 서비스 활성화를 확인합니다.
400 ft.DialingServerError 모바일 플랫폼 바인딩/원격 호출 실패 또는 일반 다운스트림 400 실패 신서틱 테스트 서비스 인터페이스 호출 실패 content.reason/taskUUID/outcomeUnknown 및 커밋된 하위 집합을 확인하여 중복 작업을 피합니다.
400 ft.DialingRegionError 일반 신서틱 테스트 다운스트림 400으로 노드 무효 판정 현재 작업에 일부 신서틱 테스트 노드가 유효하지 않습니다. 구성을 업데이트한 후 다시 저장하세요. 무효 노드 및 현재 작업 상태를 확인합니다. 중지/삭제는 재구성 의도와 다르므로 필요한 경우 관리자가 처리합니다.
500 ft.InternalServerError 일반 다운스트림 5xx/연결 예외 또는 포착되지 않은 데이터베이스, 구성 형식, 참조 처리 오류 내부 오류 커밋된 하위 집합과 원격 상태를 다시 읽고 traceId를 제공한 후 단계별로 처리합니다.
406 ft.InvalidCrontabFormat 레거시 NetPath schedule_type=crontab 및 표현식이 유효하지 않음. 활성화/중지/삭제 배포 전에 여전히 검증됨 유효하지 않은 crontab 형식 먼저 전체 NetPath 구성을 수정하거나 관리자가 처리합니다. NetPath는 DNS/TCP 종료 검증 면제를 적용받지 않습니다.
406 ft.MissingSuccessWhen 일반 레거시 HTTP에 스크립트 대체가 없거나 TCP/ICMP/SSL 등 저장 구성에 success_when이 누락됨. 중지/삭제 시에도 검증될 수 있음 사용 가능한 판단 success_when이 누락됨 먼저 기존 구성과 프로토콜을 확인합니다. DNS 중지/삭제는 DNS 계약을 건너뛰지만, TCP 중지/삭제는 여전히 해당 키를 요구합니다.
406 ft.MissingMethod 일반 HTTP 또는 다단계 HTTP 저장 단계에 method가 누락됨(중지/삭제 배포 포함) 요청 메서드 method가 지정되지 않았습니다. 완전한 레거시 구성을 수정하거나 관리자가 예외 작업을 처리한 후 작업합니다.
400 ft.MissingCustomParameters SSL 저장 구성에 host/port가 누락되었거나 NetPath의 엄격한 필수 필드가 누락됨 {} 필드 누락 원래 유형에 따라 수정합니다. 중지/삭제가 이러한 검사를 일괄적으로 건너뛰지는 않습니다.
406 ft.FirstStepsNotWait 기존 다단계 구성의 첫 번째 단계가 wait여서 재배포 또는 삭제 중지 전 검증 실패 유효하지 않은 단계 파라미터이며, 첫 번째 단계는 대기일 수 없습니다. 다단계 흐름을 수정하거나 관리자가 레거시 구성을 처리합니다.
406 ft.InvalidDialingTask 레거시 browser 스크립트가 비어 있거나 유효하지 않거나, 레거시 multi HTTP 단계 이름/URL이 유효하지 않음 유효하지 않은 task 파라미터 현재 OpenAPI browser 쓰기는 화이트리스트 제한이 있으므로 지원되는 진입점/관리자를 통해 수정한 후 재시도해야 합니다.
400 ft.ParamsValidateError NetPath/browser 등 구성을 저장할 때 중지/삭제 전 유형 검증이 유효하지 않음 파라미터 검증 실패: {} 원래 유형의 전체 구성을 확인합니다. 모든 중지/삭제가 계약을 우회하는 것은 아닙니다.

문서 평가

이 페이지가 도움이 되었나요?