콘텐츠로 이동

【모바일 테스트】노드 선택 템플릿 상세



GET /api/v1/dialing_task/mobile/templates/{template_uuid}

개요

단일 모바일 테스트 노드 선택 템플릿을 읽습니다.

호출 전 및 사용 단계

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

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

라우트 파라미터

파라미터명 유형 필수 설명
template_uuid string Y 작업 UUID 또는 nodeSelection.ids의 멤버가 아닙니다.
예: dsel_example
가져오기 또는 입력 방법: 노드 선택 템플릿 목록에서 현재 워크스페이스의 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/dsel_example' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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

필드 유형 설명
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 발생 조건 메시지 또는 응답 설명 처리 방법
400 ft.ParamsValidateError 식별자, 노드 선택 구조/범위, 이름, 템플릿 수 또는 프로토콜 파라미터가 현재 계약과 일치하지 않음 파라미터 유효성 검사 실패: {} message와 선택적 content.reason/field에 따라 수정하고, 먼저 현재 워크스페이스 목록에서 대상을 다시 가져옵니다.
500 ft.InternalServerError 스토리지 읽기, 과거 구성 또는 로컬 정적 매핑 형식 지정 예외 내부 오류 구체적인 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인합니다.

문서 평가

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