Cisco Cisco ASA 5540 Adaptive Security Appliance 빠른 설정 가이드

Cisco ASA REST API 빠른 시작 설명서

마지막 업데이트: 2015년 6월

  ASA REST API 요청 및 응답

    주의

ASA에서 REST API가 활성화된 경우 다른 보안 관리 프로토콜에 의한 연결이 차단되지 않습니다. 
즉, 자신이 동일한 작업을 수행하는 동안 CLI, ASDM 또는 Security Manager를 사용하는 다른 사용
자가 ASA 컨피그레이션을 변경할 수 있습니다.

ASA REST API 요청 및 응답

ASA REST API는 REST(Representational State Transfer) API를 통해 개별 ASA를 관리하기 위한 프
로그램 방식의 액세스를 제공합니다. API를 사용하면 외부 클라이언트가 ASA 리소스에 대해 
CRUD(Create, Read, Update, Delete) 작업을 수행할 수 있습니다. HTTPS 프로토콜 및 REST 방법론
이 기반이 됩니다.

모든 API 요청은 HTTPS를 통해 ASA에 전송되고 응답이 반환됩니다.

이 섹션에서는 요청이 구성되는 방법 및 예상 응답에 대한 개요를 제공합니다.

요청 구조

사용 가능한 요청 메서드:

GET – 지정된 개체에서 데이터를 검색합니다.

PUT - 제공된 정보를 지정된 개체에 추가합니다. 개체가 없을 경우 404 Resource Not Found(404 
리소스를 찾을 수 없음) 오류가 반환됩니다.

POST – 제공된 정보로 개체를 만듭니다.

DELETE – 지정된 개체를 삭제합니다.

PATCH – 지정된 개체에 부분 수정을 적용합니다.

응답 구조

각 요청은 표준 헤더, 응답 콘텐츠 및 상태 코드로 ASA에서 HTTPS 응답을 생성합니다.

응답 구조는 다음과 같을 수 있습니다.

LOCATION – 새로 만든 리소스 ID. POST 전용 - 새 리소스 ID 보유(URI 표현으로서).

CONTENT-TYPE – 응답 메시지 본문을 설명하는 미디어 유형. 응답 메시지 본문의 표현 및 구
문을 설명.

각 응답은 HTTP 상태 또는 오류 코드를 포함합니다. 사용 가능한 코드의 범주는 다음과 같습니다.

 

20x

 - 다음을 비롯한 200 계열 코드는 성공적인 작업을 나타냅니다.

200 OK

 – 성공적인 요청의 표준 응답.

201 Created

 – 요청이 완료되었으며 새 리소스가 생성됨.

202 Accepted

 – 요청이 수락되었지만 처리가 완료되지 않음.

204 No Content

 – 서버가 성공적으로 요청을 처리했으며 콘텐츠가 반환되지 않음.

4xx

 - 다음을 비롯한 400 계열 코드는 클라이언트 측 오류를 나타냅니다.

400 Bad Request

 – 인식할 수 없는 매개 변수, 누락된 매개 변수 또는 잘못된 값을 비롯

한 유효하지 않은 쿼리 매개 변수.