Skip to main content
Active IQ Unified Manager
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

게이트웨이 API를 사용하여 ONTAP 볼륨 문제 해결

PDF

게이트웨이 API는 ONTAP API를 호출하여 ONTAP 스토리지 객체에 대한 정보를 쿼리하고 보고된 문제를 해결하기 위한 시정 조치를 취하는 게이트웨이 역할을 합니다.

이 워크플로는 ONTAP 볼륨이 용량에 거의 도달했을 때 이벤트가 발생하는 샘플 사용 사례를 다룹니다. 또한 이 워크플로는 Active IQ Unified Manager 와 ONTAP REST API를 결합하여 이 문제를 해결하는 방법을 보여줍니다.

참고

워크플로 단계를 실행하기 전에 다음 사항을 확인하세요.

  • 게이트웨이 API와 그 사용 방법을 알고 있습니다. 자세한 내용은 다음을 참조하세요."프록시 액세스를 통해 ONTAP API에 액세스" .

  • ONTAP REST API의 사용법을 알고 계십니다. ONTAP REST API 사용에 대한 정보는 다음을 참조하세요.https://docs.netapp.com/us-en/ontap-automation/index.html["ONTAP 자동화 문서"] .

  • 귀하는 애플리케이션 관리자입니다.

  • REST API 작업을 실행하려는 클러스터는 ONTAP 9.5 이상에서 지원되며, 해당 클러스터는 HTTPS를 통해 Unified Manager에 추가됩니다.

다음 다이어그램은 ONTAP 볼륨 용량 사용 문제를 해결하기 위한 워크플로의 각 단계를 보여줍니다.

API 게이트웨이 OnTap 워크플로

워크플로는 Unified Manager와 ONTAP REST API의 호출 지점을 모두 다룹니다.

  1. 볼륨 용량 사용률을 알리는 이벤트에서 볼륨 이름을 기록해 둡니다.

  2. 볼륨 이름을 이름 매개변수의 값으로 사용하여 다음 Unified Manager API를 실행하여 볼륨을 쿼리합니다.

    범주 HTTP 동사 길

    데이터센터

    얻다

    /datacenter/storage/volumes

  3. 출력에서 클러스터 UUID와 볼륨 UUID를 검색합니다.

  4. Unified Manager 웹 UI에서 일반 > 기능 설정 > *API Gateway*로 이동하여 API Gateway 기능이 활성화되어 있는지 확인합니다. 활성화하지 않으면 게이트웨이 카테고리의 API를 호출할 수 없습니다. 해당 기능이 비활성화되어 있으면 활성화하세요.

  5. 클러스터 UUID를 사용하여 ONTAP API를 실행합니다./storage/volumes/{uuid} API 게이트웨이를 통해. 볼륨 UUID가 API 매개변수로 전달되면 쿼리는 볼륨 세부 정보를 반환합니다.

    API 게이트웨이를 통해 ONTAP API를 실행하는 경우 Unified Manager 자격 증명이 인증을 위해 내부적으로 전달되므로 개별 클러스터 액세스에 대해 추가 인증 단계를 실행할 필요가 없습니다.

    범주 HTTP 동사 길

    통합 관리자: 게이트웨이

    ONTAP: 스토리지

    얻다

    게이트웨이 API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}
    참고

    /gateways/{uuid}/{path}에서 {uuid}의 값은 REST 작업이 수행될 클러스터 UUID로 대체되어야 합니다. {path}는 ONTAP REST URL /storage/volumes/{uuid}로 대체되어야 합니다.

    첨부된 URL은 다음과 같습니다. /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

    GET 작업을 실행하면 생성된 URL은 다음과 같습니다. GEThttps://<hostname\>/api/gateways/<cluster_UUID\>/storage/volumes/{volume_uuid}

    샘플 cURL 명령

    curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7"
-H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"

  6. 출력 결과를 바탕으로 크기, 사용법, 시정 조치를 결정합니다. 이 워크플로에서 취해지는 시정 조치는 볼륨 크기를 조정하는 것입니다.

  7. 클러스터 UUID를 사용하고 API 게이트웨이를 통해 다음 ONTAP API를 실행하여 볼륨 크기를 조정합니다. 게이트웨이 및 ONTAP API의 입력 매개변수에 대한 자세한 내용은 5단계를 참조하세요.

    범주 HTTP 동사 길

    통합 관리자: 게이트웨이

    ONTAP: 스토리지

    반점

    게이트웨이 API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}
    참고

    클러스터 UUID와 볼륨 UUID와 함께 볼륨 크기를 조정하기 위한 크기 매개변수 값을 입력해야 합니다. 값을 바이트 단위로 입력하세요. 예를 들어, 볼륨 크기를 100GB에서 120GB로 늘리려면 쿼리 끝에 매개변수 크기 값을 입력합니다. -d {\"size\": 128849018880}"

    샘플 cURL 명령

    curl -X PATCH "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
    "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>" -d
    {\"size\": 128849018880}"

    JSON 출력은 작업 UUID를 반환합니다.

  8. 작업 UUID를 사용하여 작업이 성공적으로 실행되었는지 확인합니다. 클러스터 UUID와 작업 UUID를 사용하여 API 게이트웨이를 통해 다음 ONTAP API를 실행합니다. 게이트웨이 및 ONTAP API의 입력 매개변수에 대한 자세한 내용은 5단계를 참조하세요.

    범주 HTTP 동사 길

    통합 관리자: 게이트웨이

    ONTAP: 클러스터

    얻다

    게이트웨이 API: /gateways/{uuid}/{path}

    ONTAP API: /cluster/jobs/{uuid}

    반환된 HTTP 코드는 ONTAP REST API HTTP 상태 코드와 동일합니다.

  9. 다음 ONTAP API를 실행하여 크기가 조정된 볼륨의 세부 정보를 쿼리합니다. 게이트웨이 및 ONTAP API의 입력 매개변수에 대한 자세한 내용은 5단계를 참조하세요.

    범주 HTTP 동사 길

    통합 관리자: 게이트웨이

    ONTAP: 스토리지

    얻다

    게이트웨이 API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}

    출력에서는 볼륨 크기가 120GB로 증가한 것으로 표시됩니다.