Active IQ Unified Manager에서 API를 사용하여 데이터 센터의 스토리지 오브젝트 관리
변경 제안
PDF
`datacenter` 범주에 속하는 REST API를 사용하면 클러스터, 노드, 애그리게이트, 스토리지 VM, 볼륨, LUN, 파일 공유, 네임스페이스 등 데이터 센터의 스토리지 오브젝트를 관리할 수 있습니다. 이러한 API는 오브젝트의 구성을 조회하는 데 사용할 수 있으며, 일부 API를 통해 이러한 오브젝트를 추가, 삭제 또는 수정하는 작업을 수행할 수 있습니다.
이러한 API 대부분은 필터링, 정렬 및 페이지네이션을 지원하는 클러스터 간 집계를 제공하는 GET 호출입니다. 이러한 API를 실행하면 데이터베이스에서 데이터를 반환합니다. 따라서 새로 생성된 오브젝트는 응답에 나타나도록 다음 수집 주기에서 검색되어야 합니다.
특정 오브젝트의 세부 정보를 쿼리하려면 해당 오브젝트의 고유 ID를 입력하여 세부 정보를 확인해야 합니다. 예를 들어, 스토리지 오브젝트의 메트릭 및 분석 정보는 "성능 지표 보기"를 참조하십시오.
curl -X GET "https://<hostname>/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
|
API에 대한 CURL 명령어, 예제, 요청 및 응답은 Swagger API 인터페이스에서 확인할 수 있습니다. Swagger에 표시된 대로 특정 매개변수를 기준으로 결과를 필터링하고 정렬할 수 있습니다. 이러한 API를 사용하면 클러스터, 볼륨 또는 스토리지 VM 등 특정 스토리지 오브젝트에 대한 결과를 필터링할 수 있습니다. |
데이터 센터의 스토리지 오브젝트용 API
| HTTP 동사 | 경로 | 설명 |
|---|---|---|
|
|
이 방법을 사용하면 데이터 센터 전체의 ONTAP 클러스터에 대한 세부 정보를 볼 수 있습니다. API는 클러스터의 IPv4 또는 IPv6 주소, 노드 상태, 성능 용량, 고가용성(HA) 쌍 등 노드에 대한 정보, 그리고 클러스터가 All SAN 어레이인지 여부 등의 정보를 반환합니다. |
|
|
데이터 센터의 클러스터에 설치된 라이선스의 세부 정보를 반환합니다. 필요한 기준에 따라 결과를 필터링할 수 있습니다. 라이센스 키, 클러스터 키, 만료일, 라이선스 범위 등의 정보가 반환됩니다. 라이센스 키를 입력하여 특정 라이선스의 세부 정보를 검색할 수 있습니다. |
|
|
이 방법을 사용하면 데이터 센터의 노드에 대한 세부 정보를 볼 수 있습니다. 클러스터 정보, 노드 상태, 성능 용량 및 노드의 고가용성(HA) 쌍에 대한 정보를 확인할 수 있습니다. |
|
|
이 메서드를 사용하면 데이터 센터의 CIFS 공유에 대한 세부 정보를 볼 수 있습니다. 클러스터, SVM 및 볼륨 세부 정보 외에도 액세스 제어 목록(ACL)에 대한 정보도 반환됩니다. |
|
|
이 방법을 사용하면 지원되는 NFS 서비스에 대한 내보내기 정책의 세부 정보를 볼 수 있습니다. 클러스터 또는 스토리지 VM에 대한 내보내기 정책을 조회하고 내보내기 정책 키를 재사용하여 NFS 파일 공유를 프로비저닝할 수 있습니다. 워크로드에 내보내기 정책을 할당하고 재사용하는 방법에 대한 자세한 내용은 "`CIFS 및 NFS 파일 공유 프로비저닝`"을 참조하십시오. |
|
|
이 메서드를 사용하여 데이터 센터의 애그리게이트 모음 또는 특정 애그리게이트를 보고 워크로드를 프로비저닝하거나 모니터링할 수 있습니다. 클러스터 및 노드 세부 정보, 사용된 성능 용량, 사용 가능한 공간 및 사용된 공간, 스토리지 효율성 등의 정보가 반환됩니다. |
|
|
이 방법을 사용하면 데이터 센터 전체의 LUN 모음을 볼 수 있습니다. 클러스터 및 SVM 세부 정보, QoS 정책, igroup 등 LUN에 대한 정보를 확인할 수 있습니다. |
|
|
이 메서드를 사용하면 데이터 센터의 스토리지 오브젝트에 적용되는 모든 QoS 정책의 세부 정보를 볼 수 있습니다. 클러스터 및 SVM 세부 정보, 고정 또는 적응형 정책 세부 정보, 해당 정책에 적용되는 오브젝트 수 등의 정보가 반환됩니다. |
|
|
이 메서드를 사용하면 데이터 센터 전체의 모든 FlexVol 볼륨 또는 FlexGroup 볼륨에 대한 qtree 세부 정보를 볼 수 있습니다. 클러스터 및 SVM 세부 정보, FlexVol 볼륨, 내보내기 정책 등의 정보가 반환됩니다. |
|
|
이 메서드를 사용하여 데이터 센터의 볼륨 모음을 볼 수 있습니다. SVM 및 클러스터 세부 정보, QoS 및 내보내기 정책, 볼륨이 읽기-쓰기, 데이터 보호 또는 로드 공유 유형인지 여부 등 볼륨에 대한 정보가 반환됩니다. FlexVol 및 FlexClone 볼륨의 경우 해당 애그리게이트에 대한 정보를 볼 수 있습니다. FlexGroup 볼륨의 경우 쿼리는 구성 애그리게이트 목록을 반환합니다. |
|
|
특정 LUN 대상에 액세스할 수 있는 권한을 가진 이니시에이터 그룹(igroup)을 할당할 수 있습니다. 기존 igroup이 있는 경우 이를 할당할 수 있습니다. 또한 igroup을 생성하여 LUN에 할당할 수도 있습니다. 이러한 메서드를 사용하여 igroup을 각각 조회, 생성, 삭제 및 수정할 수 있습니다. 유의사항:
|
|
|
이러한 방법을 사용하여 스토리지 가상 머신(스토리지 VM)을 보고, 생성하고, 삭제하고, 수정할 수 있습니다.
|
|
|
유의사항: |
환경에서 SLO 기반 워크로드 프로비저닝을 활성화한 경우, 스토리지 VM을 생성할 때 CIFS 또는 SMB, NFS, FCP, iSCSI 등 LUN 및 파일 공유 프로비저닝에 필요한 모든 프로토콜을 지원하는지 확인하십시오. 스토리지 VM이 필수 서비스를 지원하지 않으면 프로비저닝 워크플로가 실패할 수 있습니다. 각 워크로드 유형에 대한 서비스도 스토리지 VM에서 활성화하는 것이 좋습니다.
환경에서 SLO 기반 워크로드 프로비저닝을 활성화한 경우, 스토리지 워크로드가 프로비저닝된 스토리지 VM은 삭제할 수 없습니다. CIFS 또는 SMB 서버가 구성된 스토리지 VM을 삭제하면 이 API는 로컬 Active Directory 구성과 함께 CIFS 또는 SMB 서버도 삭제합니다. 하지만 CIFS 또는 SMB 서버 이름은 Active Directory 구성에 계속 남아 있으므로 Active Directory 서버에서 수동으로 삭제해야 합니다.
데이터 센터의 네트워크 요소에 대한 API
데이터센터 범주에 속하는 다음 API는 환경의 포트 및 네트워크 인터페이스, 특히 FC 포트, FC 인터페이스, 이더넷 포트 및 IP 인터페이스에 대한 정보를 검색합니다.
| HTTP 동사 | 경로 | 설명 |
|---|---|---|
|
|
데이터 센터 환경의 모든 이더넷 포트에 대한 정보를 검색합니다. 포트 키를 입력 매개변수로 사용하면 특정 포트에 대한 정보를 볼 수 있습니다. 클러스터 세부 정보, 브로드캐스트 도메인, 상태, 속도, 유형 등 포트 세부 정보, 포트 활성화 여부 등의 정보가 검색됩니다. |
|
|
이 메서드를 사용하여 데이터 센터 환경의 FC 인터페이스 세부 정보를 볼 수 있습니다. 인터페이스 키를 입력 매개변수로 사용하면 해당 특정 인터페이스에 대한 정보를 확인할 수 있습니다. 클러스터 세부 정보, 홈 노드 세부 정보, 홈 포트 세부 정보 등의 정보가 검색됩니다. |
|
|
데이터 센터 환경의 노드에서 사용되는 모든 FC 포트에 대한 정보를 검색합니다. 포트 키를 입력 매개변수로 사용하면 특정 포트에 대한 정보를 볼 수 있습니다. 클러스터 세부 정보, 포트 설명, 지원되는 프로토콜 및 포트 상태 등 정보가 검색됩니다. |
|
|
이 방법을 사용하면 데이터 센터 환경의 IP 인터페이스 세부 정보를 볼 수 있습니다. 인터페이스 키를 입력 매개변수로 사용하면 해당 특정 인터페이스의 정보를 확인할 수 있습니다. 클러스터 세부 정보, IPspace 세부 정보, 홈 노드 세부 정보, 페일오버 활성화 여부 등의 정보가 검색됩니다. |