Documentation

3. 규칙

Ansible Automation Platform 컨트롤러는 루트가 서버의 ``/api/``인 표준 REST API를 사용합니다. API는 호환성을 위해 버전이 지정되었으며, 현재 사용 가능한 최신 버전은 ``api/v2/``입니다. 사용 가능한 API 버전에 대한 정보는 ``/api/``를 쿼리하여 확인할 수 있습니다.

``/api/v1/``은 automation controller 버전 3.6부터 중단되었습니다. v1에 대한 자세한 내용은 이전 버전의 API를 참조하십시오.

POST 또는 PUT 요청에서 콘텐츠/유형을 적절하게 지정해야 할 수도 있습니다.

  • PUT: 특정 리소스(ID별) 또는 리소스 컬렉션을 업데이트합니다. 리소스 ID를 미리 알고 있는 경우 PUT을 사용하여 특정 리소스를 생성할 수도 있습니다.

  • POST: 새 리소스를 생성합니다. 또한 다른 카테고리에 맞지 않는 작업에 대해 다양한 동사 역할을 합니다.

``》/》``로 끝나지 않는 모든 URI에는 301 리디렉션이 수신됩니다.

참고

Automation Controller v4.3.0 API 변경: 작업 템플릿 레코드에 연결된 extra_vars 형식이 유지됩니다. 이전에는 YAML이 JSON으로 변환되어 JSON으로 반환되었습니다. 2.2.0 이상에서 YAML은 서식 및 주석이 보존된 YAML로 반환되고 JSON은 JSON으로 반환됩니다.