Skip to main content
Active IQ Unified Manager 9.14
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

使用ONTAP 閘道API疑難排解需求量

貢獻者
PDF

閘道API可做為閘道、以叫用ONTAP 功能完善的API來查詢ONTAP 有關您的物件的資訊、並採取補救措施來解決回報的問題。

此工作流程會處理樣本使用案例、ONTAP 當某個事件幾乎達到其容量時、就會激發該事件。此工作流程也示範如何透過結合Active IQ Unified Manager 使用各種版本的功能、來解決此問題。ONTAP

註

在執行工作流程步驟之前、請先確認下列事項：

  • 您知道閘道API及其使用方式。如需相關資訊，請參閱 "透過Proxy存取功能存取ONTAP 功能的部分API"。

  • 您知道ONTAP 使用的是靜止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. 記下事件中通知Volume容量使用率的Volume名稱。

  2. 使用Volume名稱做為名稱參數中的值、執行下列Unified Manager API來查詢Volume。

    類別 HTTP動詞 路徑

    資料中心

    取得

    /datacenter/storage/volumes

  3. 從輸出中擷取叢集UUID和Volume UUID。

  4. 在Unified Manager Web UI上、瀏覽至* General > Feature Settings*>* API Gateway*、確認是否已啟用API閘道功能。除非已啟用、否則閘道類別下的API將無法叫用。如果功能已停用、請啟用該功能。

  5. 使用叢集 UUID 透過 API 閘道執行 ONTAP API /storage/volumes/{uuid}。當以API參數傳遞Volume UUID時、查詢會傳回Volume詳細資料。

    若要ONTAP 透過API閘道執行REST API、Unified Manager認證會在內部傳遞以供驗證、您不需要為個別叢集存取執行額外的驗證步驟。

    類別 HTTP動詞 路徑

    Unified Manager：閘道

    儲存ONTAP

    取得

    閘道 API ： /gateways/{uuid}/{path}

    ONTAP API ： /storage/volumes/{uuid}
    註

    在/gatewes/\｛uuid｝/\｛path｝中、\｛uuid｝的值必須以要執行REST作業的叢集UUID取代。\｛path｝必須以ONTAP 靜止URL /store/voles/\｛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、ONTAP 並透過API閘道執行下列的RESIDIAPI、以調整磁碟區大小。如需閘道和ONTAP RESI饋API輸入參數的相關資訊、請參閱步驟5。

    類別 HTTP動詞 路徑

    Unified Manager：閘道

    儲存ONTAP

    修補程式

    閘道 API ： /gateways/{uuid}/{path}

    ONTAP API ： /storage/volumes/{uuid}
    註

    除了叢集UUID和Volume UUID、您還必須輸入大小參數值、才能調整磁碟區大小。請務必輸入值_in bytes_。例如，如果您要將磁碟區大小從 100 GB 增加到 120 GB ，請在查詢結束時輸入參數大小的值： -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 ONTAP 、透過API閘道執行下列的Fuse API。如需閘道和ONTAP RESI饋API輸入參數的相關資訊、請參閱步驟5。

    類別 HTTP動詞 路徑

    Unified Manager：閘道

    產品特色：叢集ONTAP

    取得

    閘道 API ： /gateways/{uuid}/{path}

    ONTAP API ： /cluster/jobs/{uuid}

    傳回的HTTP代碼與ONTAP 不一致的HTTP狀態代碼相同。

  9. 執行下列ONTAP 的流通API、查詢已調整大小的Volume詳細資料。如需閘道和ONTAP RESI饋API輸入參數的相關資訊、請參閱步驟5。

    類別 HTTP動詞 路徑

    Unified Manager：閘道

    儲存ONTAP

    取得

    閘道 API ： /gateways/{uuid}/{path}

    ONTAP API ： /storage/volumes/{uuid}

    輸出會顯示增加的Volume大小為120 GB。