Листовка для Cisco Cisco Identity Services Engine 1.3
6-9
Cisco Identity Services Engine API
참조 가이드, 릴리스 1.4
OL-26134-01
6
장 게스트 REST API
검색 및 필터링
검색 및 필터링
모든 필터링 및 검색 작업은 필터링을 사용하여 수행됩니다.
리소스 URI에 GET 요청을 전송하여 리소스를 검색하십시오. 기본적으로, 결과는 기본 크기가 20인
리소스 URI에 GET 요청을 전송하여 리소스를 검색하십시오. 기본적으로, 결과는 기본 크기가 20인
첫 페이지(페이지 인덱스 = 0)입니다. 클라이언트가 다음 섹션에 설명되어 있는 필터링, 정렬 및
페이징 매개변수를 URI에 추가하여 이 검색을 제어할 수 있습니다.
페이징, 필터링 또는 정렬 요청의 결과에 해당하는 리소스는
페이징, 필터링 또는 정렬 요청의 결과에 해당하는 리소스는
<resources>
모음에 번들로 제공되며
여기에는 각 리소스에 대한 이름, ID, 설명 및 전체 표시에 대한 링크가 포함되어 있습니다. 이 모
음은 클라이언트가 리소스를 쉽게 분류할 수 있는 기능을 제공합니다.
필터링 매개변수
필터링은 필터 쿼리 문자열 매개변수를 통해 가능합니다. 필터의 구조는 점으로 구분되는 필드 연산
자, 매개변수 및 값의 3자리 ID입니다. 예를 들어,
filter=name.STARTSW.g
를 사용하여 문자 'g'로 시
작하는 사용자 이름의 모든 게스트 사용자를 찾으십시오.
필터에서 여러 매개변수를 사용하는 경우 결과는 해당 매개변수의 AND가 됩니다. 이는 결과가 API
필터에서 여러 매개변수를 사용하는 경우 결과는 해당 매개변수의 AND가 됩니다. 이는 결과가 API
에 전송된 모든 매개변수와 일치하는 사용자임을 의미합니다. 각 리소스 설명은 특성이 필터링된 필
드인지 여부를 지정합니다.
참고
잘못된 필터 값의 결과는 일치하는 메시지가 있는 상태
400 (Bad Request)
입니다.
다음 표는 필터 쿼리에서 사용 가능한 매개변수를 보여줍니다.
표
6-6
버전
일치
결과
버전 일치
결과
전송된 버전 없음
서버가
415 "
지원되지 않는 미디어 유형"
상태를
반환합니다.
클라이언트 버전이 서버 버전과 일치
서버가 요청 처리를 진행합니다.
클라이언트 부 버전이 서버 부 부전과 일치하
지 않음
서버가 버전 차이를 설명하는 응답 경고 메시
지를 추가하고 요청 처리를 진행합니다.
클라이언트와 서버의 주요 버전이 일치하지
않음
서버가 해당하는 오류 메시지와 함께 상태
415
를 반환합니다.
표
6-7
필터링
매개변수
매개변수
설명
firstName
게스트의 이름
lastName
게스트의 성
emailAddress
게스트의 이메일 주소
userName
게스트 계정 사용자 이름
creationTime
게스트 계정이 생성된 시간
toDate
게스트 계정의 만료일