3장. API의 규칙 사용
자동화 컨트롤러는 서버의 /api/
에 루트화된 표준 REST API를 사용합니다.
API는 호환성을 위해 버전이 지정되었습니다. /api/
를 쿼리하여 사용할 수 있는 API 버전을 확인할 수 있습니다.
POST
또는 PUT
요청에 콘텐츠 또는 유형을 지정해야 할 수 있습니다.
-
PUT
: 특정 리소스(ID별) 또는 리소스 컬렉션을 업데이트합니다. 리소스 ID를 미리 알고 있는 경우PUT
을 사용하여 특정 리소스를 생성할 수도 있습니다. -
POST
: 새 리소스를 생성합니다. 또한 다른 카테고리에 맞지 않는 작업에 대해 다양한 동사 역할을 합니다.
"/"로 끝나지 않는 모든 URI는 301 리디렉션을 수신합니다.
참고
작업 템플릿 레코드에 연결된 extra_vars
의 포맷은 유지됩니다. YAML은 포맷과 주석이 보존된 YAML로 반환되고 JSON은 JSON으로 반환됩니다.