Cisco Cisco Identity Services Engine 1.3 전단

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