콘텐츠로 이동

목록 조회



GET /api/v1/dialing_task/list

개요

유형, 태그, 구성 상태 및 주기별로 신서틱 테스트를 페이지 단위로 조회합니다.

호출 전 및 사용 단계

목록은 현재 워크스페이스의 삭제되지 않은 구성을 읽으며, 신서틱 테스트를 실행하거나 최근 측정 결과를 조회하지 않습니다. 각 필터 차원은 AND로 결합되고, 다중 선택한 카테고리/주기와 태그 내부는 OR로 결합됩니다. 기본 정렬은 레코드 id 내림차순입니다. 공개 Query 화이트리스트는 이 표에만 적용되며, Front의 sortKey/sortMethod/expiredRegion 등 호환 항목을 이 API에 그대로 적용하지 않습니다.

ifContainExpiredRegion은 현재 워크스페이스 작업의 만료 노드 알림이며, 이 페이지의 최근 신서틱 테스트 실패와 같지 않습니다. 유형이 mobile일 때는 일반 만료 노드를 조회하지 않습니다. 노드 메타 정보 실패는 기록 후 저하되며, false로 모든 노드가 온라인임을 증명할 수 없습니다. mobile remoteStatus=unknown은 실행 플랫폼을 실시간으로 조회하지 않습니다. 목록은 모바일 내부 바인딩, 보고 자격 증명 및 브라우저 보안 변수 값을 마스킹합니다. 페이지네이션은 외부 pageInfo에 있으며 content 내부에 없습니다.

요청 헤더

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

Query 요청 파라미터

파라미터명 유형 필수 설명
dialingStatus commaArray 선택적 쉼표 배열입니다. 항목이 정확히 하나일 때만 task.status 등가 필터를 추가하며, 여러 항목일 때는 현재 상태 제한을 추가하지 않습니다. 최근 실행 성공/실패를 의미하지 않습니다.
null 허용: False
예: ok
가져오기 또는 입력 방법: 스위치를 ok/stop으로 구성하며, 전체는 전달하지 않거나 ok,stop으로 지정할 수 있습니다.
dialingTypes commaArray 선택적 쉼표 구분 값이며, 여러 값은 OR입니다. mobile은 모든 모바일을 의미하고, mobile_*은 별칭만 필터링하며 저장 시 type은 여전히 mobile입니다. type/태그/주기 조건과 계속 AND로 결합됩니다. 인식되지 않는 값은 파라미터 오류가 보장되지 않으며 일치하는 항목이 없을 수 있습니다.
null 허용: False
예: http,mobile_http
가져오기 또는 입력 방법: 저장된 카테고리 또는 mobile_http/mobile_dns/mobile_tcp/mobile_ping에서 선택합니다.
frequency commaArray 선택적 쉼표 배열이며, 값은 OR로 필터링되고 생략 시 제한하지 않습니다. Cron 표현식 검색이 아닙니다.
null 허용: False
예: 5m,15m
가져오기 또는 입력 방법: 작업 주기 집합에서 선택합니다.
pageIndex integer 선택적이며 >=1, 기본값 1입니다.
null 허용: False
$minValue: 1
예: 1
가져오기 또는 입력 방법: 첫 페이지는 1이며, 반환된 pageInfo에 따라 페이지를 넘깁니다.
pageSize integer 선택적이며 >=1, 기본값 100입니다. 공개 schema에 고정 상한이 선언되어 있지 않으므로 한 번에 너무 많이 가져오지 않도록 합니다.
null 허용: False
$minValue: 1
예: 100
가져오기 또는 입력 방법: 페이지네이션 요구에 따라 양의 정수를 선택합니다.
search string 선택적이며 기본값은 없습니다. trim 후 task.name에 대해 대소문자 구분 없이 LIKE 매칭합니다. URL/UUID 검색이 아니며, SQL 와일드카드 문자는 매칭 의미를 가질 수 있습니다.
null 허용: False
예: 站点
가져오기 또는 입력 방법: 작업 이름 키워드를 입력합니다.
tagsUUID commaArray 선택적 쉼표 배열이며, 태그 중 하나라도 연관되면 매칭됩니다. 다른 조건은 AND입니다.
null 허용: False
예: tag_example
가져오기 또는 입력 방법: 이 워크스페이스의 태그 uuid를 태그 목록에서 가져오며, 태그 이름은 전달하지 않습니다.
type string 선택적이며 기본값은 제한하지 않습니다. mobile은 모든 모바일 프로토콜을 포함합니다. multi는 type 열거형에 입력할 수 없으며 dialingTypes=multi를 사용할 수 있습니다. 다른 필터와 AND로 결합됩니다.
null 허용: False
선택 가능 값: ['http', 'browser', 'tcp', 'icmp', 'websocket', 'ssl', 'netpath', 'mobile', 'dns']
예: http
가져오기 또는 입력 방법: 저장된 작업 카테고리로 필터링하며, 공개 지원 값은 http/browser/tcp/icmp/websocket/ssl/netpath/mobile/dns입니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/dialing_task/list' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-urlencode pageIndex=1 \
  --data-urlencode pageSize=100

응답

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

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

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방식
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 파라미터 파싱 실패 파라미터 위치, 필드 이름, 유형 및 값을 확인합니다.
500 ft.InternalServerError 브랜드/워크스페이스/데이터베이스/과거 JSON 형식 또는 결과 조립 중 처리되지 않은 예외 발생 내부 오류 특정 작업 UUID로 좁혀 확인하고 traceId를 보관합니다. 만료 노드 가져오기 실패는 저하될 수 있으며 false로 노드 정상 여부를 판단할 수 없습니다.

문서 평가

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