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

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

기여자

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

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

참고

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

  • 게이트웨이 API와 게이트웨이 API의 사용 방법을 알고 있습니다. 자세한 내용은 ""게이트웨이 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. name 매개 변수의 값으로 볼륨 이름을 사용하여 다음 Unified Manager API를 실행하여 볼륨을 쿼리합니다.

    범주 HTTP 동사 경로

    데이터 센터

    가져오기

    '/datacenter/storage/volumes'

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

  4. Unified Manager 웹 UI에서 * 일반 * > * 기능 설정 * > * API 게이트웨이 * 로 이동하여 API 게이트웨이 기능이 활성화되었는지 확인합니다. 사용하도록 설정되어 있지 않으면 게이트웨이 범주 아래의 API를 사용하여 를 호출할 수 없습니다. 기능이 비활성화된 경우 활성화합니다.

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

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

    범주 HTTP 동사 경로

    Unified Manager: 게이트웨이

    ONTAP: 스토리지

    가져오기

    게이트웨이 API: "/geways/{uuid}/{path}"

    ONTAP API: "/storage/volumes/{uuuid}"

    참고

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

    추가된 URL은 '/geways/{cluster_uuuid}/storage/volumes/{volume_uuuid}'입니다

    GET 작업을 실행할 때 생성된 URL은 'GETtps://<hostname\>/API/게이트웨이/<cluster_UUID\>/storage/volumes/{volume_uuuid}'입니다

    • 샘플 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 동사 경로

    Unified Manager: 게이트웨이

    ONTAP: 스토리지

    패치

    게이트웨이 API: "/geways/{uuid}/{path}"

    ONTAP API: "/storage/volumes/{uuuid}"

    참고

    클러스터 UUID 및 볼륨 UUID와 함께 볼륨 크기를 조정할 수 있는 크기 매개 변수의 값을 입력해야 합니다. bytes _ 의 값을 입력해야 합니다. 예를 들어, 볼륨 크기를 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 동사 경로

    Unified Manager: 게이트웨이

    ONTAP: 클러스터

    가져오기

    게이트웨이 API: "/geways/{uuid}/{path}"

    ONTAP API: "/cluster/jobs/{uuid}"

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

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

    범주 HTTP 동사 경로

    Unified Manager: 게이트웨이

    ONTAP: 스토리지

    가져오기

    게이트웨이 API: "/geways/{uuid}/{path}"

    ONTAP API: "/storage/volumes/{uuuid}"

    출력에는 120GB의 증가된 볼륨 크기가 표시됩니다.