조회¶
GET /api/v1/dialing_task/{task_uuid}/get
개요¶
단일 신서틱 테스트의 저장된 전체 구성과 만료된 노드 안내를 조회합니다.
호출 전 및 사용 단계¶
목록에서 현재 워크스페이스의 작업 UUID를 가져옵니다. 삭제되지 않은 객체만 조회하며 최신 실행 결과는 조회하지 않습니다. 일반 노드 정보는 UUID 배열/객체 배열/UUID 매핑을 지원합니다. 만료된 노드 이름은 요청 언어에 따라 표시되며, 노드 센터 장애 시 안내가 비어 있는 형태로 저하될 수 있습니다.
모바일 상세에서는 내부 provider/보고 자격 증명 등의 필드를 제거하고 remoteStatus는 unknown으로 고정됩니다. selectedNodeMappings는 선택된 정적 매핑만 보완하며 노드의 실시간 사용 가능 여부를 보장하지 않습니다. 과거 브라우저 보안 변수의 value는 null로 반환되므로 응답을 그대로 수정 요청으로 사용할 수 없습니다. 상세에서는 creatorInfo/updatorInfo를 고정적으로 보완하지 않으며, 목록에는 이러한 신원 정보가 있습니다.
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| task_uuid | string | Y | 원격 taskId, 노드 UUID, 템플릿 UUID 또는 작업 이름이 아닙니다. 예: dial_example가져오기 또는 입력 방법: 목록 content.data[].uuid에서 현재 워크스페이스의 dial_ 작업 UUID를 가져옵니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
매개변수 추가 설명¶
모바일 작업은 content 최상위(task와 동일 레벨)에서 선택적 selectedNodeMappings 배열을 반환하며, 현재 선택된 노드의 데이터베이스 표시 매핑만 포함합니다. 각 항목은 resources.nodes[].mapping을 재사용합니다: nodeId:string, continent/country/province/city/operator:{code,zh,en}|null, network/client_type:string. ID는 문자열로 변환하고 중복을 제거하며, 찾지 못하면 건너뜁니다. 매핑이 없거나 groups 모드이면 []를 반환합니다. vivo를 요청하지 않으며 노드 사용 가능 여부를 의미하지 않고 기존 실시간 노드 선택 검증을 변경하지 않습니다. 일반 작업에는 이 필드를 추가하지 않습니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/dialing_task/dial_example/get' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
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 배열이며 모바일은 []입니다. |
| 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 | 모바일은 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 | 선택 사항이며 생략 시 실행 측의 일반 빈도를 따릅니다. 모바일은 frequency만 사용하며 crontab을 지원하지 않습니다. |
| content.task.crontab | string | schedule_type=crontab일 때 비어 있지 않아야 하며 Cron 파싱을 통과해야 합니다. frequency는 여전히 공개 선언상 필수입니다. 모바일은 이 필드를 허용하지 않습니다. 시간대/실행 주기는 노드 실제 환경과 함께 검증해야 하며 Unix 타임스탬프로 간주해서는 안 됩니다. |
| content.task.url | string | HTTP/WebSocket은 프로토콜에 따라 입력합니다. 공개 계층에서는 선택 사항이지만 작업 실행에 필요합니다. 모바일에는 사용하지 않으며 모바일은 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에서 선택 사항이며 라운드당 전송 패킷 수입니다. 실제 노드 제약은 실행 측에서 확인하며 모바일의 pingCount에는 사용하지 않습니다. |
| content.task.host | string | 해당 프로토콜 비즈니스에서 필수입니다. NetPath는 trim 후 비어 있지 않아야 합니다. HTTP URL scheme을 포함할 필요가 없습니다. 모바일 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 | 단일 상태 코드 어서션 작업입니다. 모바일 expectedResponseCode 정수 배열과 혼용하지 마세요. |
| content.task.success_when[].status_code[].is_not | string | 단일 상태 코드 어서션 작업입니다. 모바일 expectedResponseCode 정수 배열과 혼용하지 마세요. |
| content.task.success_when[].status_code[].match_regex | string | 단일 상태 코드 어서션 작업입니다. 모바일 expectedResponseCode 정수 배열과 혼용하지 마세요. |
| content.task.success_when[].status_code[].not_match_regex | string | 단일 상태 코드 어서션 작업입니다. 모바일 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(필수)를 선택합니다. 모바일은 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는 []만 허용하며 모바일은 지원하지 않습니다. 수정 시 입력 집합을 다시 바인딩합니다. 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는 이러한 필드에 따라 유형을 검증합니다. 보안 변수인지 여부이며 유형은 boolean입니다. |
| content.task.address | string | 모바일 필수이며 trim 후 비어 있지 않고 ≤2048자여야 하며 변수를 허용하지 않습니다. HTTP는 사용자 비밀번호와 공백/제어 문자를 금지하고 유효한 포트/경로/Query를 허용합니다. TCP는 유효한 포트가 필수입니다. ping은 포트를 추가할 수 없습니다. |
| content.task.nodeSelection | json | 모바일 필수이며 정확히 mode/ids/sampleCount 세 키를 가져야 합니다. 스냅샷을 저장하며 템플릿을 동적으로 따르지 않습니다. nodes는 ID 구조만 검증하고 원래 ID/순서를 유지하며 실시간 존재 또는 매핑 완료를 보장하지 않습니다. groups는 현재 그룹 및 구성원을 조회하고 노드 집합을 확인합니다. |
| content.task.nodeSelection.mode | string | 모바일 필수이며 nodes는 지정 노드, groups는 지정 노드 그룹입니다. |
| content.task.nodeSelection.ids | array | 모바일 필수이며 비어 있지 않고 고유한 문자열 배열입니다. 해당 리소스 id를 가져오며 region UUID가 아닙니다. |
| content.task.nodeSelection.ids[] | string | 모바일 필수이며 단일 현재 노드 또는 그룹 id입니다. nodes는 영문/숫자/밑줄/하이픈만 가능합니다. |
| content.task.nodeSelection.sampleCount | integer | 모바일 필수이며 각 노드에서 독립적으로 샘플링하는 횟수 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> | 유효한 태그 요약, 빈 []입니다. 일반 수정에서는 생략될 수 있고 모바일 수정에서는 반환됩니다. 읽기 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.ifContainExpiredRegion | boolean | 식별된 만료 노드 포함 여부입니다. 노드 서비스 읽기 실패 시 false로 저하될 수 있으며 실시간 가용성 보장이 아닙니다. |
| content.expiredRegionList | array<string> | get 전용: 식별된 만료 노드 표시 이름 목록이며 모바일은 []입니다. |
| content.expiredRegionList[] | string | 노드 표시 이름입니다. |
| content.selectedNodeMappings | array<object> | mobile 상세 전용: 선택된 nodes의 정적 표시 매핑입니다. groups 또는 매핑 누락 시 []일 수 있으며 현재 실시간 사용 가능을 증명하지 않습니다. |
| content.selectedNodeMappings[].nodeId | string | 선택된 노드 ID입니다. |
| content.selectedNodeMappings[].network | string | 정적 네트워크 유형입니다. |
| content.selectedNodeMappings[].client_type | string | 정적 클라이언트 유형입니다. |
| content.selectedNodeMappings[].continent | object 또는 null | 정적 지역/통신사 레이블, 기본값 null입니다. |
| content.selectedNodeMappings[].continent.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].continent.zh | string | 중국어 표시 이름입니다. |
| content.selectedNodeMappings[].continent.en | string | 영어 표시 이름입니다. |
| content.selectedNodeMappings[].country | object 또는 null | 정적 지역/통신사 레이블, 기본값 null입니다. |
| content.selectedNodeMappings[].country.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].country.zh | string | 중국어 표시 이름입니다. |
| content.selectedNodeMappings[].country.en | string | 영어 표시 이름입니다. |
| content.selectedNodeMappings[].province | object 또는 null | 정적 지역/통신사 레이블, 기본값 null입니다. |
| content.selectedNodeMappings[].province.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].province.zh | string | 중국어 표시 이름입니다. |
| content.selectedNodeMappings[].province.en | string | 영어 표시 이름입니다. |
| content.selectedNodeMappings[].city | object 또는 null | 정적 지역/통신사 레이블, 기본값 null입니다. |
| content.selectedNodeMappings[].city.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].city.zh | string | 중국어 표시 이름입니다. |
| content.selectedNodeMappings[].city.en | string | 영어 표시 이름입니다. |
| content.selectedNodeMappings[].operator | object 또는 null | 정적 지역/통신사 레이블, 기본값 null입니다. |
| content.selectedNodeMappings[].operator.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].operator.zh | string | 중국어 표시 이름입니다. |
| content.selectedNodeMappings[].operator.en | string | 영어 표시 이름입니다. |
| content.declaration | object | 공개 선언입니다. |
{
"code": 200,
"content": {
"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,
"expiredRegionList": [],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.ObjectNotExists | 현재 워크스페이스에 해당 삭제되지 않은 작업이 없음 | 지정한 객체가 존재하지 않음 | 목록에서 유효한 uuid를 다시 가져옵니다. 삭제된 객체는 이 인터페이스로 복구할 수 없습니다. |
| 500 | ft.InternalServerError | 브랜드/워크스페이스/데이터베이스/과거 JSON 형식 또는 결과 조립에서 포착되지 않은 예외 발생 | 내부 오류 | 구체적인 작업 UUID로 좁혀 확인하고 traceId를 보관합니다. 만료 노드 가져오기 실패 시 저하될 수 있으며 false로 노드가 정상이라고 판단할 수 없습니다. |