1장. Ceph RESTful API
스토리지 관리자는 Red Hat Ceph Storage 대시보드에서 제공하는 Ceph RESTful API 또는 간단히 Ceph API를 사용하여 Red Hat Ceph Storage 클러스터와 상호 작용할 수 있습니다. 각 구성 옵션과 함께 Ceph 모니터 및 OSD에 대한 정보를 표시할 수 있습니다. Ceph 풀을 생성하거나 편집할 수도 있습니다.
Ceph API는 다음 표준을 사용합니다.
- HTTP 1.1
- JSON
- MIME 및 HTTP 콘텐츠 협상
- JWT
이러한 표준은 OpenAPI 3.0을 준수하여 API 구문, 의미 체계, 콘텐츠 인코딩, 버전 관리, 인증 및 권한 부여를 조정합니다.
사전 요구 사항
- 정상 실행 Red Hat Ceph Storage 클러스터.
- Ceph Manager를 실행하는 노드에 액세스합니다.
1.1. Ceph API의 버전 관리
Ceph RESTful API의 주요 목표는 안정적인 인터페이스를 제공하는 것입니다. 안정적인 인터페이스를 제공하기 위해 Ceph API는 다음과 같은 원칙에 따라 빌드됩니다.
- 암시적 기본값을 방지하려면 모든 끝점에 대한 필수 명시적 기본 버전입니다.
Fine-grain change control per-endpoint.
특정 끝점의 예상 버전은 HTTP 헤더에 설명되어 있습니다.
구문
Accept: application/vnd.ceph.api.vMAJOR.MINOR+json
예제
Accept: application/vnd.ceph.api.v1.0+json
현재 Ceph API 서버가 해당 특정 버전을 처리할 수 없는 경우
415 - Unsupported Media Type응답이 반환됩니다.
의미 체계 버전 관리 사용.
- 주요 변경 사항은 이전 버전과 호환되지 않습니다. 변경으로 인해 요청 및 특정 끝점의 응답 형식이 추가되지 않을 수 있습니다.
- 작은 변경 사항은 이전 버전과 호환됩니다. 변경 사항은 특정 끝점의 요청 또는 응답 형식에 대한 추가 변경 사항으로 구성됩니다.
