Cisco Cisco Identity Services Engine 1.3 전단

다운로드
페이지 168
 
5-7
Cisco Identity Services Engine API 
참조 가이드, 릴리스 1.4
OL-26134-01
장      ERS API 소개
  
외부 RESTful 서비스 API를 통한 버전 제어
참고
응답 헤더에 포함되어 반환되는 상태 코드 외에 각 요청은 요청의 특성에 따라 추가 xml 콘텐츠를 
포함할 수 있습니다.
외부 RESTful 서비스 API를 통한 버전 제어
외부 RESTful 서비스 API는 이전 Cisco ISE 버전과의 호환성을 제공합니다. 외부 RESTful 서비
스 API에는 API 버전 관리를 위한 버전 관리 메커니즘이 있습니다. 게스트 이외의 모든 리소스는 
버전 1.0이며 이전 버전과의 호환성이 필요하지 않습니다.
각 RESTful 리소스는 모델 버전(major.minor)을 지닙니다. 버전은 다음과 같이 구문이 있는 요청 
헤더에 속해야 합니다.
application/vnd.com.cisco.ise.<resource-namespace>.<resource-type>.<major version>.<minor 
version>+xml
예를 들어, 내부 사용자 리소스 버전 1.0을 얻기 위해 다음 요청이 전달됩니다.
DELETE https://<ISE-ADMIN-NODE>:9060/ers/config/internaluser/333
Authorization: Basic xxxxxxxxxxxxxxxxxxx
Accept: application/vnd.com.cisco.ise.identity.internaluser.1.0+xml
요청을 인증 및 권한 부여한 후에 다음 표에 언급된 일치 결과가 있는 버전 일치 검사가 수행됩니다.
415 Unsupported 
Media Type
Accept 
헤더에 지정된 미디어 유형이 이 서버에서 지원되지 않습니다. 클라
이언트 리소스 버전이 이 서버에서 더 이상 지원되지 않는 경우 이는 일반
적인 응답입니다.
429 Too many 
requests
동시에 너무 많은 ERS 요청이 있습니다.
500 Internal 
Server Error 
서버에서 요청 완료를 방해하는 예기치 않은 상태가 발생했습니다. 
501 Not 
Implemented 
서버에서 요청을 완료하는 데 필요한 기능을 (현재) 지원하지 않습니다. 
503 Service 
Unavailable 
서버의 일시적인 과부하 또는 유지 보수로 인해 서버에서 현재 이 요청을 처
리할 수 없습니다. 
5-3
ERS
에서
 
반환된
 HTTP 
응답
 
코드
 
설명
 (
계속
)
HTTP 
상태 
설명 
버전 일치
결과
전송된 버전 없음
서버가 415 "Unsupported Media Type" 상태를 반
환합니다.
클라이언트 버전이 서버 버전과 일치
서버가 요청 처리를 진행합니다.
클라이언트 부 버전이 서버 부 부전과 일치
하지 않음
서버가 버전 차이를 설명하는 응답 경고 메시지를 
추가하고 요청 처리를 진행합니다.
클라이언트와 서버의 주요 버전이 일치하지 
않음 
서버는 해당하는 오류 메시지와 함께 상태 415를 
반환합니다.