ONTAP REST API에 대한 마이그레이션 고려 사항
변경 제안
PDF
ONTAPI API(ZAPI)는 NetApp ONTAP 소프트웨어에 포함된 원래의 독점 호출 세트입니다. API는 네트워크 관리 SDK를 통해 제공되며 데이터 저장 관리 및 관리 작업의 자동화를 지원합니다. ONTAPI를 사용하는 경우 REST API에서 제공하는 확장된 ONTAP 기능 세트를 활용하려면 ONTAP REST API로의 마이그레이션을 계획해야 합니다.
일반적인 설계 차이점
ONTAP REST API 및 명령줄 인터페이스는 근본적으로 다른 디자인을 가지고 있습니다. CLI 명령 및 매개 변수는 REST API 호출에 직접 매핑되지 않습니다. 유사성이 있는 경우에도 입력 매개 변수의 세부 정보는 다를 수 있습니다. 예를 들어, 숫자 단위는 바이트로 지정하거나 접미사(예: KB)를 사용할 수 있습니다. 을 참조하십시오 "API 요청을 제어하는 입력 변수입니다" 및 "API 참조입니다" 를 참조하십시오.
REST API를 통해 표시되는 데이터 SVM
ONTAP은 다양한 유형의 SVM(스토리지 가상 머신)을 지원합니다. 하지만 ONTAP REST API를 통해 데이터 SVM만 직접 표시됩니다. REST API를 통해 클러스터와 노드를 설명하는 구성 정보를 사용할 수 있지만 클러스터와 노드는 별도의 SVM으로 취급되지 않습니다.
REST API를 통해 ONTAP CLI에 액세스합니다
ONTAP는 ONTAPI API 및 CLI 사용자가 ONTAP REST API로 전환할 때 ONTAP CLI에 액세스할 수 있는 REST 엔드포인트를 제공합니다. 이 통과 연결 기능을 사용하여 모든 CLI 명령을 실행할 수 있습니다. NetApp이 REST API의 격차를 파악하고 향후 ONTAP 릴리즈를 개선할 수 있도록 REST 엔드포인트의 사용이 AutoSupport 데이터로 반환됩니다.
CLI 명령을 실행하려면 다음과 같은 규칙에 따라 적절하게 구성된 REST API 호출을 해야 합니다.
-
리소스 경로
-
필드 이름
-
HTTP 메서드
CLI 액세스를 위한 기본 리소스 경로는 입니다 /private/cli. REST API를 통해 CLI에 액세스하는 방법에 대한 자세한 내용은 ONTAP API 온라인 설명서 페이지를 참조하십시오. 또한 NetApp는 코드 샘플 및 기타 유용한 정보가 들어 있는 GitHub 리포지토리를 유지 관리합니다. 을 참조하십시오 "ONTAP REST Python GitHub 리포지토리 - CLI passthrough 샘플" 를 참조하십시오.
ONTAPI에서 SnapDiff 가용성 변경
SnapDiff v1 및 v2는 ONTAPI(ZAPI) 관리 프레임워크를 기반으로 하며, 특정 버전의 ONTAP에서 사용 편의성 제한이 있습니다. SnapDiff v3 API는 ONTAPI를 사용하지 않으며 ONTAP 9.8 이상 버전에서 지원됩니다. SnapDiff ONTAP 릴리스별 API 사용 가능 여부는 다음과 같이 정의됩니다.
-
ONTAP 9.7 및 이전 릴리즈: v1 및 v2(ONTAPI만 해당)
-
ONTAP 9.8 이상 버전: v1, v2 및 v3. 일부 제한 사항이 적용됩니다. ONTAP 버전에 따른 SnapDiff 지원에 대한 자세한 내용은 "FAQ: SnapDiff ONTAP 지원"을 참조하십시오.
백업 애플리케이션이 SnapDiff를 지원하는지 확인하고, 사용 중인 ONTAP 버전에 따른 상호 운용성 제한 사항을 숙지해야 합니다. 자세한 내용은 "ONTAP 릴리즈 노트"을 참조하십시오.