1.2. Ceph API의 버전 관리
Ceph RESTful API의 주요 목표는 안정적인 인터페이스를 제공하는 것입니다. 안정적인 인터페이스를 달성하기 위해 Ceph API는 다음 원칙에 따라 빌드됩니다.
- 암시적 기본값을 피하기 위해 모든 엔드 포인트에 대한 필수 명시적인 기본 버전입니다.
엔드 포인트당 세부 제어 변경.
특정 끝점에서 예상되는 버전은 HTTP 헤더에 설명되어 있습니다.
구문
Accept: application/vnd.ceph.api.vMAJOR.MINOR+json
예제
Accept: application/vnd.ceph.api.v1.0+json
현재 Ceph API 서버가 특정 버전을 처리할 수 없는 경우
415 - 지원되지 않는 미디어 유형
응답이 반환됩니다.
의미 체계 버전 관리 사용.
- 주요 변경 사항은 이전 버전과 호환되지 않습니다. 변경으로 인해 요청에 대한 비추가적인 변경 사항 및 특정 끝점의 응답 형식이 변경될 수 있습니다.
- 일부 변경 사항은 이전 버전과 호환되며 변경될 수 있습니다. 변경 사항은 특정 엔드포인트에 대한 요청 또는 응답 형식에 대한 추가 변경 사항으로 구성됩니다.