서비스에 액세스하기 위한 URI(Uniform Resource Identifier)의 일부분으로 버전 번호가 각 RESTful API 서비스에 포함됩니다. 버전에는 주 번호와 부 번호가 있습니다. 요청은 주 버전 번호를 제공해야 하지만, 부 버전 번호는 선택사항이므로 제공하지 않을 경우 기본적으로 값 0으로 지정됩니다. 주 번호는 서비스의 주 번호와 일치해야 합니다. 부 번호는 서비스의 부 번호보다 작거나 같아야 합니다.
예를 들어, 다음 표에서는 클라이언트에서 버전 2.1이 실행되고 있는 서비스를 요청하는 경우 지정된 버전을 클라이언트 요청에서 사용할 수 있는지 여부를 보여줍니다.
|
다음 등록 정보 변경에 대해서는 서비스 API 버전 변경이 필요하지 않습니다. 어플라이언스 버전 번호 및 모델은 사용 가능한 등록 정보를 결정하는 데 사용되어야 합니다. 또한 이러한 등록 정보 변경사항은 CLI 및 BUI에 반영되고 해당 어플라이언스 인스턴스의 기능을 표시합니다.
이전 등록 정보를 제거하지 않는 새 출력 등록 정보입니다.
기존 명령에 추가된 새 입력 등록 정보로, 명령을 이전 버전에서처럼 작동하게 하는 기본값을 포함합니다.
이전 버전과 호환되는 명령의 최신 버전이 추가 등록 정보를 반환할 수 있으므로 클라이언트는 새 등록 정보를 무시하도록 코딩되어야 합니다. 부 번호는 서비스 API에 이전 버전과 호환되는 변경사항이 있을 때 증가합니다.
기존 서비스에 새 명령을 추가합니다.
서비스 명령에 새 질의 매개변수를 추가합니다.
주 번호는 서비스 API에 호환되지 않는 변경사항이 있을 때 증가합니다.
명령 질의 매개변수를 제거합니다.
기존 서비스에서 명령을 제거합니다.
어플라이언스 소프트웨어의 주요 릴리스에 호환되지 않는 버전 변경사항이 포함될 수 있습니다. 주요 업데이트 동안 지정된 서비스의 이전 버전이 있거나 없을 수 있습니다. 각 명령 응답은 지정된 모듈에 대한 현재 버전의 어플라이언스 API와 함께 HTTP 헤더를 포함해야 합니다.
X-Zfssa-Nas-Api: 1.1