콘텐츠로 이동

【모바일 신서틱 테스트】노드 선택 템플릿 목록



GET /api/v1/dialing_task/mobile/templates

개요

현재 워크스페이스의 모바일 신서틱 테스트 노드 선택 템플릿 목록을 조회합니다.

호출 전 및 사용 단계

저장된 스냅샷을 조회하며 실행 플랫폼에 실시간으로 액세스하지 않습니다. 모바일 신서틱 테스트 스위치가 꺼져 있어도 조회할 수 있습니다. 목록이 구성되지 않은 경우 []를 반환하며, 페이지네이션하지 않고 정렬을 보장하지 않으며, 최대 개수는 저장 API에서 제어합니다. 템플릿에는 이름과 노드 선택만 포함되고 HTTP/TCP 대상 또는 프로토콜 구성은 포함되지 않으며, 사용 시 nodeSelection을 새 작업에 복사합니다.

selectedNodeMappings는 nodes의 정적 표시 정보만 보완하며, groups이거나 매핑이 누락된 경우 비어 있을 수 있습니다. 조회에 성공하더라도 해당 ID가 현재 온라인임을 보장하지 않습니다. 편집/삭제에는 현재 워크스페이스의 templateUUID를 사용하며, 템플릿을 수정해도 저장된 작업이 자동으로 업데이트되지 않습니다.

요청 헤더

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

매개변수 추가 설명

반환되는 각 템플릿 항목에는 selectedNodeMappings 배열이 포함되며, 요소는 resources.nodes[].mapping을 재사용합니다: nodeId:string, continent/country/province/city/operator:{code,zh,en}|null, network/client_type:string. nodeSelection.ids의 현재 데이터베이스 표시 매핑만 가져오며, ID는 문자열로 변환하고 중복을 제거하며, 찾을 수 없으면 건너뜁니다. 매핑이 없거나 groups 모드이면 []를 반환합니다. 표시 정보는 실시간 사용 가능 여부를 의미하지 않으며, 목록 배치에서는 매핑을 한 번만 읽습니다. 이 필드는 읽기 전용이며 영구 저장되지 않으므로 저장 시 반환해서는 안 됩니다. 기존 실시간 리소스 및 선택 유효성 검사는 유지됩니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/dialing_task/mobile/templates' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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

필드 유형 설명
content array<object> 워크스페이스 템플릿 배열이며, 구성이 없으면 []입니다.
content[].templateUUID string dsel_워크스페이스 내 템플릿 UUID이며, 작업 또는 노드 ID가 아닙니다.
content[].name string trim 처리된 템플릿 이름입니다.
content[].nodeSelection object 저장된 노드 선택 스냅샷이며 작업에 복사되고 실시간 참조가 아닙니다.
content[].nodeSelection.mode string nodes/groups.
content[].nodeSelection.ids array<string> 비어 있지 않고 중복이 없는 원본 노드 또는 그룹 ID 배열입니다. 저장 전 중복을 거부하며 원본 ID/순서를 유지하고 region UUID를 전달할 수 없습니다.
content[].nodeSelection.ids[] string 해당 리소스 id입니다.
content[].nodeSelection.sampleCount integer 각 노드별 독립 샘플링 횟수는 1..5입니다.
content[].selectedNodeMappings array<object> nodes의 선택된 정적 매핑만 표시하며 실시간 가용성을 조회하지 않습니다. 누락되었거나 groups인 경우 []입니다.
content[].selectedNodeMappings[].nodeId string 노드 문자열 ID입니다.
content[].selectedNodeMappings[].network string 정적 네트워크 유형입니다.
content[].selectedNodeMappings[].client_type string 정적 클라이언트 유형입니다.
content[].selectedNodeMappings[].continent object 또는 null 정적 지역/통신사 레이블이며 province는 null일 수 있습니다.
content[].selectedNodeMappings[].continent.code string 출처 코드.
content[].selectedNodeMappings[].continent.zh string 중국어 이름.
content[].selectedNodeMappings[].continent.en string 영어 이름.
content[].selectedNodeMappings[].country object 또는 null 정적 지역/통신사 레이블이며 province는 null일 수 있습니다.
content[].selectedNodeMappings[].country.code string 출처 코드.
content[].selectedNodeMappings[].country.zh string 중국어 이름.
content[].selectedNodeMappings[].country.en string 영어 이름.
content[].selectedNodeMappings[].province object 또는 null 정적 지역/통신사 레이블이며 province는 null일 수 있습니다.
content[].selectedNodeMappings[].province.code string 출처 코드.
content[].selectedNodeMappings[].province.zh string 중국어 이름.
content[].selectedNodeMappings[].province.en string 영어 이름.
content[].selectedNodeMappings[].city object 또는 null 정적 지역/통신사 레이블이며 province는 null일 수 있습니다.
content[].selectedNodeMappings[].city.code string 출처 코드.
content[].selectedNodeMappings[].city.zh string 중국어 이름.
content[].selectedNodeMappings[].city.en string 영어 이름.
content[].selectedNodeMappings[].operator object 또는 null 정적 지역/통신사 레이블이며 province는 null일 수 있습니다.
content[].selectedNodeMappings[].operator.code string 출처 코드.
content[].selectedNodeMappings[].operator.zh string 중국어 이름.
content[].selectedNodeMappings[].operator.en string 영어 이름.
content[].declaration object 비어 있지 않은 각 템플릿의 공통 선언입니다.
{
  "code": 200,
  "content": [
    {
      "templateUUID": "dsel_example",
      "name": "生产节点",
      "nodeSelection": {
        "mode": "nodes",
        "ids": [
          "NODE-ID"
        ],
        "sampleCount": 1
      },
      "selectedNodeMappings": [],
      "declaration": {}
    }
  ],
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
500 ft.InternalServerError 저장소 읽기, 이전 구성 또는 로컬 정적 매핑 형식 지정 예외 내부 오류 구체적인 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인하세요.

문서 평가

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