서비스 버전

서비스에 액세스하기 위한 URI(Uniform Resource Identifier)의 일부분으로 버전 번호가 각 서비스에 포함됩니다. 버전에는 주 번호와 부 번호가 있습니다. 요청은 주 버전 번호를 제공해야 하지만, 부 버전 번호는 선택적이므로 제공하지 않을 경우 기본적으로 값 "0"으로 지정됩니다. 주 번호는 서비스의 주 번호와 일치해야 합니다. 부 번호는 서비스의 부 번호보다 작거나 같아야 합니다.

예: 클라이언트는 버전 번호 "2.1"을 실행 중인 서비스에 대한 일부 요청을 수행합니다.

다음 등록 정보 변경에 대해서는 서비스 API 버전 변경이 필요하지 않습니다. 어플라이언스 버전 번호 및 모델은 사용 가능한 등록 정보를 결정하는 데 사용되어야 합니다. 또한 이러한 등록 정보 변경 사항은 CLI 및 BUI에 반영되고 해당 어플라이언스 인스턴스의 기능을 표시합니다.  

• 이전 등록 정보를 제거하지 않는 새 출력 등록 정보입니다.

• 기존 명령에 추가된 새 입력 등록 정보로, 명령을 이전 버전에서처럼 작동하게 하는 기본값을 포함합니다.

이전 버전과 호환되는 명령의 최신 버전이 추가 등록 정보를 반환할 수 있으므로 클라이언트는 새 등록 정보를 무시하도록 코딩되어야 합니다. 부 번호는 서비스 API에 대한 이전 버전 호환 가능 변경에 대해 증분됩니다.

• 기존 서비스에 새 명령을 추가합니다.

• 서비스 명령에 새 질의 매개변수를 추가합니다.

주 번호는 서비스 API에 대한 호환 불가능한 변경에서 증분됩니다.

• 명령 질의 매개변수를 제거합니다.

• 기존 서비스에서 명령을 제거합니다.

어플라이언스 소프트웨어의 주요 릴리스에 호환되지 않는 버전 변경 사항이 포함될 수 있습니다. 주요 업데이트 동안 지정된 서비스의 이전 버전이 있거나 없을 수 있습니다. 각 명령 응답은 지정된 모듈에 대한 현재 버전의 어플라이언스 API와 함께 HTTP 헤더를 포함해야 합니다.

X-Zfssa-Nas-Api:  1.1