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.vMAJOR.MINOR+json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예
Accept: application/vnd.ceph.api.v1.0+json
Accept: application/vnd.ceph.api.v1.0+json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 현재 Ceph API 서버가 해당 특정 버전을 처리할 수 없는 경우
415 - Unsupported Media Type
응답이 반환됩니다.
의미 체계 버전 관리 사용.
- 주요 변경 사항은 이전 버전과 호환되지 않습니다. 변경으로 인해 요청 및 특정 끝점의 응답 형식이 추가되지 않을 수 있습니다.
- 작은 변경 사항은 이전 버전과 호환됩니다. 변경 사항은 특정 끝점의 요청 또는 응답 형식에 대한 추가 변경 사항으로 구성됩니다.