Element API를 사용하여 스토리지를 관리하는 방법에 대해 알아보세요.
변경 제안
PDF
Element API는 HTTPS를 통한 JSON-RPC 프로토콜을 기반으로 합니다. JSON-RPC는 가벼운 JSON 데이터 교환 형식을 기반으로 한 간단한 텍스트 기반 RPC 프로토콜입니다. 모든 주요 프로그래밍 언어에 대한 클라이언트 라이브러리를 사용할 수 있습니다.
HTTPS POST 요청을 통해 API 엔드포인트에 API 요청을 할 수 있습니다. POST 요청의 본문은 JSON-RPC 요청 객체입니다. API는 현재 일괄 요청(단일 POST에 여러 요청 객체 포함)을 지원하지 않습니다. API 요청을 제출할 때 요청의 콘텐츠 유형으로 "application/json-rpc"를 사용해야 하며 본문이 폼 인코딩되지 않았는지 확인해야 합니다.
|
Element 웹 UI는 이 문서에 설명된 API 메서드를 활용합니다. API 로그를 활성화하면 UI에서 API 작업을 모니터링할 수 있습니다. 이를 통해 시스템에 발행된 메서드를 볼 수 있습니다. 요청과 응답을 모두 활성화하면 발행된 메서드에 시스템이 어떻게 응답하는지 확인할 수 있습니다. |
달리 명시되지 않는 한, API 응답의 모든 날짜 문자열은 UTC+0 형식입니다.
|
|
스토리지 클러스터에 과부하가 걸리거나 지연 없이 연속으로 많은 API 요청을 제출하는 경우 메서드가 실패하고 "xDBVersionMismatch" 오류가 반환될 수 있습니다. 이런 일이 발생하면 메서드 호출을 다시 시도하세요. |
일반적인 물건
Element 소프트웨어 API는 JSON 객체를 사용하여 체계화된 데이터 개념을 표현합니다. 이러한 API 메서드 중 다수는 데이터 입력 및 출력을 위해 이러한 객체를 활용합니다. 이 섹션에서는 일반적으로 사용되는 객체를 설명합니다. 단일 메서드 내에서만 사용되는 객체는 이 섹션 대신 해당 메서드와 함께 설명됩니다.
일반적인 방법
일반적인 메서드는 스토리지 클러스터, API 자체 또는 진행 중인 API 작업에 대한 정보를 검색하는 데 사용되는 메서드입니다.
계정 API 메서드
계정 방법을 사용하면 계정 및 보안 정보를 추가, 제거, 보기, 수정할 수 있습니다.
관리자 API 메서드
관리자 API 메서드를 사용하여 스토리지 클러스터 관리자를 생성, 수정, 보고 제거하고 스토리지 클러스터에 액세스할 수 있는 사용자에게 액세스 수준과 권한을 할당할 수 있습니다.
클러스터 API 메서드
Element 소프트웨어 클러스터 API 메서드를 사용하면 스토리지 클러스터와 스토리지 클러스터에 속하는 노드의 구성 및 토폴로지를 관리할 수 있습니다.
일부 클러스터 API 메서드는 클러스터의 일부인 노드에서 작동하거나 클러스터에 가입하도록 구성된 노드에서 작동합니다. 새 클러스터나 기존 클러스터에 노드를 추가할 수 있습니다. 클러스터에 추가할 준비가 된 노드는 "보류" 상태입니다. 즉, 구성은 되었지만 아직 클러스터에 추가되지 않은 것입니다.
클러스터 생성 API 메서드
이러한 API 메서드를 사용하여 스토리지 클러스터를 만들 수 있습니다. 이러한 모든 방법은 단일 노드의 API 엔드포인트에 대해 사용되어야 합니다.
드라이브 API 메서드
드라이브 API 메서드를 사용하면 스토리지 클러스터에서 사용할 수 있는 드라이브를 추가하고 관리할 수 있습니다. 스토리지 클러스터에 스토리지 노드를 추가하거나 기존 스토리지 노드에 새 드라이브를 설치하면 드라이브를 스토리지 클러스터에 추가할 수 있습니다.
파이버 채널 API 메서드
Fibre Channel API 메서드를 사용하여 스토리지 클러스터의 Fibre Channel 노드 멤버를 추가, 수정 또는 제거할 수 있습니다.
개시자 API 메서드
초기자 방법을 사용하면 스토리지 시스템과 외부 스토리지 클라이언트 간의 통신을 처리하는 iSCSI 초기자 개체를 추가, 제거, 보기 및 수정할 수 있습니다.
LDAP API 메서드
LDAP(Lightweight Directory Access Protocol)를 사용하여 Element 저장소에 대한 액세스를 인증할 수 있습니다. 이 섹션에서 설명하는 LDAP API 메서드를 사용하면 스토리지 클러스터에 대한 LDAP 액세스를 구성할 수 있습니다.
다중 인증 API 방법
보안 어설션 마크업 언어(SAML)를 통해 타사 ID 공급자(IdP)를 사용하여 사용자 세션을 관리하기 위해 다중 요소 인증(MFA)을 사용할 수 있습니다.
세션 인증 API 메서드
세션 기반 인증을 사용하여 사용자 세션을 관리할 수 있습니다.
노드 API 메서드
노드 API 메서드를 사용하여 개별 노드를 구성할 수 있습니다. 이러한 방법은 구성이 필요한 단일 노드, 구성되었지만 아직 클러스터에 참여하지 않은 노드 또는 클러스터에 적극적으로 참여하고 있는 노드에서 작동합니다. 노드 API 메서드를 사용하면 개별 노드와 노드와 통신하는 데 사용되는 클러스터 네트워크에 대한 설정을 보고 수정할 수 있습니다. 이러한 메서드는 개별 노드에 대해 실행해야 하며, 클러스터 주소에 대해 노드별 API 메서드를 실행할 수 없습니다.
복제 API 메서드
복제 API 방법을 사용하면 두 개의 클러스터를 연결하여 지속적인 데이터 보호(CDP)를 구현할 수 있습니다. 두 개의 클러스터를 연결하면 클러스터 내의 활성 볼륨을 두 번째 클러스터로 지속적으로 복제하여 데이터를 복구할 수 있습니다. 복제를 위해 볼륨을 페어링하면 데이터에 액세스할 수 없게 만드는 이벤트로부터 데이터를 보호할 수 있습니다.
보안 API 메서드
Element 소프트웨어를 외부 키 관리 서버와 같은 외부 보안 관련 서비스와 통합할 수 있습니다. 이러한 보안 관련 방법을 사용하면 휴면 암호화를 위한 외부 키 관리와 같은 Element 보안 기능을 구성할 수 있습니다.
SnapMirror API 메서드
SnapMirror API 메서드는 Element 웹 UI에서 원격 ONTAP 시스템에 미러링된 스냅샷을 관리하는 데 사용됩니다. 이러한 방법은 Element 웹 UI에서만 사용하도록 되어 있습니다. SnapMirror 기능에 API 액세스가 필요한 경우 ONTAP API를 사용하세요. SnapMirror API 메서드에 대한 요청 및 반환 예는 제공되지 않습니다.
시스템 구성 API 메서드
시스템 구성 API 메서드를 사용하면 클러스터의 모든 노드에 적용되는 구성 값을 얻고 설정할 수 있습니다.
멀티테넌트 네트워킹 API 메서드
Element 스토리지 클러스터의 멀티테넌트 네트워킹을 사용하면 별도의 논리적 네트워크에 있는 여러 클라이언트 간의 트래픽을 3계층 라우팅 없이 하나의 Element 스토리지 클러스터에 연결할 수 있습니다.
스토리지 클러스터에 대한 연결은 VLAN 태그를 사용하여 네트워킹 스택에서 분리됩니다.
멀티테넌트 가상 네트워크 설정을 위한 전제 조건
-
스토리지 노드의 가상 네트워크에 할당할 클라이언트 네트워크 IP 주소 블록을 식별해야 합니다.
-
모든 스토리지 트래픽의 엔드포인트로 사용할 클라이언트 스토리지 네트워크 IP(SVIP) 주소를 식별해야 합니다.
가상 네트워킹 작업 순서
-
AddVirtualNetwork 메서드를 사용하여 입력한 IP 주소를 대량으로 프로비저닝합니다.
가상 네트워크를 추가하면 클러스터가 자동으로 다음 단계를 수행합니다.
-
각 스토리지 노드는 가상 네트워크 인터페이스를 생성합니다.
-
각 스토리지 노드에는 가상 SVIP를 사용하여 라우팅할 수 있는 VLAN 주소가 할당됩니다.
-
노드 재부팅 시에도 각 노드에 VLAN IP 주소가 유지됩니다.
-
-
가상 네트워크 인터페이스와 VLAN 주소가 할당되면 클라이언트 네트워크 트래픽을 가상 SVIP에 할당할 수 있습니다.
볼륨 API 메서드
Element 소프트웨어 볼륨 API 메서드를 사용하면 스토리지 노드에 있는 볼륨을 관리할 수 있습니다. 이러한 방법을 사용하여 볼륨을 생성, 수정, 복제 및 삭제할 수 있습니다. 볼륨 API 메서드를 사용하여 볼륨에 대한 데이터 측정값을 수집하고 표시할 수도 있습니다.
볼륨 액세스 그룹 API 메서드
볼륨 액세스 그룹 방법을 사용하면 볼륨 액세스 그룹을 추가, 제거, 보기 및 수정할 수 있습니다. 볼륨 액세스 그룹이란 사용자가 iSCSI 또는 파이버 채널 이니시에이터를 사용하여 액세스할 수 있는 볼륨의 모음입니다.
볼륨 스냅샷 API 메서드
Element 소프트웨어 볼륨 스냅샷 API 메서드를 사용하면 볼륨 스냅샷을 관리할 수 있습니다. 볼륨 스냅샷 API 메서드를 사용하여 볼륨 스냅샷을 생성, 수정, 복제 및 삭제할 수 있습니다.
가상 볼륨 API 메서드
Element 소프트웨어 가상 볼륨 API 메서드를 사용하면 가상 볼륨(VVol)을 관리할 수 있습니다. 이러한 API 메서드를 사용하면 기존 VVol을 볼 수 있을 뿐만 아니라 가상 볼륨 스토리지 컨테이너를 생성, 수정, 삭제할 수도 있습니다. 이러한 메서드를 사용하여 일반 볼륨을 조작할 수는 없지만 일반 볼륨 API 메서드를 사용하여 VVol에 대한 정보를 나열할 수 있습니다.