日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

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

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

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

注記

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

  • ゲートウェイの API とその使用方法を理解しておきます。詳細については、「 Gateway API 」の項を参照してください。

  • ONTAP REST API の使用について理解しておく必要があります。ONTAP REST API の使用については、 ONTAP REST API 開発者ガイドを参照してください。

  • あなたはアプリケーション管理者です。

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

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

API ゲートウェイの ONTAP ワークフロー

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

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

  2. name パラメータにボリューム名を指定し、次の Unified Manager API を実行してボリュームを照会します。

    カテゴリ HTTP 動詞 パス

    データセンター

    取得

    「 /datacenter /storage/volumes 」

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

  4. Unified Manager Web UI で、 * 一般 * > * 機能設定 * > * API ゲートウェイ * と移動して、 API ゲートウェイ機能が有効になっているかどうかを確認します。有効になっていないかぎり、ゲートウェイカテゴリの API を呼び出すことはできません。機能が無効になっている場合は、有効にします。

  5. クラスタ UUID を使用して、 API ゲートウェイ経由で ONTAP API 「 storage-volumes / { uuid } 」を実行します。API パラメータとしてボリューム UUID を指定した場合、クエリはボリュームの詳細を返します。

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

    カテゴリ HTTP 動詞 パス

    Unified Manager :ゲートウェイ

    ONTAP ストレージ

    取得

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

    ONTAP API:`/storage/volume\{uuid}`

    注記

    /gateways / { uuid } / { path } の値は、 REST 処理を実行するクラスタ UUID に置き換える必要があります。\ { path } を ONTAP REST URL / ストレージ / ボリューム / { uuid } に置き換える必要があります。

    追加される URL は、「 /gateways ¥ {cluster_uuid} /storage/volumes/\ {volume_uuid} 」です

    GET 操作を実行すると、生成される URL は「 GETttp://<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 動詞 パス

    Unified Manager :ゲートウェイ

    ONTAP ストレージ

    パッチ

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

    ONTAP API:`/storage/volume\{uuid}`

    注記

    クラスタ UUID とボリューム UUID に加え、ボリュームのサイズ変更用の size パラメータの値を入力する必要があります。値をバイト単位で入力してください。たとえば ' ボリュームのサイズを 100 GB から 120 GB に拡張する場合は ' クエリの最後にパラメータ・サイズの値として '-d {\"size\":1288490188}" を入力します

    • 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:`gateways /{uuid}/{path}`

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

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

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

    カテゴリ HTTP 動詞 パス

    Unified Manager :ゲートウェイ

    ONTAP ストレージ

    取得

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

    ONTAP API:`/storage/volume\{uuid}`

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