ONTAP REST API에 FSx를 사용하려면 어떻게 해야 하나요?

3분 분량

NetApp ONTAP REST API를 사용하여 Amazon FSx for NetApp ONTAP 리소스를 관리하고 싶습니다. 어떻게 해야 하나요?

해결 방법

사전 요구 사항

API 요청자는 ONTAP 파일 시스템용 FSx 및 스토리지 가상 머신(SVM) 엔드포인트에 HTTPS 연결을 만들 수 있어야 합니다. 자세한 내용은 NetApp ONTAP REST API 사용을 참조하세요.

curl을 사용하여 ONTAP 파일 시스템용 Fsx에서 Hello World를 실행

ONTAP 파일 시스템용 FSx를 실행하는 Amazon Virtual Private Cloud(VPC)에 있는 Linux 인스턴스의 명령줄 인터페이스에서 다음을 수행하세요.

1. fsxadmin 암호와 엔드포인트 DNS 이름을 입력합니다. 다음 예시 명령에서 암호 및 fs-XXXXXXXX.fsx.region.amazonaws.com을 사용 사례에 맞는 값으로 바꾸세요.

$ CRED=fsxadmin:Password
$ ONTAP=management.fs-XXXXXXXX.fsx.region.amazonaws.com

2. 다음 명령을 실행하여 ONTAP 소프트웨어 버전을 검색합니다.

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/cluster?fields=version"
{
  "version": {
    "full": "NetApp Release 9.10.1RC1P1: Sat Nov 27 18:08:32 UTC 2021",
    "generation": 9,
    "major": 10,
    "minor": 1
  },
  "_links": {
    "self": {
      "href": "/api/cluster"
    }
  }
}

예시 REST API: 볼륨 가져오기

다음은 볼륨을 검색하는 데 사용되는 GET 명령의 예시입니다.

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/storage/volumes"
{
  "records": [
    {
      "uuid": "504c8162-a435-11ec-bb13-130f21c56a08",
      "name": "svm1_root",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/504c8162-a435-11ec-bb13-130f21c56a08"
        }
      }
    },
    {
      "uuid": "956f5ce9-a435-11ec-bb13-130f21c56a08",
      "name": "vol1",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/956f5ce9-a435-11ec-bb13-130f21c56a08"
        }
      }
    }
  ],
  "num_records": 2,
  "_links": {
    "self": {
      "href": "/api/storage/volumes"
    }
  }
}

참고: 일부 API는 ONTAP용 FSx에서 실행되지 않습니다.

NetApp BlueXP API Swagger 인터페이스 사용

BlueXP 또는 Connector Swagger 인터페이스를 사용하여 일부 NetApp ONTAP API에 액세스할 수 있습니다. 자세한 내용은 BlueXP에 대해 자세히 알아보기와 NetApp 웹사이트에서 BlueXP(이전 Cloud Manager) API Swagger 인터페이스에 로그인하는 방법을 참조하세요.

다음 단계는 BlueXP를 사용하여 Swagger 인터페이스에 액세스하고 보안 인증을 게시하는 예시입니다.

1. BlueXP 커넥터에서 물음표로 표시된 도움말(Help) 메뉴를 선택한 다음 API를 선택합니다.

또는 Swagger 인터페이스로 직접 이동하세요(예시 URL: http://connectorip/occm/api-doc/).

2. 사용자 관리 작업(User Management Operations)을 선택합니다.

3. 인증: 인증 작업(auth: Authentication operations)을 선택합니다.

4. POST /auth/login을 선택하고 작업을 확장(Expand Operations)하세요.

5. 모델 스키마(Model Schema)를 선택합니다.

6. 다음을 표시하는 모델 스키마에서 클릭하여 매개변수 값으로 설정하기(Click to set as parameter value)를 선택합니다.

{
"email": "string",
"password": "string"
}

7. 모델 스키마가 채워지는 값(Value) 필드에서 문자열을 편집하여 올바른 이메일과 암호를 입력합니다.

{
"email": "user@example.com",
"password": "xxxxxxxxxx"
}

참고: 이메일 ID는fsxadmin이 아닙니다. 이메일은 BlueXP 커넥터에 로그인하는 데 사용되는 Cloud Central Auth0 email id입니다. 암호는 일반 텍스트로 설정됩니다.

8. 사용해 보기!(Try it out!) 선택

9. 응답 코드(Response Code)에서 로그인이 성공했는지 확인합니다.

예: BlueXP Swagger 인터페이스를 사용하여 볼륨 API 가져오기

1. Swagger 인터페이스에서 FSx (데이터 ONTAP 클러스터) 작업 환경 작업(FSx (Data ONTAP cluster) working environment operations)을 선택합니다.

2. fsx/volumes을 선택합니다.

3. GET /fsx/volumes을 선택하고 작업을 확장(Expand Operations)하세요.

4. 값(Value) 필드에 볼륨 목록을 검색하려는 파일 시스템 ID를 입력합니다.

5. 사용해 보기!(Try it out!) 선택

6. 응답 코드(Response Code)와 응답 본문(Response Body)에서 로그인이 성공했는지 확인합니다.