Skip to main content
Active IQ Unified Manager
9.7
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

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

PDF

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

このワークフローでは、ONTAPボリュームの容量がほぼフルに達したときにイベントが生成されるユースケースを例に取り上げます。ワークフローには、Active IQ Unified ManagerとONTAPそれぞれのREST APIを呼び出してこの問題に対処する手順も含まれています。

メモ

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

  • ゲートウェイAPIとその使用方法について理解していることを前提とします。詳細については、「Gateway APIs」セクションを参照してください。

    ゲートウェイAPI

  • ONTAP REST API の使用方法を理解していること。ONTAP REST API の使用方法の詳細については、 "ONTAP REST APIの自動化のドキュメントを参照してください。"を参照してください。

  • アプリケーション管理者である。

  • REST API処理を実行するクラスタがONTAP 9.5以降でサポートされており、HTTPSを使用してUnified Managerに追加されている。

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

API Gateway ONTAPワークフロー

このワークフローには、Unified ManagerとONTAP両方のREST APIの呼び出しポイントが含まれています。

  1. ボリュームの使用容量を通知するイベントからボリューム名をメモします。

  2. ボリューム名を `name`パラメータの値として使用し、次の Unified Manager API を実行してボリュームを照会します。

    カテゴリ HTTP動詞 パス

    datacenter

    GET

    /datacenter/storage/volumes

  3. 出力からクラスタのUUIDとボリュームのUUIDを取得します。

  4. Unified Manager の Web UI で、General > Feature Settings > API Gateway に移動して、API Gateway 機能が有効になっているかどうかを確認します。有効になっていない限り、 `gateway`カテゴリの API は呼び出すことができません。無効になっている場合は、この機能を有効にしてください。

  5. クラスター UUID を使用して、ONTAP API /storage/volumes/{uuid} を API ゲートウェイ経由で実行します。ボリューム UUID が API パラメータとして渡されると、クエリはボリュームの詳細を返します。

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

    カテゴリ HTTP動詞 パス 
     Unified Manager: gateway
ONTAP：storage

    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は次のとおりです： `+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を実行し、ボリュームのサイズを変更します。ゲートウェイAPIとONTAP APIの入力パラメータについては、手順5を参照してください。

    カテゴリ HTTP動詞 パス 
     Unified Manager: gateway
ONTAP：storage

    PATCH

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

    ONTAP API： /storage/volumes/{uuid}
    メモ

    クラスター UUID とボリューム UUID に加えて、ボリュームのサイズ変更のための size`パラメーターの値を入力する必要があります。値は必ずバイト単位で入力してください。例えば、ボリュームのサイズを 100 GB から 120 GB に増やしたい場合は、クエリの最後にパラメーター `size`の値を入力してください： `-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を実行します。ゲートウェイAPIとONTAP APIの入力パラメータについては、手順5を参照してください。

    カテゴリ

    HTTP動詞

    パス

    		 
     Unified Manager: gateway
ONTAP：cluster

    GET

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

    ONTAP API： /cluster/jobs/{uuid}

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

  9. 次のONTAP APIを実行して、サイズ変更後のボリュームの詳細を照会します。ゲートウェイAPIとONTAP APIの入力パラメータについては、手順5を参照してください。

    カテゴリ

    HTTP動詞

    パス

    		 
     Unified Manager: gateway
ONTAP：storage

    GET

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

    ONTAP API： /storage/volumes/{uuid}

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