ゲートウェイ API を使用した ONTAP ボリュームのトラブルシューティング

ゲートウェイ API はゲートウェイとして機能し、 ONTAP API を呼び出して ONTAP ストレージオブジェクトに関する情報を照会し、報告された問題に対処するための修復方法を実行します。

このワークフローでは、 ONTAP ボリュームの容量がほぼフルに達したときにイベントが生成されるユースケースの例を示します。また、 Active IQ Unified Manager と ONTAP REST API の組み合わせを呼び出して、この問題に対処する方法も示します。

注: ワークフローの手順を実行する前に、次の点を確認してください。

次の図は、 ONTAP ボリュームの容量に関する問題のトラブルシューティングワークフローの各手順を示しています。



このワークフローで Unified Manager は、 Unified Manager と ONTAP REST API の呼び出しポイントを取り上げます。

  1. ボリュームの容量利用率を通知するイベントからボリューム名をメモします。
  2. name パラメータ Unified Manager の値にボリューム名を使用して、次の Unified Manager API を実行してボリュームを照会します。
    カテゴリ HTTP動詞 パス
    datacenter GET

    /datacenter/storage/volumes

  3. 出力からクラスタ UUID とボリューム UUID を取得します。
  4. Unified Manager Web UI で 、一般 > > な機能設定 API ゲートウェイに移動して、 API ゲートウェイ機能が有効になっているかどうかを確認します。有効 gateway になっていないかぎり、カテゴリの API を呼び出すことはできません。機能が無効になっている場合は、有効にします。
  5. /storage/volumes/{uuid} クラスタ UUID を使用して、 API ゲートウェイ経由で ONTAP API を実行します。API パラメータとしてボリューム UUID を指定した場合、クエリはボリュームの詳細を返します。

    ONTAP API を API ゲートウェイ経由 Unified Manager で実行する場合、 Unified Manager のクレデンシャルは認証のために内部で渡されます。このため、個々のクラスタアクセスに対して追加の認証手順を実行する必要はありません。

    カテゴリ HTTP動詞 パス

    Unified Managerゲートウェイ

    ONTAP :ストレージ

    GET

    ゲートウェイ 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 は次のとおりです。 GET https://<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" 承認 : 基本 <Base64EncodedCredentials>"
  6. 出力から、取得するサイズ、使用状況、および修復方法を確認します。このワークフローで実施する修復方法は、ボリュームのサイズを変更することです。
  7. ボリュームのサイズを変更するには、クラスタ UUID を使用し、 API ゲートウェイから次の ONTAP API を実行してください。ゲートウェイと ONTAP API の入力パラメータについては、ステップ 5 を参照してください。
    カテゴリ HTTP動詞 パス

    Unified Managerゲートウェイ

    ONTAP :ストレージ

    PATCH

    ゲートウェイ API : /gateways/{uuid}/{path}

    ONTAP API : /storage/volumes/{uuid}

    注: クラスタ UUID とボリューム UUID に加え size 、ボリュームのサイズ変更用のパラメータの値を入力する必要があります。バイト単位で値を入力してください。たとえば、ボリュームのサイズを 100GB から 120GB に拡張する場合は、 size クエリの最後にパラメータの値を入力します。 -d {\"size\": 128849018880}"
    cURL コマンドの例
    curl -X パッチ " https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
        "accept: application/hal+json "-H" 承認 : 基本 <Base64EncodedCredentials>" -d
        { \" サイズ \" : 128849018880 } "

    JSON 出力でジョブ UUID が返されます。

  8. ジョブ UUID を使用して、ジョブが正常に実行されたかどうかを確認します。クラスタ UUID とジョブ UUID を使用して、 API ゲートウェイ経由で次の ONTAP API を実行します。ゲートウェイと ONTAP API の入力パラメータについては、ステップ 5 を参照してください。
    カテゴリ HTTP動詞 パス

    Unified Managerゲートウェイ

    ONTAP :クラスタ

    GET

    ゲートウェイ API : /gateways/{uuid}/{path}

    ONTAP API : /cluster/jobs/{uuid}

    返される HTTP コードは、 ONTAP REST API の HTTP ステータスコードと同じです。

  9. 次の ONTAP API を実行して、サイズ変更されたボリュームの詳細を照会します。ゲートウェイと ONTAP API の入力パラメータについては、ステップ 5 を参照してください。
    カテゴリ HTTP動詞 パス

    Unified Managerゲートウェイ

    ONTAP :ストレージ

    GET

    ゲートウェイ API : /gateways/{uuid}/{path}

    ONTAP API : /storage/volumes/{uuid}

    出力には、拡張後のボリュームサイズとして 120GB が表示されます。