OpenStack API 문서¶
OpenStack API를 이용하여 서버 인스턴스를 시작하고, 이미지를 생성하고, 인스턴스와 이미지에 메타 데이터를 할당하고, 오브젝트와 컨테이너를 생성하며, OpenStack 클라우드에서 할 수 있는 모든 작업을 완료할 수 있습니다.
참고
아래 링크는 서비스의 엔드포인트 상태를 반영하는 API 상태에 따라 그룹화됩니다.
‘최신 버전(Current)’ 이란 최신으로 업데이트되었으며 이후 버전에서 포함될 안정 버전을 의미합니다. 해당 엔드 포인트는 다른 모든 것보다 우선되어야 합니다.
‘지원(Supported)’ 이란 서버에 사용가능한 안정 버전을 의미합니다. 그러나 이것은 항상 최신 버전을 뜻하는 것은 아니며 업데이트 되거나, 미래에 지원이 중단될 수 있습니다.
‘지원 중단(Deprecated)’ 이란 여전히 사용 가능한 안정 버전이나, 지원이 중단되었으며 미래에 제거될 수 있음을 의미합니다.
‘실험적인(Experimental)’ 은 안정 버전이 아님을 의미합니다. 해당 버전은 아직 개발 중에 있거나 변경 될 수 있는 다른 기능이 포함되어 있습니다.
API status values나 버전 정보에 대해 더 알고 싶다면 Version Discovery 문서를 살펴 봅니다.
API 레퍼런스 링크 다음에 있는 ‘(마이크로버전)’ 표시는 resource-by-resource 기반의 API에 작고 문서화된 변경을 가능하게 하기 위해 pattern established by the Compute service 를 따르는 API를 가리킵니다.
최신 API 버전¶
Application Container Service API (microversions)
Bare Metal API v1 (microversions)
Block Storage API v3 (microversions)
참고
블록 스토리지 API v3는 기능적으로 블록 스토리지 API v2와 같습니다. 차후 API v3 마이크로버전인 v3.1 은 API v2와 달라질 것입니다.
Compute API (microversions)
Container Infrastructure Management API (microversions)
Data Protection Orchestration v1
Domain Name Server (DNS) API v2
Placement API (microversions)
Shared File Systems API v2 (microversions)
참고
공유 파일 시스템 API v1은 기능면에서 공유 파일 시스템 v2와 동일합니다. 차후 API v2 마이크로버전인 v2.1 은 API v1과 달라질 것입니다.
지원하는 API 버전¶
지원 중단된 API 버전¶
참고
블록 스토리지 API v3는 기능적으로 블록 스토리지 API v2와 같습니다. 차후 API v3 마이크로버전인 v3.1 은 API v2와 달라질 것입니다.
API 빠른 시작 예제¶
TryStack 설치를 통해, 해당 서비스들이 설치 과정의 백그라운드에서 함께 작동하며, 상당수의 예제를 TryStack에서 작동시킬 수 있습니다.
Identity를 통해 인증이 완료된 후, 다른 OpenStack API를 사용하여 OpenStack 클라우드의 자원을 생성 및 관리할 수 있습니다. 이미지로부터 인스턴스를 구동할 수 있으며, 메타데이터를 Compute API 또는 openstack 커맨드라인 클라이언트를 통해 인스턴스에 할당할 수 있습니다.
API 요청을 보내기 위해, 다음 방법 중 하나를 선택해 사용합니다:
cURL
HTTP 요청을 보내고, 응답을 받을 수 있도록 해주는 명령 줄 도구입니다. 자세한 설명은 OpenStack APIs 에서 확인할 수 있습니다.
OpenStack 명령줄 클라이언트
사용하기 쉬운 명령어를 통해 API에 접근하도록 해 주는 커맨드라인 클라이언트를 제공하는 OpenStack 프로젝트입니다. OpenStack 커맨드라인 클라이언트 섹션을 참고합니다.
REST 클라이언트
Mozilla와 Google 모두 REST를 위한 브라우저 기반의 그래픽 인터페이스를 제공합니다. Firefox는 RESTClient 를 살펴보세요. Chrome은 rest-client 을 살펴보세요.
OpenStack Python 소프트웨어 개발 키트 (SDK)
해당 SDK를 사용하여 OpenStack 클라우드 내 자원을 생성하고 관리하는 자동화 스크립트를 작성합니다. 이 SDK는 REST 요청을 직접 만드는 것보다 Python 객체에 대한 요청을 생성하여 Python 안에서 자동화 작업을 생성할 수 있도록 하는 OpenStack API에 대한 Python 바인딩을 구현합니다. 모든 OpenStack 명령줄 도구들은 Python SDK를 사용하여 구현됩니다. OpenStack 최종 사용자 가이드 내 OpenStack Python SDK 를 살펴보세요.