【모바일 신서틱 테스트】작업 복제¶
POST /api/v1/dialing_task/{task_uuid}/clone
개요¶
기존 모바일 신서틱 테스트에서 독립적인 새 작업을 생성합니다.
호출 전 및 사용 단계¶
현재 워크스페이스에 있는 기존 mobile 소스만 지원합니다. 소스를 복제하면 프로토콜/주소/주기/노드 선택 스냅샷을 기록할 수 있으며, 내부 플랫폼 바인딩/보고 자격 증명/실행 상태는 제거하고 새 이름과 새 작업 UUID로 원격 작업을 다시 생성합니다. 스냅샷 백업이 아니며 원본 작업도 수정하지 않습니다.
새 작업은 성공하면 기본적으로 활성화되며, 주기 실행과 비용이 증가할 수 있습니다. 원본의 stop 상태를 복제하여 복제본이 중지되도록 보장할 수는 없습니다. tags를 생략하면 원본의 현재 태그를 상속하고, []는 태그 없음을 명시합니다. 모바일 생성 계약, 노드 선택/약관/할당량 주기 및 이름 검증을 다시 수행합니다. 기존 HTTP(비 HTTPS) 등의 레거시 구성은 우회할 수 없습니다. 실패 시 로컬에 이미 저장되었거나 원격 결과가 알 수 없는 상태일 수 있으므로 content.taskUUID/localSaved/outcomeUnknown을 기준으로 먼저 다시 읽어 중복 복제를 피해야 합니다.
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| task_uuid | string | Y | 복제할 원본 작업입니다. 일반 작업은 거부됩니다. 템플릿 또는 원격 id가 아닙니다. 예: dial_example가져오기 또는 입력 방법: 작업 목록에서 현재 워크스페이스의 type=mobile 작업 uuid를 가져옵니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| tags[*] | string | 이름 기준 중복 제거이며 tag_ UUID가 아닙니다. 신서틱 테스트 범위에 맞지 않으면 오류가 발생합니다. 예: production가져오기 또는 입력 방법: 단일 비즈니스 태그 이름을 사용합니다. |
|
| name | string | Y | 필수이며 trim 후 1..256자이고, 복제본 접미사가 자동으로 추가되지 않습니다. 예: 移动HTTPS检查副本가져오기 또는 입력 방법: 새 작업에 현재 워크스페이스에서 사용하지 않는 이름을 지정합니다. |
| tags | array | 선택 사항입니다. 완전히 생략하면 원본의 현재 태그를 상속하고, 명시적 []는 태그를 포함하지 않습니다. 원본과 같은 이름의 작업을 유지하는 것이 아닙니다. 예: ["production"]가져오기 또는 입력 방법: 필요에 따라 dialing 범위에 적용되는 태그 이름을 지정합니다. |
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/dial_example/clone' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"移动HTTPS检查副本"}'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 레코드 번호이며, 일반 생성 제출 전 구성된 응답에서는 null일 수 있습니다. |
| content.uuid | string | dial_ 작업 UUID로, 이후 get/modify/활성화/중지에 사용합니다. |
| content.workspaceUUID | string | 소속 워크스페이스 UUID입니다. |
| content.type | string | 저장된 작업 분류입니다. mobile의 세부 프로토콜은 task.protocol을 참조하고, 다단계는 multi입니다. |
| content.status | integer | 엔터티 상태이며 일반적으로 0, 삭제는 3입니다. task.status 실행 스위치와 구분합니다. |
| content.isLocked | integer 또는 boolean | 로컬/워크스페이스 잠금 표시이며 원격 실제 측정 상태를 의미하지 않습니다. |
| content.regions | array<string> | 일반 작업의 현재 노드 UUID 배열이며 mobile은 []입니다. |
| content.regions[] | string | 노드 UUID입니다. |
| content.regionsInfo | array 또는 object | 기존 노드 표시는 UUID 배열, 객체 배열 또는 UUID 키 매핑일 수 있습니다. 생성/수정 시에는 보통 입력 UUID 배열입니다. |
| content.regionsInfo[] | string 또는 object | 노드 UUID 또는 저장된 노드 정보입니다. |
| content.regionsInfo[].uuid | string | 조건부로 반환되는 노드 UUID입니다. |
| content.regionsInfo[].name | string | 현재 언어의 노드 표시 이름입니다. |
| content.regionsInfo[].nameEn | string | 영어/호환 이름입니다. |
| content.regionsInfo[].nameI18n | object | 언어에서 이름으로의 매핑입니다. |
| content.regionsInfo[].nameI18n.语言码 | string | 단일 표시 이름입니다. |
| content.regionsInfo.节点UUID | string 또는 object | 기존 UUID 키 매핑의 노드 정보이며 배열 노드 정보와 동일한 의미입니다. |
| content.task | object | 저장된 작업의 전체 구성이며 실시간 신서틱 테스트 결과는 포함하지 않습니다. |
| content.task.status | string | ok는 활성화/stop은 중지이며, 로컬 구성 값이 원격과 완전히 동기화됨을 보장하지 않습니다. |
| content.task.external_id | string | 일부 일반 쓰기 응답에는 서버 측 작업 식별자가 포함될 수 있습니다. list/get에서는 이 내부 키가 제거되며 쓰기 가능한 필드가 아닙니다. |
| content.task.owner_external_id | string | 일부 일반 쓰기 응답에는 서버 측 워크스페이스 식별자가 포함될 수 있습니다. list/get에서는 제거되며 제출하지 않습니다. |
| content.task.post_url | string | 일부 기존 일반 쓰기 응답에는 서버 측 보고 주소가 포함될 수 있습니다. list/get에서는 제거됩니다. 민감한 응답은 안전하게 보관하고 절대 다시 채우거나 공개해서는 안 됩니다. |
| content.task.其他历史字段 | JSON | 호환 저장 필드는 유형에 따라 해석되며 이 공개 쓰기 진입점의 허용 목록으로 사용되지 않습니다. |
| content.remoteStatus | string | mobile은 unknown으로 고정되며 로컬에서만 읽고 플랫폼을 실시간 조회하지 않습니다. |
| content.creator | string | 생성 주체입니다. |
| content.updator | string | 수정 주체입니다. |
| content.createAt | integer | 생성 Unix 초입니다. |
| content.updateAt | integer | 수정 Unix 초입니다. |
| content.deleteAt | integer | 삭제 Unix 초이며 삭제되지 않았으면 -1입니다. |
| content.task.name | string | 필수이며 trim 후 1..256개의 Python 문자이고 trim 결과를 저장합니다. 모든 신서틱 테스트 유형은 삭제되지 않은 이름의 고유성을 공유합니다. 수정 시 전체 이름을 제공해야 합니다. |
| content.task.frequency | string | 필수이며 기본값이 없습니다. 무료/체험 워크스페이스는 30m/1h/6h/12h/24h만 지원합니다. DataKit 수동 JSON의 임의 초 단위 주기를 적용하지 마십시오. |
| content.task.schedule_type | string | 선택 사항입니다. 생략하면 실행 측의 일반 주기를 따릅니다. mobile은 frequency만 지원하며 crontab을 지원하지 않습니다. |
| content.task.crontab | string | schedule_type=crontab일 때 비어 있으면 안 되고 Cron 파싱을 통과해야 합니다. frequency는 여전히 공개 선언상 필수입니다. mobile은 이 필드를 허용하지 않습니다. 시간대/실행 주기는 노드 실제 환경과 함께 검증해야 하며 Unix 타임스탬프로 간주할 수 없습니다. |
| content.task.url | string | HTTP/WebSocket은 프로토콜에 따라 작성합니다. 공개 계층에서는 선택 사항이지만 작업 실행에 필요합니다. mobile에는 사용하지 않으며 mobile은 address를 작성합니다. 브라우저는 별도의 현재 진입점 제한이 있습니다. |
| content.task.method | string | HTTP 비즈니스에는 필수이며 누락 시 MissingMethod 오류가 발생합니다. 다른 프로토콜에서는 생략하며, 모든 메서드가 실행 측에서 지원된다고 보장하지 않습니다. |
| content.task.success_when_logic | string | 선택 사항인 and/or이며 실행 측은 보통 기본값 and를 사용합니다. NetPath는 반드시 명시해야 합니다. 알림 정책을 제어하는 값이 아닙니다. |
| content.task.success_when | array | HTTP에서 비어 있지 않은 post_script가 없을 때, TCP/ICMP/WebSocket/SSL은 이 키가 필요합니다. DNS는 1..20개의 유효한 리프가 필요합니다. NetPath는 외부 단일 객체여야 합니다. 서로 다른 프로토콜 구조는 혼용할 수 없습니다. 저장 시 실시간 실행 성공은 요구되지 않습니다. |
| content.task.success_when[] | json | 단일 조건 객체입니다. 외부 조건 논리는 success_when_logic이 제어합니다. 내부 조건 의미는 해당 실행 측에서 검증합니다. |
| content.task.enable_traceroute | boolean | 선택 사항이며, 생략 시 Studio가 통합 기본값을 보충하지 않습니다. NetPath는 자체 경로 프로토콜을 사용하며 이 필드를 혼용하지 않습니다. |
| content.task.packet_count | integer | ICMP 선택 사항이며 라운드당 패킷 수입니다. 실제 노드 제약은 실행 측에서 확인하며 mobile의 pingCount에는 사용하지 않습니다. |
| content.task.host | string | 해당 프로토콜 비즈니스에 필수입니다. NetPath는 trim 후 비어 있지 않아야 하며 HTTP URL scheme을 포함할 필요가 없습니다. mobile TCP는 address=host:port로 작성합니다. |
| content.task.port | string | TCP/SSL 비즈니스에 필수입니다. NetPath TCP/UDP는 1..65535이며 순수 숫자여야 합니다(선행 0 유지 가능). ICMP는 무시합니다. DNS는 독립 프로토콜 포트이며 기본 53 또는 암호화 프로토콜 853을 실행 측에서 결정합니다. |
| content.task.server_name | string | SSL/DNS 선택 사항입니다. server_ip로 IP 연결을 고정할 때 원래 서비스 신원을 유지하며 IP를 SNI 대신 직접 입력하지 않습니다. |
| content.task.timeout | string | TCP는 1s..60s 정수 초 문자열입니다. DNS 기본 10s, 실행 측 범위 (0,60s]이며 변수 템플릿을 사용할 수 있습니다. ICMP/SSL은 실행 측 지원에 따르며 Studio가 통합 기본값을 보충하지 않습니다. NetPath는 advance_options.timeout을 사용합니다. |
| content.task.ignore_server_certificate_error | boolean | SSL 선택 사항이며 생략 시 실행 측 보안 기본값을 따릅니다. DNS 인증서 무시 스위치는 certificate 내부에 둡니다. |
| content.task.message | string | WebSocket 비즈니스에 필요하며 UTF-8 기준 128KiB를 초과할 수 없습니다. 모바일 TCP의 tcpData에는 사용하지 않습니다. |
| content.task.post_mode | string | 선택 사항이며 실행 측 선택 방식입니다. Studio HTTP에서 success_when 필요 여부는 실제로 post_script 비어 있지 않음으로 판단하며 이 필드만 보지 않습니다. |
| content.task.post_script | string | 선택 사항이며 빈 문자열은 스크립트를 제공하지 않음을 의미합니다. HTTP에서 비어 있지 않으면 success_when을 생략할 수 있습니다. DNS/NetPath/mobile은 스크립트로 인해 전용 허용 목록과 검증을 우회하지 않습니다. |
| content.task.advance_options | json | 선택 사항 객체입니다. NetPath는 필수이며 이 페이지의 6개 필드만 엄격히 허용합니다. HTTP 요청, 인증서/프록시 등은 실행 측 실제 지원에 따라야 하며 프로토콜 검증을 온라인 테스트와 동일시하지 마십시오. |
| content.task.advance_options_headless | json | 공개 선언에는 유지되지만 필수 browser_config를 대체할 수 없습니다. 현재 공개 추가/수정 browser는 전체 구성을 통과할 수 없으므로 이 객체를 브라우저 스크립트 진입점으로 사용하지 마십시오. |
| content.task.advance_options.request_options | json | HTTP/WebSocket에 적용되며 선택 사항입니다. HTTP/WebSocket 요청 옵션입니다. |
| content.task.advance_options.request_options.follow_redirect | boolean | HTTP/WebSocket에 적용되며 선택 사항입니다. 리디렉션을 따를지 여부이며 생략 시 실행 측 기본값을 따릅니다. |
| content.task.advance_options.request_options.headers | json | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 헤더 이름에서 문자열 값으로의 매핑입니다. 실제 자격 증명을 예시에 작성하지 마십시오. |
| content.task.advance_options.request_options.headers.请求头名 | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 동적 요청 헤더 값이며 이름은 실제 인터페이스에 필요한 header를 사용합니다. |
| content.task.advance_options.request_options.cookies | string | HTTP/WebSocket에 적용되며 선택 사항입니다. Cookie 텍스트이며 생략할 수 있습니다. |
| content.task.advance_options.request_options.auth | json | HTTP/WebSocket에 적용되며 선택 사항입니다. HTTP Basic 사용자 이름과 비밀번호 구성이며 생략할 수 있습니다. |
| content.task.advance_options.request_options.auth.username | string | HTTP/WebSocket에 적용되며 선택 사항입니다. Basic 사용자 이름으로 대상 인터페이스 관리자가 제공합니다. |
| content.task.advance_options.request_options.auth.password | string | HTTP/WebSocket에 적용되며 선택 사항입니다. Basic 비밀번호이며 보안 자격 증명 소스에서 주입하십시오. |
| content.task.advance_options.request_body | json | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 Body 형식과 내용입니다. |
| content.task.advance_options.request_body.body_type | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 Content-Type이며 예: application/json/text/plain/text/xml/multipart/form-data. |
| content.task.advance_options.request_body.body | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 본문 문자열이며 수정 시 필요한 비즈니스 내용을 유지해야 합니다. |
| content.task.advance_options.request_body.form | json | HTTP/WebSocket에 적용되며 선택 사항입니다. multipart 폼 필드에서 문자열로의 매핑이며 생략할 수 있습니다. |
| content.task.advance_options.request_body.form.字段名 | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 단일 폼 값입니다. |
| content.task.advance_options.request_timeout | string | HTTP/WebSocket에 적용되며 선택 사항입니다. HTTP 총 타임아웃 duration이며 실행 측 기본값은 60s입니다. Studio가 실제 실행 측 검증을 대신하지 않습니다. |
| content.task.advance_options.protocol | string | HTTP/WebSocket에 적용되며 선택 사항입니다. HTTP 프로토콜 auto/http/1.1/http/2/http/2-only/http/3이며 지원 여부는 노드 버전에 따라 다릅니다. HTTP3에서는 프록시를 동시에 구성하지 마십시오. |
| content.task.advance_options.certificate | json | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 TLS 인증서 구성입니다. |
| content.task.advance_options.certificate.ignore_server_certificate_error | boolean | HTTP/WebSocket에 적용되며 선택 사항입니다. 인증서 검증 오류를 무시할지 여부입니다. |
| content.task.advance_options.certificate.certificate | string | HTTP/WebSocket에 적용되며 선택 사항입니다. PEM 클라이언트 인증서이며 대상 서비스에서 제공합니다. |
| content.task.advance_options.certificate.private_key | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 인증서에 대응하는 PEM 개인 키이며 보안 소스를 사용합니다. |
| content.task.advance_options.certificate.ca | string | HTTP/WebSocket에 적용되며 선택 사항입니다. CA 내용입니다. 일부 HTTP 실행 측에서는 유지하지만 사용하지 않으며, DNS는 certificate.ca를 해당 프로토콜에 따라 직접 해석합니다. |
| content.task.advance_options.proxy | json | HTTP/WebSocket에 적용되며 선택 사항입니다. HTTP 프록시 객체이며 노드가 임의 프록시에 액세스할 수 있다고 가정할 수 없습니다. |
| content.task.advance_options.proxy.url | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 프록시 URL입니다. |
| content.task.advance_options.proxy.headers | json | HTTP/WebSocket에 적용되며 선택 사항입니다. 프록시 전용 문자열 header 매핑입니다. |
| content.task.advance_options.proxy.headers.请求头名 | string | HTTP/WebSocket에 적용되며 선택 사항입니다. 단일 프록시 요청 헤더 값입니다. |
| content.task.advance_options.secret | json | HTTP/WebSocket에 적용되며 선택 사항입니다. 기존 HTTP 요청 데이터 저장 옵션이며 실행 측 지원을 기준으로 합니다. |
| content.task.advance_options.secret.not_save | boolean | HTTP/WebSocket에 적용되며 선택 사항입니다. 요청 내용을 저장하지 않을지 여부이며 반환 문서/로그의 민감 정보 제거를 대체할 수 없습니다. |
| content.task.success_when[].body | array | 선택적 어설션 집합이며 키 이름은 실제 응답에 따릅니다. 실행 측이 지원하는 비교만 사용합니다. |
| content.task.success_when[].body[].contains | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].body[].not_contains | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].body[].is | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].body[].is_not | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].body[].match_regex | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].body[].not_match_regex | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名 | array | 선택적 어설션 집합이며 키 이름은 실제 응답에 따릅니다. 실행 측이 지원하는 비교만 사용합니다. |
| content.task.success_when[].header.响应头名[].contains | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名[].not_contains | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名[].is | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名[].is_not | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名[].match_regex | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header.响应头名[].not_match_regex | string | 단일 텍스트 비교이며 필요한 작업에 따라 선택합니다. 정규식 의미는 실행 측에서 검증하며 저장 성공이 일치를 증명하지 않습니다. |
| content.task.success_when[].header | json | 선택적 header 이름에서 조건 집합으로의 매핑입니다. |
| content.task.success_when[].status_code | array | HTTP 선택적 상태 어설션 집합이며 실행 측 프로토콜에 따라 문자열을 비교합니다. |
| content.task.success_when[].status_code[].is | string | 단일 상태 코드 어설션 작업입니다. mobile expectedResponseCode 정수 배열과 혼용하지 마십시오. |
| content.task.success_when[].status_code[].is_not | string | 단일 상태 코드 어설션 작업입니다. mobile expectedResponseCode 정수 배열과 혼용하지 마십시오. |
| content.task.success_when[].status_code[].match_regex | string | 단일 상태 코드 어설션 작업입니다. mobile expectedResponseCode 정수 배열과 혼용하지 마십시오. |
| content.task.success_when[].status_code[].not_match_regex | string | 단일 상태 코드 어설션 작업입니다. mobile expectedResponseCode 정수 배열과 혼용하지 마십시오. |
| content.task.success_when[].response_time | string 또는 array | HTTP/WebSocket/DNS는 duration 임계값 문자열입니다. 기존 TCP/ICMP는 조건 배열일 수 있으며 응답 시간 단위는 해당 리프 필드를 참조합니다. 일괄적으로 순수 밀리초 숫자로 해석할 수 없습니다. |
| content.task.success_when[].response_time[].is_contain_dns | boolean | 배열 형태에서만 사용합니다. TCP/ICMP에서 DNS 소요 시간을 비교에 포함할지 여부입니다. |
| content.task.success_when[].response_time[].target | string | 배열 형태에서만 사용합니다. 소요 시간 비교 값 duration입니다. |
| content.task.success_when[].connection | array | TCP 선택 사항이지만 나타날 경우 비어 있지 않은 배열이어야 하며 eq established/refused/timeout만 허용합니다. |
| content.task.success_when[].connection[].op | string | 필수이며 eq만 가능하고 is/ne는 허용하지 않습니다. |
| content.task.success_when[].connection[].target | string | 필수이며 established/refused/timeout 연결 결과입니다. |
| content.task.domain | string | 비즈니스 필수 조회 대상 도메인이며 검증된 변수 템플릿을 사용할 수 있습니다. |
| content.task.dns_server | string | DoH가 아닌 경우 서버 도메인/IP가 필수이며 포트를 포함하지 않습니다. DoH는 URL에서 추론할 수 있습니다. |
| content.task.server_ip | string | 선택적 고정 연결 IP이며 논리 서버 신원을 유지하고 생략 시 실행 측에서 해석합니다. |
| content.task.record_types | array | 선택 사항인 A/AAAA/CNAME/MX/NS/TXT이며 어설션에서 추론할 수 있고 실행 측 기본값은 A입니다. |
| content.task.record_types[] | string | 단일 레코드 유형 또는 유효한 변수 템플릿입니다. |
| content.task.protocol | string | DNS는 auto/udp/tcp/dot/doh/doq(생략 시 auto), NetPath는 tcp/udp/icmp(필수), mobile은 http/dns/tcp/ping(필수)을 선택합니다. |
| content.task.certificate | json | DNS 선택적 TLS 인증서 객체이며 HTTP의 advance_options에 넣지 않습니다. |
| content.task.doh | json | DNS DoH 프로토콜 구성입니다. |
| content.task.doh.url | string | DoH 필수 URL입니다. |
| content.task.doh.method | string | 선택 사항인 GET/POST이며 생략 시 실행 측에서 처리합니다. |
| content.task.doh.http_protocol | string | 선택 사항인 auto/http/1.1/http/2-only/http/3입니다. |
| content.task.doh.headers | json | 선택적 HTTP 요청 헤더 문자열 매핑입니다. |
| content.task.doh.headers.请求头名 | string | 단일 문자열 요청 헤더입니다. |
| content.task.dns_options | json | 선택적 DNS 쿼리 플래그/EDNS 매개변수입니다. |
| content.task.dns_options.recursion_desired | boolean | 선택적 RD 재귀 쿼리 플래그이며 생략 시 실행 측 기본값을 따릅니다. |
| content.task.dns_options.dnssec_ok | boolean | 선택적 DO DNSSEC 플래그입니다. |
| content.task.dns_options.checking_disabled | boolean | 선택적 CD 검증 비활성화 플래그입니다. |
| content.task.dns_options.udp_payload_size | integer | 선택적 EDNS UDP 페이로드 크기이며 단위는 바이트입니다. 의미 범위는 실행 측에서 검증합니다. |
| content.task.certificate.ca | string | DNS 선택 사항이며 PEM CA입니다. |
| content.task.certificate.certificate | string | DNS 선택 사항이며 PEM 클라이언트 인증서입니다. |
| content.task.certificate.private_key | string | DNS 선택 사항이며 PEM 개인 키를 안전하게 주입합니다. |
| content.task.certificate.ignore_server_certificate_error | boolean | DNS 선택 사항이며 인증서 검증 무시 여부입니다. |
| content.task.success_when[].authenticated_data | boolean | DNS 선택적 리프이며 다른 리프와 합계가 20을 초과할 수 없습니다. |
| content.task.success_when[].at_least_one_record | json | 선택 사항이지만 나타날 경우 비어 있지 않은 객체여야 하며 레코드 유형별로 그룹화합니다. |
| content.task.success_when[].at_least_one_record.of_type_a | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_a[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_a[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_a[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_a[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_a[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_aaaa[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_cname | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_cname[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_cname[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_cname[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_cname[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_cname[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_mx | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_mx[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_mx[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_mx[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_mx[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_mx[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_ns | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_ns[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_ns[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_ns[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_ns[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_ns[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_txt | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].at_least_one_record.of_type_txt[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_txt[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_txt[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_txt[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].at_least_one_record.of_type_txt[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record | json | 선택 사항이지만 나타날 경우 비어 있지 않은 객체여야 하며 레코드 유형별로 그룹화합니다. |
| content.task.success_when[].every_record.of_type_a | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_a[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_a[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_a[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_a[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_a[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_aaaa | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_aaaa[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_aaaa[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_aaaa[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_aaaa[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_aaaa[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_cname | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_cname[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_cname[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_cname[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_cname[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_cname[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_mx | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_mx[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_mx[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_mx[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_mx[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_mx[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_ns | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_ns[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_ns[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_ns[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_ns[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_ns[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_txt | array | 나타날 경우 비어 있지 않은 조건 배열이어야 하며 각 항목에는 비교 키가 하나만 있어야 합니다. |
| content.task.success_when[].every_record.of_type_txt[].exists | boolean | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_txt[].is | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_txt[].contains | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_txt[].match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.success_when[].every_record.of_type_txt[].not_match_regex | string | 단일 DNS 조건입니다. exists는 true만 가능하고 나머지는 비어 있지 않은 문자열이어야 합니다. 모든 DNS 조건 총계는 1..20이며 각 항목에 여러 작업을 동시에 넣을 수 없습니다. |
| content.task.advance_options.timeout | string | NetPath 전용이며 필수 1s..30s 정수 초입니다. |
| content.task.advance_options.max_ttl | integer | NetPath 전용이며 필수 TTL 상한으로 TCP/ICMP는 1..60, UDP는 1..255입니다. |
| content.task.advance_options.e2e_queries | integer | NetPath 전용이며 필수 엔드투엔드 프로브 횟수 1..100입니다. |
| content.task.advance_options.traceroute_queries | integer | NetPath 전용이며 필수 경로 프로브 횟수 1..10입니다. |
| content.task.advance_options.source_name | string | NetPath 전용이며 선택적 소스 표시 이름으로 trim 후 ≤128자이고 비어 있으면 삭제합니다. |
| content.task.advance_options.target_name | string | NetPath 전용이며 선택적 대상 표시 이름으로 trim 후 ≤128자이고 비어 있으면 삭제합니다. |
| content.task.success_when[].e2e_rtt_avg | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_rtt_avg[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_rtt_avg[].target | string | 음수가 아닌 밀리초 문자열(예: 0.5ms)이며 초나 순수 숫자를 사용할 수 없습니다. |
| content.task.success_when[].e2e_rtt_min | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_rtt_min[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_rtt_min[].target | string | 음수가 아닌 밀리초 문자열(예: 0.5ms)이며 초나 순수 숫자를 사용할 수 없습니다. |
| content.task.success_when[].e2e_rtt_max | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_rtt_max[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_rtt_max[].target | string | 음수가 아닌 밀리초 문자열(예: 0.5ms)이며 초나 순수 숫자를 사용할 수 없습니다. |
| content.task.success_when[].e2e_rtt_variation_avg | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_rtt_variation_avg[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_rtt_variation_avg[].target | string | 음수가 아닌 밀리초 문자열(예: 0.5ms)이며 초나 순수 숫자를 사용할 수 없습니다. |
| content.task.success_when[].e2e_rtt_variation_max | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_rtt_variation_max[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_rtt_variation_max[].target | string | 음수가 아닌 밀리초 문자열(예: 0.5ms)이며 초나 순수 숫자를 사용할 수 없습니다. |
| content.task.success_when[].e2e_probe_loss_percent | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_probe_loss_percent[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_probe_loss_percent[].target | number | 패킷 손실 백분율 0..100, JSON number입니다. |
| content.task.success_when[].hop_count | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].hop_count[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].hop_count[].target | integer | 음수가 아닌 홉 수 JSON integer입니다. |
| content.task.success_when[].e2e_status | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].e2e_status[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].e2e_status[].target | string | 상태 reached/partial/failed이며 e2e_status는 추가로 unknown을 허용합니다. |
| content.task.success_when[].traceroute_status | array | 비어 있지 않은 조건 배열이며 하나 이상의 지표를 선택해야 하고 알 수 없는 지표를 추가할 수 없습니다. |
| content.task.success_when[].traceroute_status[].op | string | 상태는 eq만 가능하며 숫자/소요 시간은 lt/gt/leq/geq/eq를 허용합니다. |
| content.task.success_when[].traceroute_status[].target | string | 상태 reached/partial/failed이며 e2e_status는 추가로 unknown을 허용합니다. |
| content.task.config_vars | array | 선택 사항이며 기본값은 []입니다. NetPath는 []만 허용하고 mobile은 지원하지 않습니다. 수정 시 입력 집합이 다시 바인딩됩니다. DNS에서 참조하는 id는 모두 현재 워크스페이스의 유효한 변수여야 하며 조용히 필터링되지 않습니다. |
| content.task.config_vars[].id | string | DNS는 이 필드들로 유형을 검증합니다. 전역 변수 UUID이며 type=global일 때 필수입니다. |
| content.task.config_vars[].type | string | DNS는 이 필드들로 유형을 검증합니다. 전역 global 또는 현재 작업 로컬 유형이며 브라우저 암호문 유형 secret/password/secure에는 별도 보존 규칙이 있습니다. |
| content.task.config_vars[].name | string | DNS는 이 필드들로 유형을 검증합니다. 템플릿에서 참조하는 변수 이름입니다. |
| content.task.config_vars[].value | string | DNS는 이 필드들로 유형을 검증합니다. 로컬 변수 값이며 보안 소스에서 주입합니다. 해당되지 않는 필드는 생략합니다. |
| content.task.config_vars[].example | string | DNS는 이 필드들로 유형을 검증합니다. 미리보기/예시 값이며 실제 대상 소스의 대체 값이 아닙니다. |
| content.task.config_vars[].secure | boolean | DNS는 이 필드들로 유형을 검증합니다. 보안 변수 여부이며 유형은 불리언입니다. |
| content.task.address | string | mobile 필수이며 trim 후 비어 있지 않고 ≤2048자여야 하며 변수를 허용하지 않습니다. HTTP는 사용자 비밀번호와 공백/제어 문자를 금지하고 유효한 포트/경로/Query를 허용합니다. TCP는 유효한 포트가 필수입니다. ping은 포트를 추가할 수 없습니다. |
| content.task.nodeSelection | json | mobile 필수이며 mode/ids/sampleCount 정확히 세 키가 있어야 합니다. 스냅샷을 저장하며 템플릿을 동적으로 따르지 않습니다. nodes는 ID 구조만 검증하고 원래 ID/순서를 유지하며 실시간 존재 또는 매핑 완료를 보장하지 않습니다. groups는 현재 그룹과 구성원을 조회하고 노드 집합을 검증합니다. |
| content.task.nodeSelection.mode | string | mobile 필수이며 nodes는 지정 노드, groups는 지정 노드 그룹입니다. |
| content.task.nodeSelection.ids | array | mobile 필수이며 비어 있지 않고 고유한 문자열 배열입니다. 해당 리소스 id를 사용하며 region UUID가 아닙니다. |
| content.task.nodeSelection.ids[] | string | mobile 필수이며 단일 현재 노드 또는 그룹 id입니다. nodes는 영숫자, 밑줄, 하이픈만 허용합니다. |
| content.task.nodeSelection.sampleCount | integer | mobile 필수이며 각 노드에서 독립적으로 샘플링하는 횟수 1..5이며 선택한 노드/그룹 구성원 수에 제한되지 않습니다. |
| content.task.protocolOptions | json | 선택 사항이며 기본값은 {}이고 전체 교체됩니다. HTTP에 기존 검사 필드가 있으면 수정 시 객체를 명시적으로 제공해야 합니다. 객체에서 특정 검사 필드를 생략해야만 제거되며 빈 문자열/null/빈 배열은 제거 지시가 아닙니다. HTTP 기본 httpMethod=GET, ping 기본 pingType=1이며 다른 숫자 값은 Studio가 기본값을 보충하지 않습니다. |
| content.task.protocolOptions.httpMethod | string | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. GET/POST입니다. |
| content.task.protocolOptions.body | string | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 요청 본문 문자열입니다. |
| content.task.protocolOptions.httpHost | json | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 문자열 매핑이며 대상 Host에 맞게 구성합니다. |
| content.task.protocolOptions.httpHost.键名 | string | 동적 문자열 멤버이며 변수 템플릿을 허용하지 않습니다(expectedResponseBody 제외). |
| content.task.protocolOptions.httpParams | json | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. Query 매개변수 문자열 매핑입니다. |
| content.task.protocolOptions.httpParams.键名 | string | 동적 문자열 멤버이며 변수 템플릿을 허용하지 않습니다(expectedResponseBody 제외). |
| content.task.protocolOptions.httpHeader | json | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 요청 헤더 문자열 매핑입니다. |
| content.task.protocolOptions.httpHeader.键名 | string | 동적 문자열 멤버이며 변수 템플릿을 허용하지 않습니다(expectedResponseBody 제외). |
| content.task.protocolOptions.expectedResponseBody | string | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 비어 있지 않은 원문 포함 일치이며 trim하지 않고 내부 템플릿 표시도 해석하지 않습니다. |
| content.task.protocolOptions.expectedResponseCode | array | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 비어 있지 않은 JSON 정수 배열이며 허용 코드 집합이고 텍스트 정규식과 혼용하지 않습니다. 여러 검사 조합 판정은 실행 플랫폼의 실제 계약을 따릅니다. |
| content.task.protocolOptions.expectedResponseCode[] | integer | http 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 단일 JSON 정수 코드이며 문자열/불리언을 사용할 수 없습니다. |
| content.task.protocolOptions.dnsHost | string | dns 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. DNS 서버/호스트 문자열입니다. |
| content.task.protocolOptions.dnsIpVerify | string | dns 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 예상 DNS 확인 IP 문자열입니다. |
| content.task.protocolOptions.tcpHost | string | tcp 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. TCP 대상 Host 구성입니다. |
| content.task.protocolOptions.tcpTimeoutMs | integer | tcp 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 타임아웃 1..10000밀리초입니다. |
| content.task.protocolOptions.tcpData | string | tcp 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 전송 데이터 텍스트입니다. |
| content.task.protocolOptions.tcpVerify | string | tcp 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 예상 응답 텍스트입니다. |
| content.task.protocolOptions.pingType | integer | ping 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 1/2이며 생략 시 1입니다. |
| content.task.protocolOptions.pingCount | integer | ping 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 전송 횟수 1..10입니다. |
| content.task.protocolOptions.pingTimeoutMs | integer | ping 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 타임아웃 1..10000밀리초입니다. |
| content.task.protocolOptions.taskTimeoutMs | integer | http/dns/tcp/ping 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 작업 타임아웃 1..10000밀리초입니다. |
| content.task.protocolOptions.flowLimit | integer | http/dns/tcp/ping 전용이며 선택 사항이고 생략 시 플랫폼 기본값을 따릅니다. 플랫폼 트래픽 제한 정수 1..10이며 Studio는 추가 단위 변환을 정의하지 않습니다. |
| content.tagInfo | array<object> | 유효 태그 요약이며 빈 []입니다. 일반 수정에서는 생략될 수 있고 mobile 수정에서는 반환됩니다. 읽기 id는 데이터베이스 숫자이며 쓰기 생성 요약 id는 태그 UUID 문자열일 수 있습니다. |
| content.tagInfo[].id | integer 또는 string | 읽기는 데이터베이스 번호, 쓰기는 태그 UUID입니다. |
| content.tagInfo[].uuid | string | 읽은 태그 UUID이며 쓰기 분기에서는 생략될 수 있습니다. |
| content.tagInfo[].name | string | 태그 이름입니다. |
| content.tagInfo[].description | string | 읽은 태그 설명입니다. |
| content.tagInfo[].colour | string | 읽은 태그 색상입니다. |
| content.tagInfo[].scope | array<string> | 쓰기 요약에는 정규화된 범위가 포함될 수 있습니다. |
| content.tagInfo[].scope[] | string | 단일 범위입니다. |
| content.declaration | object | 공통 선언입니다. |
{
"code": 200,
"content": {
"id": 101,
"uuid": "dial_clone_example",
"workspaceUUID": "wksp_example",
"type": "mobile",
"status": 0,
"isLocked": false,
"regions": [],
"regionsInfo": [],
"task": {
"name": "移动HTTPS检查副本",
"frequency": "5m",
"protocol": "http",
"address": "https://example.com/health",
"nodeSelection": {
"mode": "nodes",
"ids": [
"NODE-ID"
],
"sampleCount": 1
},
"protocolOptions": {
"httpMethod": "GET",
"taskTimeoutMs": 10000,
"expectedResponseCode": [
200
]
},
"status": "ok"
},
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427200,
"deleteAt": -1,
"tagInfo": [],
"remoteStatus": "unknown",
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
모바일 원격/로컬 실패에는 taskUUID/localSaved/localStatus/remoteStatus/outcomeUnknown이 포함될 수 있습니다. 복제본이 이미 저장되었거나 원격에서 생성되었는지 먼저 확인하고, 실패 응답을 완전히 실행되지 않은 것으로 간주하지 마십시오.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반했습니다. | 매개변수 파싱 실패 | 매개변수 위치, 필드 이름, 유형 및 값을 확인합니다. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않습니다. | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정합니다. |
| 400 | ft.JsonFormatError | Body가 객체가 아닙니다. | 일부 json 파일 형식 오류 | name 및 선택적 tags를 포함한 JSON 객체를 제출합니다. |
| 400 | ft.ParamsValidateError | 식별자, 노드 선택 구조/범위, 이름, 템플릿 수 또는 프로토콜 매개변수가 현재 계약과 일치하지 않습니다. | 매개변수 검증 실패: {} | message 및 선택적 content.reason/field에 따라 수정하고, 먼저 현재 워크스페이스 목록에서 대상을 다시 가져옵니다. |
| 400 | ft.InvalidAction | 모바일 신서틱 테스트가 현재 활성화되지 않았거나 허용되지 않는 작업/트랜잭션 상태가 있습니다. | 유효하지 않은 작업 | 관리자가 모바일 신서틱 테스트 기능을 확인합니다. 템플릿 읽기/삭제는 스위치 비활성화로 자동 금지되지 않습니다. |
| 400 | ft.DialingServerError | 모바일 서비스 호출 실패, 리소스 반환 형식/바인딩 정보 불일치입니다. | 신서틱 테스트 서비스 인터페이스 호출 실패 | reason, outcomeUnknown을 확인하고 traceId와 함께 검증합니다. 정적 매핑 누락으로 업스트림 실패를 감추면 안 됩니다. |
| 409 | ft.MobileDialingOperationBusy | 워크스페이스 상호 배제 잠금 대기 시간 초과로 이번 요청은 실행되지 않았습니다. | 현재 워크스페이스에서 다른 작업이 진행 중이라 이번 작업은 실행되지 않았습니다. 나중에 다시 시도하십시오. | operationExecuted=false/retryable=true이면 백오프 후 재시도하고 동시에 덮어쓰지 않습니다. |
| 401 | ft.WKSPNotExistOrReleased | 대기 후 워크스페이스가 더 이상 존재하지 않거나 해제되었습니다. | 워크스페이스가 존재하지 않거나 해제되었습니다. | 재시도를 중지하고 유효한 워크스페이스를 확인합니다. |
| 403 | ft.WorkspaceIsLocked | 대기 후 워크스페이스가 잠겼습니다. | 워크스페이스가 잠겨 작업할 수 없습니다. | 잠금 해제 및 작업 가능 상태를 확인합니다. |
| 404 | ft.NotFoundDialTask | 원본 작업이 현재 워크스페이스의 삭제되지 않은 집합에 속하지 않습니다. | 지정한 클라우드 신서틱 테스트 작업을 찾을 수 없습니다 | 목록에서 mobile 소스를 다시 가져옵니다. |
| 400 | ft.TaskNameRepeat | 새 이름이 현재 워크스페이스에 이미 있는 삭제되지 않은 신서틱 테스트와 충돌합니다. | 현재 워크스페이스에 같은 이름의 작업 {}이(가) 이미 있습니다 |
고유한 이름으로 변경하고 결과가 알 수 없는 동일 요청을 반복 제출하지 않습니다. |
| 403 | ft.MobileDialTermsNotAccepted | 워크스페이스가 모바일 신서틱 테스트 약관을 수락하지 않았습니다. | 먼저 워크스페이스 Owner 또는 관리자가 모바일 신서틱 테스트 사용 약관을 확인해야 합니다. | 로그인한 Owner/관리자가 읽고 확인합니다. |
| 403 | ft.InvalidTimeFrequency | 원본 주기가 현재 무료/체험 버전에서 지원되지 않습니다. | 시간 주기가 유효하지 않습니다 | 먼저 허용된 주기로 조정하거나 버전을 확인합니다. |
| 400 | ft.TagScopeMismatch | 지정/상속된 태그가 신서틱 테스트에 적용되지 않습니다. | 태그 범위가 일치하지 않습니다 | 유효한 dialing/all 태그를 사용합니다. |
| 500 | ft.InternalServerError | 저장소 읽기, 기존 구성 또는 로컬 정적 매핑 형식 지정 예외입니다. | 내부 오류 | 특정 작업/템플릿 또는 필터로 범위를 좁히고, 지속 실패 시 traceId를 보관하여 읽기 단계를 확인합니다. |