「VxRail：REST APIを使用してVxRail 8.0.xおよび7.0.xリリースのNTPサーバーIPを変更する方法

Summary: VxRailアプリケーション プログラミング インターフェイス(API)を活用して、1つ以上の構成済みVxRailネットワーク タイム プロトコル(NTP)サーバーIPを確認および更新する方法。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Dell開発者向けパブリック ドキュメント

VxRail REST APIおよびその他のDell製品の開発者向けドキュメントは、 Dellサポート開発者サイトにあります。 ハイパーコンバージド インフラストラクチャ をフィルタリングしてVxRail固有のAPIを見つけます。

https://developer.dell.com/apis ホームページ

NTPのクエリーまたはアップデートに関する具体的なドキュメントについては、「 システム情報」、「NTPの取得と設定」を参照してください。

NTPドキュメント

このドキュメントは、カスタムの curl コマンドや、 postman または、より経験豊富なユーザー向けの他のアプリケーション。


VxRail組み込みAPIクライアント 

VxRail APIを使用するための好ましい方法(REST APIにあまり詳しくないユーザーに推奨)は、ネイティブのVxRail Manager APIクライアントを活用することです

VxRailコード バージョン7.0.350からは、スポットライトに基づいて、より優れた機能を備えた新しいインターフェイスが使用されます。ネイティブAPIクライアントにアクセスするには、次のURLにアクセスします。 <VxM> は、任意のブラウザーを使用してVxRail Manager FQDN/IPに置き換えます(特別なAPIクライアントは必要ありません)。

https://<VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
この例では、VxRail ManagerのIPは 172.168.10.50 そのため、URL は https://172.168.10.50/rest/vxm/api-doc.html:
VxRail Manager REST API


現在のVxRailクラスターNTP構成のクエリー

コマンド v1_sytem_ntp_get API 現在のNTP構成をクエリーするには、左側のパネルの[System Information]セクションを使用します。
  • ダイレクト URL は次のようになります。 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get ただし、これらはバージョンによって変更される可能性があるため、UIで移動するのが最適です。
  • VxRail vCenter Single Sign-On(SSO)認証認証情報を入力します。これは多くの場合、 administrator@vsphere.local ただし、ドメインの設定によって異なる場合があります。
  • [ Send Request ]ボタンをクリックして、 GET 依頼：
REST APIからのNTPのクエリー
  • APIクライアントが認証を行い、200 OK応答を受信した場合は、要求された情報を返します。ここで、現在のNTPサーバーのラボIPは次のとおりです。 172.168.10.45:
REST APIクエリーの結果


VxRailクラスターのNTP IPサーバー情報の更新

左側のパネルの [System Information ]セクションにあるv1_system_ntp_post APIを使用して、現在のNTP構成をアップデートします。
  • ダイレクト URL は次のようになります。 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post ただし、これらはバージョンによって変更される可能性があるため、UIで移動するのが最適です。
  • 認証セクションで、VxRail vCenter SSO認証認証情報を入力します。これは多くの場合、 administrator@vsphere.local ただし、ドメインの設定によって異なる場合があります。
  • NTPサーバーをアップデートするには、次の3つの領域の [Body ]セクションも編集します。
    • [Components]セクションはオプションで、[All]がデフォルトです。ALLが設定されている場合は、クラスター内のすべてのNTPサーバーが置き換えられます。VXMが設定されている場合、VxRail ManagerのNTPサーバーのみが置き換えられます。これは、すべてのコンポーネント構成の一貫性を保つことが推奨されるため、限定的なユース ケースとなります。 

注：値 VXM は、VCF on VxRail環境でのみサポートされます。
 
  • [vCenter]セクションでは、管理者SSOのユーザー名とパスワードを渡す必要があります。通常、これは[認証]セクションと同じ情報ですが、別の管理者レベルのSSOアカウントを指定することもできます。
  • serversセクションでは、NTPをIPに設定する例を示しています 172.168.10.45
 
注：複数のサーバーを追加する場合は、IPをコンマで区切る必要があります(例: 172.168.10.45, 172.168.10.46
 
  • [ Send Request ]ボタンをクリックして、POSTリクエストを実行します。
REST API SETコマンドの使用
REST API SETの結果


予期しない応答コード

正常でないシステムや、ESXiホストから新しいNTPサーバーにアクセスできないなど。APIクライアントは、いくつかの基本的なエラー メッセージ ガイダンスを提供し、追加の応答エラー コードは、たとえばオンラインで見つけることができます https://restfulapi.net/http-status-codes/ 好立地です

予期しないエラー コードが発生した場合は、それに応じてDellサポートに連絡して追加のトラブルシューティングを行います。
REST APIエラー

Additional Information

初期のVxRail 8.0リリースでは、Solve Onlineの手順でREST APIを使用してVxRail NTP IP設定を更新する方法が参照されています。この機能をVxRail UIプラグインで使用できるようにすることはVxRailロード マップ(正確なリリースは後述)に記載されています

この記事では、VxRail REST APIを利用した経験が少ないお客様向けに、このアクティビティーに関するガイダンスと例を紹介します

この記事のIP情報は、一時的な仮想分離ラボからのものであり、顧客情報や機密IP情報は含まれません。

Affected Products

VxRail Appliance Family
Article Properties
Article Number: 000215966
Article Type: How To
Last Modified: 28 Mar 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.