Cisco Cisco Identity Services Engine 1.3 Leaflet
5-6
Cisco Identity Services Engine API
참조 가이드, 릴리스 1.4
OL-26134-01
5
장 ERS API 소개
외부 RESTful 서비스 요청 및 응답
외부 RESTful 서비스 응답 헤더
공통 외부 RESTful 서비스 HTTP 상태 코드
표
5-2
ERS
필수
응답
헤더
헤더
지원되는 값
사용 설명
필수
Content-Length
응답 메시지 본문 길이(바이트) 메시지 본문 크기를 설명합니다. 예, 메시지 본문을 포함하는
응답 시 필요합니다.
Content-Type
응답 메시지 본문을 설명하는
미디어 유형
응답 메시지 본문의 표시 및 구
문을 설명합니다.
예, 메시지 본문을 포함하는
응답 시 필요합니다.
Location
새로 생성한 리소스의 정식
URI
새로 생성한 리소스의 표시를
요청하는 데 사용할 수 있는 새
로운 URI를 반환합니다.
예, URI를 통해 액세스할 수
있는 새로운 서버 측 리소스를
생성하는 요청에 대한 응답 시
필요합니다.
표
5-3
ERS
에서
반환된
HTTP
응답
코드
설명
HTTP
상태
설명
200 OK
요청이 성공적으로 완료되었습니다. 이 요청이 URI를 통해 주소 지정 가능
한 새 리소스를 생성한 경우, 새 리소스의 표시를 포함하는 응답 본문이 반
환되며 200 상태는 새로 생성한 리소스의 정식 URI를 포함하는 Location 헤
더와 함께 반환됩니다.
201 Created
새 리소스를 생성한 요청이 완료되었고 새 리소스의 표시를 포함하는 응답
본문이 반환되지 않습니다. 새로 생성한 리소스의 정식 URI를 포함하는
Location
Location
헤더도 반환되어야 합니다.
202 Accepted
요청이 처리를 위해 수락되었지만 처리가 완료되지 않았습니다. HTTP/1.1
사양별로, 반환된 엔터티(있는 경우)는 요청의 현재 상태에 대한 표시 또는
상태 모니터에 대한 포인터나 사용자가 요청을 완료할 것으로 예상 가능한
시기의 추정치 일부를 포함해야 합니다.
204 No Content
서버에서 요청을 완료했지만 응답 메시지 본문을 반환할 필요가 없습니다.
400 Bad Request
요청에서 정보가 누락되었거나 잘못된 정보가 포함되었기 때문에 요청을
처리할 수 없습니다(예: 입력 필드의 검증 오류, 필수 값 누락 등).
401 Unauthorized
이 요청에 포함된 인증 자격 증명이 누락되었거나 잘못되었습니다.
403 Forbidden
서버가 자격 증명을 인식했지만 사용자에게 이 요청을 수행할 수 있는 권한
이 없습니다.
404 Not Found
요청이 존재하지 않는 리소스의 URI를 지정했습니다.
405 Method Not
Allowed
Allowed
요청에 지정된 HTTP 동사(DELETE, GET, HEAD, POST, PUT)가 이 요청
URI
URI
에 대해 지원되지 않습니다.
406 Not
Acceptable
Acceptable
이 요청에서 확인된 리소스는 요청의 Accept 헤더 내 미디어 유형 중 하나
와 일치하는 표시를 생성할 수 없습니다.
409 Conflict
생성 또는 업데이트 요청이 서버에서 지원되는 리소스의 현재 상태에서 충
돌을 야기하기 때문에 이 요청을 완료할 수 없습니다(예: 일부 기존 리소스
에 이미 할당된 고유 식별자가 있는 새 리소스를 생성하려는 시도).