taxii-api-root
TAXII 2.x 서버의 특정 API 루트에 대한 일반 정보를 조회합니다. 지원하는 TAXII 버전, 최대 콘텐츠 길이 등의 API 루트 메타데이터를 가져옵니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 사용자 권한 |
| 라이선스 사용량 | 라이선스 집계와 무관한 명령어 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
taxii-api-root profile=profile_name apiroot=api_root_name
옵션
profile=profile_name- 사용할 TAXII 접속 프로파일 이름입니다. 쉼표로 구분하여 여러 프로파일을 지정할 수 있습니다.
apiroot=api_root_name- 조회할 TAXII API 루트 이름입니다. 필수 옵션입니다.
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| profile | 문자열 | 접속 프로파일 이름 |
| title | 문자열 | API 루트 제목 |
| description | 문자열 | API 루트 설명 |
| versions | 배열 | API 루트가 지원하는 TAXII 버전 목록 |
| max_content_length | 64비트 정수 | API 루트가 허용하는 최대 콘텐츠 크기(바이트) |
| _error | 문자열 | 오류 발생 시 오류 메시지 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 201800 | No available TAXII profile found. | 사용 가능한 TAXII 프로파일이 없는 경우 |
| 201801 | Specify valid TAXII profile. | 지정한 TAXII 프로파일 이름이 유효하지 않은 경우 |
| 201802 | Specify apiroot option | apiroot 옵션을 지정하지 않은 경우 |
설명
TAXII 서버의 특정 API 루트 엔드포인트에 요청을 보내 해당 API 루트의 메타데이터를 조회합니다. profile 옵션과 apiroot 옵션은 필수입니다. 오류가 발생하면 해당 레코드의 _error 필드에 오류 메시지가 기록됩니다.
사용 예
-
TAXII API 루트 정보 조회
taxii-api-root profile="my-taxii" apiroot="taxii"my-taxii접속 프로파일을 사용하여taxiiAPI 루트의 정보를 조회합니다.
호환성
taxii-api-root 명령어는 소나 4.0 이전 버전부터 제공되었습니다.