ONTAP REST API 호출의 변경 사항
변경 제안
PDF
NetApp은 각 주요 제품 릴리스마다 ONTAP REST API를 지속적으로 개선하고 업데이트합니다. 이러한 업데이트에는 기존 API 호출이 변경되어 ONTAP 기능에 대한 액세스가 중단될 수 있습니다. 또한 API 사용 시 고려해야 할 추가 사항과 일부 문서 오류가 있습니다.
기존 ONTAP REST API 호출에 대한 변경 사항
기존 ONTAP REST API 호출(엔드포인트 및 매개변수 등)의 변경 사항은 해당 API를 사용하는 소프트웨어에 영향을 미칠 수 있습니다. 대부분의 경우, 환경에 따라 이러한 변경 사항은 _호환성을 깨뜨리는 변경 사항_으로 간주됩니다. 아래 표의 목록을 검토하여 자동화 환경에 영향이 있는지 확인하십시오. 각 항목에는 해당 API 엔드포인트 또는 영역, 변경 사항에 대한 설명, 그리고 변경 사항이 도입된 ONTAP 릴리스가 포함되어 있습니다.
| API 엔드포인트 또는 영역 | 동작 설명 | ONTAP 릴리즈 |
|---|---|---|
Azure 키 저장소 |
Azure Key Vault(AKV)를 활성화 및 비활성화하는 데 사용되는 REST API 엔드포인트가 이제 동기식 대신 비동기식으로 실행됩니다. 이는 AKV 활성화를 위한 POST 작업과 비활성화를 위한 DELETE 작업에 영향을 미칩니다. 이러한 API 호출을 사용하는 클라이언트는 HTTP 상태 코드만 확인하는 대신 작업 상태를 확인하는 방식으로 비동기 응답을 처리하도록 코드를 업데이트해야 합니다. 이 변경 사항은 주로 ONTAP REST API를 통해 Azure Key Vault 구성을 관리하는 Azure NetApp Files(ANF) 환경에 영향을 미칩니다. |
9.19.1 |
|
응답의 *_links * 필드가 이러한 끝점의 이중 그룹에서 제거되었습니다. 권장되는 고객 조치 또는 해결 방법이 없습니다. 이 필드는 향후 ONTAP 릴리즈에서 다시 추가될 예정입니다. |
9.15.1 |
추가 REST API 사용 고려 사항
ONTAP REST API를 사용할 때는 기존 기능을 저해하거나 호환성을 깨뜨리는 변경 사항 외에도 여러 가지 추가 고려 사항이 있습니다. 새로운 API 호출이나 대체 API 호출 도입, ONTAP 내부 처리 방식 변경 등 다양한 유형의 문제가 발생할 수 있습니다. 각 항목에는 해당 API 엔드포인트 또는 영역, 동작 설명, 그리고 해당 기능이 도입된 ONTAP 릴리스 버전이 포함되어 있습니다.
| API 엔드포인트 또는 영역 | 동작 설명 | ONTAP 릴리즈 |
|---|---|---|
|
컨테이너 생성에 사용되는 엔드포인트가 개선되어 이전에는 `/api/storage/volumes`를 통해서만 사용할 수 있었던 여러 볼륨 구성 매개변수를 지원합니다. 이를 통해 특히 Kubernetes 스토리지 오케스트레이션을 위해 NetApp Trident를 사용하는 고객은 영구 볼륨 프로비저닝 시 ONTAP의 균형 배치 기능을 활용할 수 있습니다. 볼륨은 최적의 성능과 용량 활용을 위해 클러스터 노드 전체에 자동으로 분산됩니다. 볼륨 배치, QoS 정책 또는 용량 관리에 대한 세밀한 제어가 필요한 컨테이너화된 애플리케이션을 배포할 때 업데이트된 엔드포인트를 사용해야 합니다. 이는 스토리지 리소스 전반에 걸친 자동 로드 밸런싱이 중요한 대규모 Kubernetes 환경에서 특히 유용합니다. |
9.19.1 |
|
대규모 ONTAP 클러스터(노드 32개 이상)에서 REST API를 통해 라이선스 정보를 조회할 때 응답 속도가 느려질 수 있습니다. 이 문제는 System Manager 라이선스 탭과 모든 라이선스를 동시에 조회하는 자동화된 워크플로에 영향을 미칩니다. 영향을 줄이려면 쿼리 매개변수를 사용하여 특정 기능에 대한 라이선스를 하나씩 가져오거나 CLI 명령 `system license show`을 사용하는 것이 좋습니다. 모든 라이선스를 단일 API 호출로 조회하는 대신 이 방법을 사용하십시오. |
9.19.1 |
ONTAP REST API 참조 문서 오류
NetApp이 ONTAP REST API를 개선하고 업데이트하는 과정에서 온라인 참조 문서에 오류가 발생할 수 있습니다. 이러한 오류는 API 사용 시 혼란을 야기할 수 있지만, 일반적으로 ONTAP 자동화 소프트웨어 또는 환경에 영향을 미치거나 중단시키지는 않습니다. 아래 표에 있는 오류 목록을 검토해 보시기 바랍니다. 이를 통해 ONTAP REST API 참조 문서를 더 잘 이해하고 활용할 수 있습니다. 각 항목에는 해당 API 엔드포인트 또는 영역, 오류 설명, 그리고 오류가 발생한 ONTAP 릴리스 버전이 포함되어 있습니다.
| API 엔드포인트 또는 영역 | 변경에 대한 설명 | ONTAP 릴리즈 |
|---|---|---|
|
끝점에 대한 REST API 문서는 * specifier * 가 유효한 필드임을 나타냅니다. 그러나 이 끝점에서는 할당량 지정자가 지원되지 않습니다. 권장되는 고객 조치 또는 해결 방법이 없습니다. 이 필드는 향후 ONTAP 릴리스의 API 설명서에서 제거될 예정입니다. |
9.6 |