テナントの仮想マシンのリストの取得

2024年1月10日

ID 199649

登録されたテナントの全仮想マシンのリストを取得できます。

メソッド:

GET /api/2.0/virtualization/tenants/{テナント ID}/vms

各パラメータの説明:

{テナント ID} - Integration Server 定義データベース内のテナントの識別子(必須パラメータ)。

リクエストが正常に成功すると、REST API が仮想マシン のリストとテナントの仮想マシンに関する次の情報を返します:

<vm id="{定義データベース内の ID}" biosId={BIOS ID} created="{日時}" updated="{日時}">

<name>{名前}</name>

<userData><![CDATA[{詳細情報}]]></userData>

</vm>

各パラメータの説明:

  • {定義データベース内の ID} - Integration Server 定義データベース内の仮想マシンに割り当てられた識別子。
  • {BIOS ID} - 仮想マシンの識別子(BIOS ID)(UUID 形式)。
  • created="{日時}" - Integration Server 定義データベースに仮想マシンが登録された日時。形式:YYYY-MM-DDThh:mm:ss。
  • updated="{日時}" – 仮想マシンのデータが Integration Server 定義データベースでアップデートされた日時。形式:YYYY-MM-DDThh:mm:ss。
  • {名前} – 仮想マシン名。
  • {詳細情報} – Integration Server 定義データベースに保存された仮想マシンに関する詳細情報。

リターンコード:

  • 200 (OK) – リクエストが正常に完了しました。レスポンスが、テナントの仮想マシンのリストを返します。
  • 403 (Forbidden) – リソースへのアクセスが拒否されました。
  • 404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound – Integration Server データベース内に、指定した識別子のテナントが見つかりません。

この記事はお役に立ちましたか?
改善できる点がありましたらお聞かせください。
フィードバックをいただき、ありがとうございました。改善に向けて取り組んでまいります。
フィードバックをいただき、ありがとうございました。改善に向けて取り組んでまいります。