삭제¶
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 등 구성을 저장할 때 중지/삭제 전 유형 검증이 유효하지 않음 | 파라미터 검증 실패: {} | 원래 유형의 전체 구성을 확인합니다. 모든 중지/삭제가 계약을 우회하는 것은 아닙니다. |