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는 다음과 같은 원칙을 기반으로 구축됩니다.
- 암시적 기본값을 방지하기 위해 모든 끝점에 대한 필수 명시적 기본 버전입니다.
엔드 포인트별 변경 제어 기능 개선
특정 끝점의 예상 버전이 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 - 지원되지 않는 미디어 유형
응답이 반환됩니다.
의미 체계 버전 관리 사용.
- 주요 변경 사항은 이전 버전과 호환되지 않습니다. 변경으로 인해 요청에 추가되지 않고 특정 끝점에 대한 응답 형식이 변경될 수 있습니다.
- 작은 변경 사항은 이전 버전과 호환됩니다. 변경 사항은 특정 끝점에 대한 요청 또는 응답 형식에 대한 추가 변경 사항으로 구성됩니다.