Workload Optimization Manager 3.6.0 API ガイド

このマニュアルに記載されている仕様および製品に関する情報は、予告なしに変更されることがあります。このマニュアルに記載されている表現、情報、および推奨事項は、すべて正確であると考えていますが、明示的であれ黙示的であれ、一切の保証の責任を負わないものとします。このマニュアルに記載されている製品の使用は、すべてユーザー側の責任となります。

対象製品のソフトウェア ライセンスと限定保証は、製品に添付された『Information Packet』に記載されています。添付されていない場合には、代理店にご連絡ください。

Cisco が採用している TCP ヘッダー圧縮機能は、UNIX オペレーティング システムの UCB（University of California, Berkeley）のパブリック ドメイン バージョンとして、UCB が開発したプログラムを採用したものです。All rights reserved. Copyright © 1981, Regents of the University of California.

ここに記載されている他のいかなる保証にもよらず、各社のすべてのマニュアルおよびソフトウェアは、障害も含めて「現状のまま」として提供されます。シスコおよび上記代理店は、商品性、特定目的適合、および非侵害の保証、もしくは取り引き、使用、または商慣行から発生する保証を含み、これらに限定することなく、明示または暗黙のすべての保証を放棄します。

いかなる場合においても、シスコおよびその供給者は、このマニュアルの使用または使用できないことによって発生する利益の損失やデータの損傷をはじめとする、間接的、派生的、偶発的、あるいは特殊な損害について、あらゆる可能性がシスコまたはその供給者に知らされていても、それらに対する責任を一切負わないものとします。

このマニュアルで使用している IP アドレスおよび電話番号は、実際のアドレスおよび電話番号を示すものではありません。マニュアルの中の例、コマンド出力、ネットワーク トポロジ図、およびその他の図は、説明のみを目的として使用されています。説明の中に実際の IP アドレスおよび電話番号が使用されていたとしても、それは意図的なものではなく、偶然の一致によるものです。

この文書の印刷されたハード コピーおよび複製されたソフト コピーは、すべて管理対象外と見なされます。最新版については、現在のオンライン バージョンを参照してください。

シスコは世界各国 200 箇所にオフィスを開設しています。各オフィスの住所、電話番号、FAX 番号は当社の Web サイト（www.cisco.com/go/offices）をご覧ください。

Cisco および Cisco のロゴは、米国およびその他の国における Cisco およびその関係会社の登録商標を示します。シスコの商標の一覧については、https://www.cisco.com/c/en/us/about/legal/trademarks.html をご覧ください。記載されているサードパーティの商標は、それぞれの所有者に帰属します。「パートナー」という言葉が使用されていても、シスコと他社の間にパートナーシップ関係が存在することを意味するものではありません。（1721R）

© 2018-2023 Cisco Systems, Inc. All rights reserved.

API ガイドの変更履歴

API ガイドの新しい各リビジョンには、次の変更が含まれています。API がメジャー リリース間で大幅に変更された場合、または API ガイドの重大なエラーを修正する場合は、メジャー リリースごとに API ガイドの新しいリビジョンを投稿します。

APIリファレンス

このガイドは、Workload Optimization Manager ソフトウェアとの対話をスクリプト化し、Workload Optimization Manager と他のソフトウェアアプリケーションとの統合を開発するときに、Workload Optimization ManagerEST API を使用するのに役立ちます。

REST API は、HTTP の GET、POST、PUSH、および DELETE メソッドを介して、Workload Optimization Manager のデータと処理をリモートアクセスに公開します。

Workload Optimization Manager のユーザーインターフェースはこの API のクライアントであり、ユーザー インターフェースで公開されるすべての機能は API 呼び出しの結果です。API を理解するには、Workload Optimization Manager のユーザーインターフェイス、公開している機能、使用するデータ、サポートするユースケースに関する実用的な知識が必要です。ほとんどの場合、Workload Optimization Manager の動作の一部をスクリプト化する場合は、その動作の大部分をユーザーインターフェイス経由で実行できるはずです。そのコンテキストでこれらのユースケースをステップ実行すると、スクリプトの計画と実装に役立ちます。

REST API を最大限に活用するには、Workload Optimization Manager がその基礎となるデータを編成する方法と、さまざまな REST リソースがその組織にどのようにマッピングされるかを理解する必要があります。この導入セクションには、以下の基礎となるデータの説明が含まれています。

■      マーケットとそれらが環境を表す方法（19 ページの「マーケット」を参照）

■      プランとその使用方法の概要（21 ページの「プラン」を参照）

■      ワークロード配置ポリシーとその表現方法（23 ページの「ワークロード配置ポリシー」を参照）

■      展開の予約とその設定方法（24 ページの「予約」を参照）

注：

このガイドは、REST API で考えられるすべての設定とデータペイロードに関する包括的なリファレンスではありません。多くのエンドポイントの説明には、API データオブジェクトのサンプルが含まれていますが、入力のすべての可能な組み合わせを説明することはできません。API の完全なリファレンスについては、このガイドと『Workload Optimization ManagerEST Swagger-UI』ドキュメントを併せて使用してください。詳細については、18 ページの「Workload Optimization ManagerEST API Swagger ドキュメント」を参照してください。

Workload Optimization ManagerEST API の使用開始

API で結果を確認する最も簡単な方法は、Swagger UI で呼び出しを試すことです。Swagger UI を使用するには、次の場所に移動します。

https://<Your_Workload Optimization Manager_IP>/swagger/external/index.html

Swagger UI を使用して、さまざまなエンドポイントに移動し、それらのメソッドを試すことができます。たとえば、ユーザーエンドポイントに移動すると、Workload Optimization Manager のインストールで指定されているすべてのユーザーのリストを取得できます。詳細については、18 ページの「Workload Optimization ManagerEST API Swagger ドキュメント」を参照してください。

最終的には、API を使用してデータを取得したり、アクションを実行したり、Workload Optimization Manager を他のプロセスと統合したりするスクリプトを実装することになります。API を使用するときは、次のことを知っておく必要があります。

■      認証

■      URI の構造

■      応答形式

■      Workload Optimization Manager API での時間

認証

API を使用するには、Workload Optimization Manager インスタンスに有効なユーザーアカウントが必要です。また、アカウントはさまざまな役割を持つ場合があることに注意してください。API は、ユーザーロールに有効なコマンドのみを実行します。たとえば、Workload Optimization Manager の推奨アクションを実行するには、アカウントに管理者、デプロイヤー、またはオートメータのロールが必要です。

API 呼び出しを行うには、認証トークンをリクエストし、呼び出しごとにそれを Workload Optimization Manager API に渡します。トークンリクエストは、認証用の Cookie を返します。このトークンを使用する一般的な方法は、Cookie をローカルに保存し、API 呼び出しで渡すことです。

例：curl -s -k -c /tmp/cookies -H 'accept: application/json' 'https://localhost/api/ v3/login?hateoas=true' -d 'username=administrator&password=password'

それから、ログインリクエストによって配信されるセッション Cookie を使用するために、各リクエストで -b cookie-filename パラメータを使用する必要があります。

もう 1 つのアプローチは、認証ヘッダーを取得して認証 Cookie を解析することです。それから、Cookie を含む各 API リクエストのヘッダーを作成できます。たとえば、token という名前の変数に値を格納するとします。次のように使用できます。

headers = {'cookie': token}

r = requests.get('https://10.10.123.456/api/v3/targets/specs', headers=headers, verify=False, stream=True)

注：より完全な説明については、API クックブックの 287 ページ、「認証レシピ」を参照してください。

URI の構造

Workload Optimization ManagerEST API を使用する際、クライアントが特定の REST リソースに対して HTTP リクエストを行います。Workload Optimization ManagerEST API は、以下の標準 HTTP メソッドをサポートします：

■      GET

エンティティまたはデータ オブジェクトのリストを取得し、個々のアイテムを取得します。

■      POST

Workload Optimization Manager 環境で新しいオブジェクトを作成するか、特定のクエリのフィルタを指定します。

■      PUT

既存のエンティティまたはオブジェクトを段階的に変更します。

■      DELETE

エンティティまたはオブジェクトを削除します。

Workload Optimization ManagerEST API リソースの基本的な URI 構造は次のとおりです：

https://<Your_Workload Optimization Manager_IP>/api/<API_version>/<resource_name>

たとえば、インストール内のユーザーを一覧表示する場合、次のようになります：

https://111.222.33.44/api/v3/users

応答形式

Workload Optimization ManagerEST API は、データを JSON オブジェクトとして返します。Workload Optimization Manager は、これらのオブジェクトをデータ転送オブジェクトまたは DTO と呼びます。DTO は、要求したデータを記述するキーと値のペアの配列で

す、つまりPOST または PUT の実行結果であるデータです。たとえば、Workload Optimization Manager のインストール用に定義されたユーザーに対して GET を実行すると、API は次のような DTO を返します。

[

{

Links

{

"rel": "self",

"href": "https://10.10.10.10/api/v3/users/_4T_7kwY-Ed-WUKbEYSVIDw"

}

],

"uuid": "_4T_7kwY-Ed-WUKbEYSVIDw",
"displayName": "Administrator User",
"username": "administrator",
"roleUuid": "_4UAioQY-Ed-WUKbEYSVIDw",
"roleName": "administrator",
"loginProvider": "Local",

"type": "DedicatedCustomer",
"showSharedUserSC": false

}

]

この場合、DTO は 1 つのオブジェクトの配列です。つまり、この Workload Optimization Manager のインストールに対して定義されているユーザーアカウントは 1 つだけです。ユーザーオブジェクトは、このユーザーアカウントへの URL を提供するリンク 配列で始まります。その後、特定のユーザーアカウントを説明するプロパティが続きます。

ほとんどの場合、PUT または POST を実行するには、パラメータを渡し、DTO を介してオブジェクトを作成することに注意してください。これらの DTO は、関連する応答 DTO に似ていますが、同一ではありません。このユーザーアカウントの例では、応答 DTO にはユーザーアカウントのパスワードが含まれていませんが、アカウントを作成するための DTO にはパスワードが含まれている必要があります。

Swagger UI でさまざまな REST メソッドを試して、典型的な応答 DTO を確認できます。

Workload Optimization Manager API での時間

Workload Optimization ManagerEST API には、情報を作成またはフィルタリングするために開始時刻または終了時刻、あるいはその両方を必要とするリクエストが含まれています。時間は、次の 3 つの異なる形式で入力できます。

■      ISO 8601 の日付と時刻の形式

YYYY-MM-DDTHH：MM：SS. たとえば、2018-10-07T12：38：17

■      エポック時間

エポック時間は、1970 年 1 月 1 日の午前 0 時からの経過秒数として表されます。たとえば、1514764800 は 2018 年 1 月 1 日午前 12：00：00 UTC に対応します。

■      相対時間

相対時間とは、呼び出しの実行時点を基準とした相対時間のことです。たとえば、開始時刻が -1w で終了時刻が -1d の場合、結果には、呼び出しが実行される 1 週間前から呼び出しが実行される前日までのエントリが含まれる必要があることを示します。相対時間の単位では大文字と小文字が区別されます。Workload Optimization Manager は、次の想定時間をサポートしています。

–      m — 分

–      h — 時間

–      d — 日

–      w — 週

–      M — 月

–      y — 年

Workload Optimization Manager API のページネーション

一部の API 呼び出しは、非常に大きなデータセットを返します。Workload Optimization Manager は、常にページネーション機能を使用することを推奨しています。これは、Workload Optimization Manager によって管理される大規模な環境では特に重要です。個々のリクエストの範囲とフィルタを介して、データを事前にフィルタすることができます。limit および x-next-cursor パラメータを使用すると、データを扱いやすいチャンクで返すことができます。

次に例を示します。

https://10.10.10.10/api/v3/markets/214075923753936/entities/stats?limit=5&ascending=true

上記のリクエストは、特定のマーケットのすべてのエンティティの統計を取得することです。limit=5 は、返されるデータの各ページに 5 つの結果が必要であることを示します。

返されたデータのヘッダーには、x-next-cursor：5 が含まれます。結果の次のページを取得するには、次のリクエストでカーソルを使用します。

https://10.10.10.10/api/v3/markets/214075923753936/entities/stats? cursor=5&limit=5&ascending=true

最終ページに到達すると、x-next-cursor は空になります。

リクエストに orderBy、limit、または cursor パラメータが含まれている場合、これらのパラメータのいずれかを使用すると、ページ分割された結果が返されます。

Workload Optimization ManagerEST API Swagger ドキュメント

Swagger のドキュメントでさまざまな REST メソッドを試して、一般的な応答 DTO を確認できます。Workload Optimization Manager Swagger のドキュメントにアクセスするには、次の場所に移動します。

https://<Your_Workload Optimization Manager_IP>/swagger/external/index.html

このドキュメントでは、API のさまざまなエンドポイントのすべてのメソッドに関するドキュメントを提供する標準の Swagger-UI アプリケーションを使用します。このドキュメントには、呼び出しの説明、渡すパラメータのリスト、POST または PUSH する JSON ペイロードの説明、および応答で取得するペイロードが含まれています。JSON ペイロードの MODEL を表示すると、JSON 構造をナビゲートして、さまざまなオブジェクト フィールドの説明を表示できます。

API にアクセスするには、Swagger-UI で認証が必要です。Workload Optimization Manager にすでにログインしている場合は、ブラウザー セッションに現在の認証 Cookie があるはずです。Swagger-UI は、API 認証にこれと同じ Cookie を使用します。

各メソッドについて、Swagger ドキュメントには、Swagger-UI を介して呼び出しを設定して実行できる「試してみる」機能が含まれています。これにより、応答として次の情報が生成されます。

■      呼び出しのための curl リクエスト

Swagger によって生成された curl コマンドは、お使いの環境で使用するためにいくつかの変更が必要になる場合があります（たとえば、引用符をエスケープしたり、HTTP URL を使用するために -k 修飾子を追加したりします）。

■      呼び出しの標準 HTTP リクエスト

■      サーバーの応答コード

■      応答本体 – API 呼び出しが返す JSON データ

■      応答ヘッダー

注：SwaggerUI を使用して API 呼び出しを試行し、API 呼び出しがエラーを返した場合（たとえば、呼び出しで間違った構文が使用されている場合）、状況によっては SwaggerUI にエラーが表示されず、返されたデータのフィールドが空になります。

Workload Optimization Manager マーケット

Workload Optimization Manager は、マーケットベースの分析を使用してワークロード管理を実行します。これを行うには、環境のモデルを構築し、各エンティティをマーケットの買い手と売り手として表します。このモデルには、名前付きのマーケットリソースを介してアクセスできます。

いつでも、Workload Optimization Manager アプライアンスは、メモリ内に多くのマーケットを持つことができます。アプライアンスの現在のマーケットのリストを取得するには、次の URL を実行します。

GET: /rest/markets

このリストは、メインのリアルタイムマーケットに加えて、呼び出し時にメモリ内にあるすべてのプランのマーケットを返します。グループ UUID を渡して、呼び出しの範囲を設定できることに注意してください。その場合、呼び出しは、渡されたグループを範囲に含むプランのマーケットのみを返します。

リアルタイムマーケット

リアルタイムマーケットは、環境の分析とワークロード管理を実行します。リアルタイムマーケットを使用してエンティティにアクセスし、エンティティに関する現在または過去のデータを取得できます。

リアルタイムマーケットの displayName は Market です。このマーケットは常に RUNNING 状態でなければなりません。いかなる状況においても、API を使用してこのマーケットを停止しないでください。

Workload Optimization Manager は、ディスカバリーを実行して、管理するトポロジ（リアルタイムマーケットのエンティティのコレクション）にデータを取り込みます。このため、リアルタイムマーケットからエンティティを削除したり、リアルタイムマーケットにエンティティを追加したりしないように注意する必要があります。

リアルタイムマーケットでは、以下のような POST、PUT、および DELETE 呼び出しを安全に実行できます：

■      クエリーフィルタを投稿して、リアルタイムマーケットのアクション、通知、統計のフィルタ済みリストを取得

■      リアルタイムマーケットでの配置ポリシーを作成するための投稿

■      削除して、リアルタイムマーケットから配置ポリシーを削除

■      リアルタイムマーケットの配置ポリシーを編集

■      リアルタイムマーケットにシナリオを投稿してプランを実行

リアルタイムマーケットに対してプランのシナリオを実行する場合、Workload Optimization Manager はリアルタイムマーケットのコピーを作成し、コピーをプランのシナリオに従って変更します。

注：

POST または DELETE メソッドを実行して、リアルタイムマーケットのトポロジを変更することができます。ただし、このことが必要となる可能性はほとんどありません。リアルタイムマーケットの変化は、Workload Optimization Manager が実行する分析に影響を与えることに注意してください。たとえば、リアルタイムマーケットから VM を削除すると、Workload Optimization Manager はその配置を管理できなくなります。VM は引き続き環境に存在しますが、Workload Optimization Manager によって管理されなくなります。ただし、この手法を使用して、特定のエンティティを Workload Optimization Manager で使用できないようにすることはできません。次の検出パスでは、Workload Optimization Manager は削除されたエンティティを再検出するので、リアルタイムマーケットに再び表示されます。

プランマーケット

Workload Optimization Manager は、メモリー内のリアルタイムマーケット以外のマーケットを持つことができます。これらの他のマーケットはプランを表しています。

プランマーケットは、リアルタイムマーケットのスナップショットとして始まります。シナリオをリアルタイムマーケットに POST すると、Workload Optimization Manager は次の 2 つのことを行います：

■      リアルタイムマーケットのコピーを作成し、プランマーケットを作成します。このプランマーケットは、シナリオで宣言された変更を除いて、リアルタイムマーケットと同じです。たとえば、シナリオでプランの範囲が宣言されている場合、プランマーケットにはその範囲内のエンティティのみが含まれます。

■      これ以上意味のある改善が行われなくなるまで、このプランマーケットに対して経済サイクル（売買サイクル）を実行します。その時点で、計画の実行が完了します。

Workload Optimization Manager がプランマーケットを作成すると、そのマーケットは削除するまでメモリに残ることに注意してください。また、後でシナリオをプランマーケットに適用できることにも注意してください。これは、計画に基づいてプランを実行する方法です。ロジックフローは同じで、Workload Optimization Manager は、分析を実行するためにさらに別のプランマーケットを作成します。

社内利用プラン

Workload Optimization Manager は、GUI に表示するデータを生成する計画を定期的に実行します。クラスタキャパシティダッシュボードとプロジェクトクラスタリソースダッシュボードの両方に、定期的に実行されるプランによって生成されたデータが表示されます。

内部使用のプランマーケットでは、displayName にサブストリング _BasePlan が含まれます。いかなる理由があっても、これらのプランマーケットを変更しないでください。

ユーザー作成プラン

ユーザーは、環境内で what-if シナリオを実行する計画を作成でき、結果はプランマーケットとして保存されます。いつでも、各ユーザーアカウントは、複数のプランマーケットを Workload Optimization Manager インスタンスにロードできます。

プランマーケットは名前で識別します。プラン名には <PlanType><userName>_<arbitraryID> を付けて指定します。

有効なプラン名は、たとえば CLOUD_MIGRATION_cud_1493140514716 のようになります。このプランを所有しているユーザーを調べるには、ユーザーの名前を解析し、そのユーザーのアカウント情報を API に照会します。

プランマーケットを取得すると、応答には次のような情報が含まれます。

■      uuid：マーケットの識別子。

■      state：プラン計画が成功したかどうか。state としては、次のいずれかがあり得ます。

–      CREATED

–      READY_TO_START

–      実行中

–      COPYING

–      SUCCEEDED

–      停止中

–      停止済み

–      USER_STOPPED

–      削除中

プランマーケットが実行中の間は、Workload Optimization Manager はまだプランの結果を計算しています。マーケットが停止したら、プランは実行済みで、このマーケットのデータにアクセスしてプランの結果を確認できます。実行中のプランを停止するために、マーケットに PUT 呼び出しを行うことができます。

プランマーケットの場合、リアルタイムマーケットで実行するのと同じ POST、PUT、および DELETE メソッドを実行できます。これには、以下が含まれます。

■      POST でクエリーフィルタを投稿して、プランマーケットのアクション、通知、および統計のフィルタ済みリストを取得

■      POST でプランマーケットでの配置ポリシーを作成

■      DELETE でプランマーケットから配置ポリシーを削除

■      PUT でプランマーケットでの配置ポリシーを編集

■      POST でプランマーケットにシナリオを投稿し、計画通りにプランを実行

プランマーケットでは、次のメソッドも安全に実行することができます。

■      DELETE でプランマーケットを削除

■      PUT でプランマーケット保存または停止

注：

GUI または API を介してプランマーケットを停止することができます。また、計算が完了する前にプランを停止することもできます。この場合、プランの結果は不完全になります。

計画の実行

プランとは、環境に加えられる可能性のある変更の結果を調査するシミュレーションまたは仮定のシナリオです。プランを実行するために、Workload Optimization Manager はリアルタイムマーケットのスナップショットコピーを作成し、そのスナップショットに変更を加えます。次に、経済スケジューリングエンジンを使用して、計画市場について分析を実行します。

API でプランを操作するには、GUI を介したプランに精通している必要があります。達成できるプランと、次のようなプランの設定を指定する方法を知っている必要があります。

■      プラン範囲

■      環境内のワークロードの変更（VM の追加または削除）

■      供給に関する変更（ハードウェアの追加、削除、または再構成）

■      配置に関する変更（クラウドまたは別のクラスタへの移行）

■      制約の変更

プランを作成するには、最初にプランのシナリオを指定します。これは、すべてのプラン設定を含むオブジェクトです。シナリオオブジェクトには一連の変更が含まれており、変更ごとに必要な設定が宣言されます。

シナリオを作成したら、それをマーケットにポストします。ほとんどの場合は、リアルタイムマーケットにポストします。シナリオをマーケットにポストすると、Workload Optimization Manager は次の 2 つのことを行います。

■      マーケットのコピーを作成し、プランマーケットを作成します。このプランマーケットは、シナリオで宣言された変更を除いて、元のマーケットと同じです。たとえば、シナリオでプランの範囲が宣言されている場合、プランマーケットにはその範囲内のエンティティのみが含まれます。

■      これ以上意味のある改善が行われなくなるまで、このプランマーケットに対して経済サイクル（売買サイクル）を実行します。この時点で、プランの実行が完了します。

プランマーケットの保存と削除

プランを実行すると、Workload Optimization Manager によって分析が実行され、結果が表示されます。また、ユーザーが後で結果を GUI にロードできるように、プランの結果をシリアル化して保存します。

注：

Workload Optimization Manager を更新すると、保存された計画結果のデータ形式が変更される場合があります。その場合、結果に矛盾点が生じます。Workload Optimization Manager を更新するたびに、保存するすべてのプランを再生成し、再度保存する必要があります。

API 経由でプランを削除するには、プランマーケットで DELETE メソッドを実行するだけです。

シナリオの作成

プランの最初のステップは、シナリオを作成することです。シナリオはプランとは完全に別のものであることに注意してください。シナリオを作成し、それをマーケットに POST してプランを作成します。ただし、シナリオはまだメモリに存在するので、必要に応じて別のマーケットに適用できます。たとえば、同じシナリオをさまざまな時間にリアルタイムマーケットに適用できます。

シナリオを作成するには、POST: /rest/scenarios/{name} メソッドを使用します。このメソッドは、次の 3 つのパラメータを取ります。

■      scope

グループ UUID の配列。複数のグループの範囲の場合、同じタイプのグループを指定する必要があります。

■      projection_days

予測シナリオの場合の、各予測期間をマークする日

■      input

シナリオのすべての設定を指定できる ScenarioApiInputDTO。

入力 パラメータである ScenarioApiInputDTO は、シナリオ設定を指定するために API に POST できるオブジェクトです。API には、シナリオを作成および削除するメソッドが含まれています。ほとんどの場合、必要なシナリオ設定を宣言するために変更を加えて ScenarioApiInputDTO を POST または PUT することによって、シナリオを作成します。API には、プロパティを URL で直接渡すことによって、これらの設定の多くを特定のシナリオに PUT するために使用できるメソッドが含まれていることに注意してください。ただし、これらの設定を ScenarioApiInputDTO で行うこともできます。この DTO の使用方法を学ぶことは、シナリオを作成および変更するための最も一貫した方法です。

シナリオを作成するときには、シナリオのすべての設定を ScenarioApiInputDTO に POST することができます。または、部分的なシナリオを作成してから、別の時点でシナリオに他の変更を PUT することもできます。

予測シナリオの作成

予測プランでは、将来のインフラストラクチャ要件を計算するため、環境は時間の経過に伴うワークロード要件の変化に対応できます。1 つの計画で、計画の範囲、将来のどの程度まで予測するか、およびどの時間単位で行うかを指定できます。たとえば、特定のデータセンターの 1 年先の要件を予測し、1 か月間隔で要件がどのように変化するかを示すことができます。

API を介して予測シナリオを作成するときは、今日から予測する日数の配列として予測期間を指定します。たとえば、今日は 0、今日から 30 日は 30、今日から 60 日は 60 などです。

予測プランのシナリオを作成するには：

■      シナリオの範囲を設定する

予測プランには、シナリオの範囲が必要です。

■      PROJECTION_PERIODS タイプの計画に変更を作成する

この変更により、必要な計画期間が日の配列として識別されます。

{

"changes":[

{

"type”:"PROJECTION_PERIODS",

"projectionDays":[0,30,60,90]

}

]

}

■       特定の予測期間に繰り返す計画の変更については、その変更のprojectionDays 配列を指定します。この配列の項目は、PROJECTION_PERIODS の変更に指定したprojectionDaysと一致する必要があることに注意してください。

たとえば、最初の予測で "projectionDays":[0,30,60,90] を指定したとします。

–      有効："projectionDays":[0,30,60,90]

–      有効："projectionDays":[30,90]

–      無効："projectionDays":[0,35,70,90]

このリストは、プランマーケットを対象とするプランシナリオを示しており、4 つの期間の予測を設定し、4 つの予測期間のうち 2 つの予測期間に 1 つの VM をインベントリに追加します。

{

"displayName":"My Projection", "changes": [

{

"type": "SCOPE",

"scope": [

{

"uuid": "5678a46e9716657be88b5e1217df91436e13e4ff", "className": "Group",

"entitiesCount": 2, "groupType": "VirtualMachine",

}

]

},

{

"type": "PROJECTION_PERIODS",

"projectionDays": [
0,

30,

60,

90

]

},

{

"type": "ADDED",

"targets": [

{

"uuid": "564d89f4-190b-de1b-cb28-3e2f2126ab48"

}

],

"value": "1", "projectionDays": [

30

]

}

]

}

プランの配置ポリシー

検出された配置ポリシーは有効または無効にすることができます。これは、異なる制約のセットがある場合に環境がどのように変化するかを確認するのに役立ちます。配置ポリシーはマーケットのコンテキストに存在することに注意してください。配置ポリシーを取得するには、それを含むマーケットにクエリーを実行します。プランの配置ポリシーを作成するには、ポリシーを作成してプランマーケットに追加します。

プランで配置ポリシーを有効または無効にする場合は、それをシナリオの変更として指定します。配置ポリシーはマーケットに存在するため、プランを実行するマーケットを知り、そのマーケットからポリシーを取得する必要があります。

たとえば、リアルタイムマーケットに対してプランを実行する場合は、次のようにします。

■      必要なポリシーについてリアルタイムマーケットのクエリーを実施する

■      シナリオ変更オブジェクトでそのポリシーの UUID を指定する

■      シナリオ変更オブジェクト内で、ポリシーの有効化または無効化を指定する

■      シナリオが完成したら、リアルタイムマーケットにシナリオをPOSTする

プランを実行すると、Workload Optimization Manager が新しいプランマーケットを作成することに注意してください。このプランマーケットには配置ポリシーのコピーが含まれ、設定に応じて有効または無効になります。

ワークロード配置ポリシー

ワークロード配置ポリシーは、Workload Optimization Manager が環境内のワークロードの配置を計算する方法に影響を与えるようにします。ポリシーは、特定のビジネスルールを適用して配置を制限することができ、境界を削除して、クラスタまたはデータセンターの境界を越えた配置計算を可能にすることができます。

配置ポリシーは、リアルタイムマーケットまたはプランマーケットのいずれかのマーケットのコンテキストに存在します。各マーケットには独自の配置ポリシーがあります。プランマーケットがリアルタイムマーケットの正確なコピーであっても、プランマーケットには独自の配置ポリシーがあり、それぞれに独自の UUID があります。

API を介して配置ポリシーを操作する前に、それらがユーザーインターフェイスでどのように機能するかを理解する必要があります。作成できる配置ポリシーのタイプと、それぞれのマーケット分析への影響を理解する必要があります。

API は次のタイプのポリシーをサポートします。

■      AT_MOST_N：プロバイダーグループの 1 つのメンバーで実行できるのは、最大でここに指定された数のコンシューマーのみです。これは、ポリシー オブジェクトの

キャパシティプロパティです。

■      BIND_TO_GROUP：コンシューマーは、プロバイダー グループのメンバーでのみ実行できます。

■      BIND_TO_COMPLEMENTARY_GROUP：コンシューマーは、プロバイダーグループのメンバーでは実行できません。

■      MUST_RUN_TOGETHER：これらのコンシューマーは、同じプロバイダーエンティティで実行する必要があります。

■      AT_MOST_N_BOUND：指定された数のコンシューマーのみがプロバイダーグループの単一のメンバーで実行でき、かつコンシューマーはプロバイダーグループのメンバーでのみ実行できます。

■      MERGE：指定されたクラスタのクラスタ境界を削除します。

■      BIND_TO_GROUP_AND_LICENSE：ライセンス グループを作成します。

ポリシーを取得すると、返されるオブジェクトには、ポリシーの種類、およびコンシューマー グループとプロバイダー グループが記述されます。ポリシーを作成するときに、完全なデータを提供する必要はありません。以下を提供します：

■      buyUuid：このポリシーのコンシューマーグループ。

■      sellerUuid：このポリシーのプロバイダーグループ。

■      type：ポリシーの種類。

■      policyName：このポリシーの表示名。

■      enabled：マーケットでポリシーを有効にするかどうか。true または false のいずれかです。

■      capacity：AT_MOST_N または AT_MOST_N_BOUND ポリシーの場合、プロバイダーエンティティで許可するコンシューマーの数。

■      mergeType：MERGE ポリシーの場合、マージするクラスタのタイプ。Cluster、StorageCluster、DesktopPools、または DataCenter のいずれかです。

■      mergeUuids：マージするグループ。グループ タイプは ``mergeType と一致する必要があります。たとえば、DON'T PLACE ポリシーを作成するには、次の inputDto をマーケットにポストします。

{

"buyerUuid": "f82dbbc2b3366052f3bc1ac8a68c9c06b0eb182a", "enabled": false,

"policyName": "PolicyFromApi",

"sellerUuid": "4a2f5f132ae690af147ccfd6ea9839e79da3db79", "type": "BIND_TO_COMPLEMENTARY_GROUP"

}

配置ポリシーを編集するには、指定されたポリシーに入力 Dto を PUT します。入力 Dto で必要な変更を指定します。

予約とワークロード配置の計算

Workload Optimization Manager には、将来展開する予定の VM 用にリソースを予約する機能が含まれています。Workload Optimization Manager は、これらの VM の最適な配置を計算し、必要なホストとストレージリソースを予約します。

VM を予約するには、VM テンプレートを選択し、配置の制約を指定し、予約するインスタンスの数を設定してから、現在予約するか将来予約するかを指定する必要があります。予約された VM はまだ存在しないので、リアルタイムマーケットには参加しません。VM テンプレートは、予約済み VM ごとに次のようなリソース要件を指定します。

■      各 VM に割り当てられたコンピューティングリソースとストレージリソース

■      消費要素。これは、予約された VM が使用する、割り当てられた CPU、メモリ、またはストレージの割合です。

API を使用して予約を操作する前に、予約がユーザーインターフェイスからどのように機能するかを理解する必要があることに注意してください。API を使用すると、次のことを実行できます。

■      予約一覧を取得する

■      予約ワークロードの現在の配置を表示する

■      予約を作成する

■      現在の予約を取り消す

予約情報を取得する

現在の予約のリストを取得するには、/rest/reservations を実行します。これにより、すべてのアクティブな予約のリストが返されます。必要な予約の UUID がわかっている場合は、それを渡して、その予約だけのデータを取得できます。

各予約オブジェクトには次のものが含まれます。

■      表示名

■      ステータス。次のいずれかです。

–      DEPLOYING — Workload Optimization Managerがワークロードを展開しています

–      DEPLOY_SUCCEEDED — ワークロードが正常に展開されました

–      IN_PROGRESS — 配置計算が進行中

–      PLACEMENT_SUCCEEDED — 新しい予約の場合、環境にはワークロードを配置するのに十分なリソースがあります。予約日を指定した場合、これはアクティブな予約になります

–      PLACEMENT_FAILED — 新しく作成された予約の場合、環境にはワークロードを配置するためのリソースがありません。予約日を指定した場合、これは未処理の予約になります

–      RETRYING — Workload Optimization Manager は、満たされていない予約のワークロードを配置しようとしています

■      予約が作成された時間、展開する時間、期限切れになる時間

■      予約済みワークロードの説明

■      ワークロードを展開するためにコピーされる物理ファイルと、オプションの配置制限を識別する展開プロファイル。

■      予約によって確保されるコンピューティングリソースとストレージリソースの統計、たとえば、次のリストは、1 つの VM の予約を示しています。

{

"uuid": "_kWZHIDDmEeePgeXuo0RRbw", "displayName": "MyReservation", "count": 1,

"status": "PLACEMENT_SUCCEEDED",

"reserveDateTime": "Thu May 04 16:27:29 UTC 2017",

"expireDateTime": "Thu Aug 31 16:27:29 UTC 2017",

"deployDateTime": "Thu Aug 31 16:27:29 UTC 2017",

"reserveCount": 1, "demandEntities": [

{

"uuid": "_kWgb7TDmEeePgeXuo0RRbw", "displayName": "MyReservation_C0", "className": "VirtualMachine", "template": {

"uuid": "T423f548d-cadc-e525-6df4-1f90724cf696", "displayName": "vsphere-dc3.dev.mycorp.com::TMP-SUSE64", "className": "VirtualMachineProfile"

},

"deploymentProfile": {

"uuid": "_gHJ0ICXxEeePgeXuo0RRbw",
"displayName": "DEP-SUSE64",
"className": "ServiceCatalogItem"

},

"placements": { "computeResources": [

{

"stats": [

{

"name": "numOfCpu", "value": 1

},

{

"name": "cpuSpeed", "value": 2603

},

{

"name": "cpuConsumedFactor", "value": 0.5

},

{

"name": "memorySize", "value": 2097152

},

{

"name": "cpuConsumedFactor", "value": 0.75

},

{

"name": "ioThroughput", "value": 0

},

{

"name": "networkThroughput", "value": 0

}

],

"provider": {

"uuid": "Virtual_ESX_42381da5-12fa-1e82-2f1c-887419380d43", "displayName": "hp-esx21.corp.vmturbo.com",

"className": "PhysicalMachine"

}

}

],

"storageResources": [

{

"stats": [

{

"name": "diskSize", "value": 18432.363

},

{

"name": "diskIops", "value": 0

}

],

"provider": {

"uuid": "10545c15-7687ef26",

"displayName": "QS2:ESXDC3DS1", "className": "Storage"

}

}

]

}

}

]

}

予約の作成

予約を作成するには、次の予約を定義する入力 DTO を POST します。

■      action：The action type：RESERVATION

■      demandName：予約の表示名 — 追加されたワークロードの名前を指定しない場合、これが新しい VM のルート名になります

■      配置パラメータ：

–      constraintIDs：計算された配置に影響を与える配置ポリシーの UUID の配列

–      count：配置するワークロードの数

–      entityNames：配置された VM の名前の配列 — 配列の長さは count と等しくなければならない

–      geographicRedundancy：true の場合、ワークロードを一意のホストに配置。それ以外の場合、Workload Optimization Manager は複数のワークロードを同じホストに配置できる

–      templateID：このワークロードを配置するために使用するテンプレートの UUID — テンプレートには、deploymantParameters で指定するデプロイメントプロファイルへの参照が含まれている必要があることに注意

■      expireDateTime：Workload Optimization Manager がその日付までにすべてのワークロードを配置できない場合に予約をキャンセルする時期 — RESERVATION アクションの場合、Workload Optimization Manager はデプロイ時間をこの時間と同じになるように自動的に設定

■      ReserveDateTime：ワークロードの配置を計算して予約を作成する時間 — この時間は、予約を API に POST した時間より前にすることはできない

次のリストは、予約を作成する入力 DTO を示しています。4 つのワークロードを配置し、それぞれに特定の名前を付けます。

{

"action": "RESERVATION",

"demandName": "MyReservation", "expireDateTime": "2017-10-10T12:38:17+00:00",

"parameters": [

{

"deploymentParameters": {

"deploymentProfileID": "_c9CJMDDAEeePgeXuo0RRbw"

},

"placementParameters": { "geographicRedundancy": false, "count": 4,

"entityNames": [ "foo","bar","baz","bonk"

],

"templateID": "_UKsnkJkSEeCHcOXEhzJExA"

}

}

],

"reserveDateTime": "2017-05-04T18:22:12+00:00"

}

非同期配置計算

予約が POST されると、Workload Optimization Manager は、指定したワークロードの配置を計算するためのプランを実行します。予約のサイズによっては、かなりの時間がかかる場合があります。API は配置を非同期に計算します。スクリプトが予約に依存している場合は、次に進む前に予約が完了していることを確認する必要があります。

予約を実行すると、POST への応答に計算が進行中であることが示されます。

{

"uuid": "_0dPrYTDlEeePgeXuo0RRbw", "displayName": "MyReservation", "count": 4,

"status": "IN_PROGRESS",

"reserveDateTime": "Thu May 04 18:22:12 UTC 2017",

"expireDateTime": "Tue Oct 10 12:38:17 UTC 2017"

}

配置結果を調べるには、API が応答で提供する UUID を使用して予約を GET します。

テンプレートの使用

予約を作成するには、ワークロード要件を含むテンプレートを指定します。VM テンプレートは、VM で使用できる次のようなリソースを指定します。

■      VCPU

■      仮想メモリ

■      ストレージ

■      ネットワークスループット

■      IOPS

■      IO スループット

テンプレートはユーザーが作成できますが、Workload Optimization Manager は、環境内の管理サービスによって作成されたテンプレートも検出することに注意してください。たとえば、ハイパーバイザまたはクラウドサービスプロバイダーは通常、独自のテンプレートを多数管理しており、Workload Optimization Manager はこれらも検出します。検出されたテンプレートは編集しないでください。

テンプレートが検出されたかどうかを確認するには、関心のあるテンプレートを GET して、discovered プロパティを探します。これは true または false になります。

Workload Optimization Manager REST API エンドポイント

REST API リソースにより、Workload Optimization Manager ソフトウェアへの完全なアクセスが可能になります。これは、Workload Optimization Manager 機能の完全なセットを公開する完全な API です。実際、製品のユーザーインターフェイスは、この API を使用する Workload Optimization Manager クライアントとして実装されています。

REST API リソースは SwaggerUI に記載されていますが、このセクションでは、API のより表現力豊かなリソースの詳細について説明します。

Workload Optimization ManagerEST SwaggerUI にアクセスするには、Web ブラウザを開いて次の操作を行います。

https://<Your_Workload Optimization Manager_IP>/swagger/external/index.html

ユーティリティリクエスト

Workload Optimization Manager API ガイドでは、ユーティリティリクエストはエンドポイント内のリクエストであり、環境に関する情報は返しませんが、他の呼び出しにメリットを提供します。たとえば、

https：//10.10.10.10/api/v3/settings/ は、可能なすべての設定マネージャのリストを返すユーティリティリクエストです。この情報を使用してインスタンスの設定を見つけることができますが、/settings/ リクエスト自体はインスタンス固有の情報を提供しません。

アクションエンドポイント

Workload Optimization Manager は、しきい値を超えた後に応答するのではなく、運用条件を分析し、環境全体を望ましい状態に維持するためのアクションを常に推奨します。これらのアクションを実行すると（または Workload Optimization Manager に代行させると）、環境ではお客様のパフォーマンスを保証する運用条件を維持しながら、一方でリソースの効率的な使用率によりコストを最小限に抑えることができます。

アクションエンドポイントを使用すると、次のことができます。

■      環境内のアクションの完全なリストまたはフィルタリングされたリストの取得

■      アクションの許可または拒否

■      指定されたアクションに関連する統計の取得

■      指定したアクションに関連する通知の受け取り

アクションユーティリティリクエスト

ユーティリティリクエストは、関連するリクエストの作成、inputDTO の組み立て、または特定の DTO の潜在的な値の表示に使用できるメタデータを提供します。

指定されたエンティティとアクションの有効な actionMode パラメータの取得

アクションエンドポイントには、指定されたエンティティとアクションタイプの actionMode パラメータの可能な値を示すユーティリティリクエストが含まれています。これらは、さまざまなアクション設定の可能性を設定または理解するために使用できます。

エンティティ/アクションタイプを指定するために、このリクエストは次のパラメータを取ります：

例：GET https：//10.10.10.10/api/v3/actions/availablemodes? action_type=PROVISION&entity_type=PhysicalMachine

応答：文字列の配列。各文字列は、指定された組み合わせの有効な actionMode です。この例では、PROVISION アクションとPhysicalMachine エンティティです。空の応答本文は、通常、実用的な理由から、要求されたエンティティにそのタイプのアクションがないことを示します。たとえば、ネットワーク エンティティは MOVE アクションを持つことができません。

[

"RECOMMEND", "DISABLED", "MANUAL", "AUTOMATIC"

]

アクションのエントリポイントのリストの取得

アクションエンドポイントには、他のアクション関連のリクエストのエントリポイントを示すユーティリティリクエストが含まれています。これらは、特定のアクションに関連する UUID と詳細を見つけるために使用できます。

例：GET https：//10.10.10.10/api/v3/actions

応答：LinkApiDTO オブジェクトの配列。各オブジェクトには、指定されたマーケット、エンティティ、またはグループのすべてのアクションを取得するための URL が含まれます。

{

"links":[

{

"rel":"Market actions", "href":"https://10.10.10.10/api/v3/markets/{uuid}/actions?ascending=true"

},

{

"rel":"Entity actions",

"href":"https://10.10.10.10/api/v3/entities/{uuid}/actions?ascending=false"

},

{

"rel":"Group actions", "href":"https://10.10.10.10/api/v3/groups/{uuid}/actions?ascending=true"

}

]

}

アクションリクエスト

アクションリクエストは、Workload Optimization Manager アプライアンスでのアクションの受け入れ、拒否、フィルタリング、および調査を処理します。

リクエストの範囲内の 1 つ以上のエンティティがトポロジに存在しなくなった場合、そのようなエンティティの ActionApiDTO には、エンティティに関する最小限の情報が含まれます。

指定されたアクションの取得

指定されたアクション UUID について、作成時刻とターゲット エンティティ情報を含むアクションの詳細を取得します。

例：GET https：//10.10.10.10/api/v3/actions/_6QsKkaNWEeiYWYj--U8W5g/details

応答：要求されたアクションの完全な ActionApiDTO：

{

"links":[

{

"rel":"self", "href":"https://10.10.10.10/api/v3/actions/_6QsKkaNWEeiYWYj--U8W5g"

},

{

"rel":"self", "href":"https://10.10.10.10/api/v3/actions/2218532354592"

}

],

"uuid":"_6QsKkaNWEeiYWYj--U8W5g", "createTime":"2018-08-19T07:40:57-04:00",

"actionType":"MOVE", "actionState":"PENDING_ACCEPT", "actionMode":"MANUAL",

"details":"Move VirtualMachine Jboss-EAP-10.203 from dc17-host-01.mycorp.com to dc17-host-02.mycor p.com",

"importance":7.4150376, "target":{

"uuid":"421d8db4-3fc6-440b-0575-11383c020c6c",

"displayName":"Jboss-EAP-10.203", "className":"VirtualMachine", "aspects":{

"virtualMachineAspect":{ "os":"CentOS 4/5/6/7 (64-bit)", "connectedNetworks":[

{

"uuid":"34f9f5364cd843aa1fe99900621ee3b51a7dc6e5",

"displayName":"VM Network"

}

],

"numVCPUs":2, "ebsOptimized":false

}

},

"environmentType":"ONPREM"

},

"currentEntity":{

"uuid":"34313836-3333-5553-4537-33364e385146",

"displayName":"dc17-host-01.mycorp.com", "className":"PhysicalMachine", "environmentType":"ONPREM"

},

"newEntity":{

"uuid":"34313836-3333-5553-4537-33394e43424e",

"displayName":"dc17-host-02.mycorp.com", "className":"PhysicalMachine", "environmentType":"ONPREM"

},

"risk":{

"uuid":"_CizZoKN2EeiYWYj--U8W5g", "subCategory":"Efficiency Improvement",

"description":"dc17-host-01.mycorp.com can be suspended for efficiency", "severity":"MINOR",

"importance":0

}, "actionID":2218532354592

}

アクションのフィルタリングされたリストの取得

範囲 UUID を指定し、次の 1 つ以上の条件を使用して ActionApiInputDTO によってフィルタリングされたアクションのリストを取得します。

次のコモディティは、アクションの関連コモディティとして返品できる。

■      アクセス

■      ActionPermit

■      ActiveSessions

■      ApplicationCommodity

■      バルーニング

■      Biclique

■      BufferCommodity

■      BurstBalance

■      CPU

■      CPUAllocation

■      CPUProvisioned

■      ClusterCommodity

■      CollectionTime

■      Connection

■      冷却

■      クーポン

■      CrossCloudMoveSvc

■      CrossClusterMoveSvc

■      DB キャッシュヒット率

■      DBMem

■      DISK_ARRAY_ACCESS

■      DSPMAccessCommodity

■      DataCenterCommodity

■      DatastoreCommodity

■      DrsSegmentationCommodity

■      Extent

■      フロー

■      FlowAllocation

■      HACommodity

■      HOST_LUN_ACCESS

■      ヒープ

■      ホットストレージ

■      IOThroughput

■      ImageCPU

■      ImageMem

■      ImageStorage

■      InstanceDiskSize

■      InstanceDiskType

■      LICENSE_ACCESS

■      LicenseCommodity

■      Mem

■      MemAllocation

■      MemProvisioned

■      Move

■      NetThroughput

■      NetworkCommodity

■      NetworkInterfaceCount

■      NetworkPolicy

■      NumDisk

■      NumberConsumers

■      NumberConsumersPM

■      NumberConsumersStorage

■      PORT_CHANNEL

■      PoolCPU

■      PoolMem

■      PoolStorage

■      電源

■      ProcessingUnits

■      Q1VCPU

■      Q2VCPU

■      Q3VCPU

■      Q4VCPU

■      Q5VCPU

■      Q6VCPU

■      Q7VCPU

■      Q8VCPU

■      Q16VCPU

■      Q32VCPU

■      Q64VCPU

■      QNVCPU

■      ResponseTime

■      RightSizeDown

■      RightSizeSVC

■      RightSizeUp

■      SLACommodity

■      SameClusterMoveSvc

■      SegmentationCommodity

■      ServiceLevelCluster

■      SoftwareLicenseCommodity

■      空白（スペース）

■      ストレージ

■      StorageAccess

■      StorageAllocation

■      StorageAmount

■      StorageClusterCommodity

■      StorageLatency

■      StorageProvisioned

■      スワッピング

■      TemplateAccess

■      TenancyAccess

■      スレッド

■      トランザクション

■      トランザクション ログ

■      不明

■      VAppAccess

■      VCPU

■      VCPULimitQuota

■      VCPURequest

■      VCPURequestQuota

■      VDCCommodity

■      VMPMAccessCommodity

■      VMem

■      VMemLimitQuota

■      VMemRequest

■      VMemRequestQuota

■      VStorage

■      ゾーン

例：POST https://10.10.10.10/api/v3/actions

入力例：この例では、次の条件を満たすアクションのリストが返され、アクションの actionMode によってグループ化される。

■      状態は PENDING_ACCEPT

■      オンプレミス環境の一部である

■      仮想マシンのアクションである

■      Workload Optimization Manager のリアルタイムマーケットによって生成されたアクション

{

"actionInput":{
"actionStateList":[

"PENDING_ACCEPT"

],

"environmentType":"ONPREM", "groupBy":[

"actionModes"

]

},

"relatedType":"VirtualMachine", "scopes":[

"Market"

]

}

応答：指定された条件を満たす ActionApiDTO のリスト。

指定されたアクションの承認または拒否

このリクエストは、指定された UUID のアクションを受け入れるか拒否し、次のパラメータを受け取る。

例：POST https://10.10.10.10/api/v3/actions/_QJCzNd3JEeij-LI4LMEROw?accept=false

応答：アクションが受け入れられた場合は true。

アクションのエンドポイントのヒント

GroupBy フィールド基準

POST リクエストを使用してアクションとアクション統計を照会する場合、統計をグループ化するために使用できる groupBy パラメータがあります。このパラメータの有効な値は、エンティティタイプによって異なります。エンティティごとの有効なオプションの完全なリストは次のとおりです：

注：

このフィールドを使用して inputDTO を送信する場合は、値のみが必要です。

例："groupBy": "vmsByPMName"

{

"VirtualMachine":{ "criteria":[

{

"filterType":"vmsByName"

},

{

"filterType":"vmsByPMName"

},

{

"filterType":"vmsByStorage"

},

{

"filterType":"vmsByNetwork"

},

{

"filterType":"vmsByApplication"

},

{

"filterType":"vmsByDatabaseServer"

},

{

"filterType":"vmsByDatabaseServerVersion"

},

{

"filterType":"vmsByDC"

},

{

"filterType":"vmsByVDC"

},

{

"filterType":"vmsByDCnested"

},

{

"filterType":"vmsByNumCPUs"

},

{

"filterType":"vmsByMem"

},

{

"filterType":"vmsByGuestName"

},

{

"filterType":"vmsByAltName"

},

{

"filterType":"vmsByClusterName"

},

{

"filterType":"vmsByDiskArrayName"

},

{

"filterType":"vmsByLogicalPoolName"

},

{

"filterType":"vmsByProfileName"

},

{

"filterType":"vmsByTag"

},

{

"filterType":"vmsByState"

},

{

"filterType":"vmsByBusinessAccountUuid"

},

{

"filterType":"vmsByResourceGroupUuid"

}

]

},

"VirtualDataCenter":{ "criteria":[

{

"filterType":"vdcsByName"

},

{

"filterType":"vdcsByVDCName"

},

{

"filterType":"vdcsByTag"

},

{

"filterType":"vdcsByState"

}

]

},

"VirtualMachine":{ "criteria":[

{

"filterType":"pmsByName"

},

{

"filterType":"pmsByStorage"

},

{

"filterType":"pmsByNetwork"

},

{

"filterType":"pmsBySwitch"

},

{

"filterType":"pmsByNumVms"

},

{

"filterType":"pmsByDC"

},

{

"filterType":"pmsByMem"

},

{

"filterType":"pmsByNumCPUs"

},

{

"filterType":"pmsByVendorName"

},

{

"filterType":"pmsByCPUModel"

},

{

"filterType":"pmsByModel"

},

{

"filterType":"pmsByTimezone"

},

{

"filterType":"pmsByClusterName"

},

{

"filterType":"pmsByTag"

},

{

"filterType":"pmsByState"

}

]

},

"Storage":{

"criteria":[

{

"filterType":"storageByName"

},

{

"filterType":"storageByTag"

},

{

"filterType":"storageByVMs"

},

{

"filterType":"storageByDC"

},

{

"filterType":"storageByPMCluster"

},

{

"filterType":"storageByState"

}

]

},

"Application":{
"criteria":[

{

"filterType":"appsByName"

},

{

"filterType":"appsByTag"

}

]

},

"ApplicationComponent":{ "criteria":[

{

"filterType":"appSrvsByName"

}

]

},

"WebServer":{

"criteria":[

{

"filterType":"wbSrvsByName"

}

]

},

"BusinessApplication":{ "criteria":[

{

"filterType":"busAppsByName"

}

]

},

"Database":{

"criteria":[

{

"filterType":"databaseByName"

},

{

"filterType":"databaseByTag"

},

{

"filterType":"databaseByBusinessAccountUuid"

},

{

"filterType":"databaseByResourceGroupUuid"

}

]

},

"DatabaseServer":{ "criteria":[

{

"filterType":"databaseServerByName"

},

{

"filterType":"databaseServerByTag"

},

{

"filterType":"databaseServerByBusinessAccountUuid"

},

{

"filterType":"databaseServerByEngine"

},

{

"filterType":"databaseServerByEdition"

},

{

"filterType":"databaseServerByVersion"

}

]

},

"VirtualApplication":{ "criteria":[

{

"filterType":"vappsByName"

}

]

},

"Cluster":{

"criteria":[

{

"filterType":"clustersByName"

},

{

"filterType":"clustersByTag"

}

]

},

"DataCenter":{ "criteria":[

{

"filterType":"datacentersByName"

},

{

"filterType":"datacentersByTag"

}

]

},

"Group":{

"criteria":[

{

"filterType":"groupsByName"

},

{

"filterType":"groupsByTargetName"

}

]

},

"StorageCluster":{
"criteria":[

{

"filterType":"storageClustersByName"

}

]

},

"DiskArray":{

"criteria":[

{

"filterType":"diskarrayByName"

}

]

},

"Zone":{

"criteria":[

{

"filterType":"zonsByName"

}

]

},

"Region":{

"criteria":[

{

"filterType":"regsByName"

}

]

},

"Network":{

"criteria":[

{

"filterType":"netsByName"

}

]

},

"LoadBalancer":{ "criteria":[

{

"filterType":"lbsByName"

}

]

},

"Chassis":{

"criteria":[

{

"filterType":"chasByName"

}

]

},

"IOModule":{

"criteria":[

{

"filterType":"ioModuleByName"

}

]

},

"StorageController":{
"criteria":[

{

"filterType":"storagecontrollerByName"

}

]

},

"DPod":{

"criteria":[

{

"filterType":"dpodByName"

}

]

},

"VPod":{

"criteria":[

{

"filterType":"vpodByName"

}

]

},

"LogicalPool":{
"基準":[

{

"filterType":"logicalPoolByName"

}

]

},

"Switch":{

"criteria":[

{

"filterType":"switchByName"

}

]

},

"Container":{

"criteria":[

{

"filterType":"containersByName"

},

{

"filterType":"containersByVMName"

}

]

},

"ContainerPod":{

"criteria":[

{

"filterType":"containerpodsByName"

},

{

"filterType":"containerpodsByVMName"

}

]

},

"ServiceEntity":{
"criteria":[

{

"filterType":"workloadByBusinessAccountUuid"

},

{

"filterType":"workloadByResourceGroupUuid"

}

]

},

"Workload":{

"criteria":[

{

"filterType":"workloadByBusinessAccountUuid"

},

{

"filterType":"workloadByResourceGroupUuid"

}

]

},

"ResourceGroup":{
"criteria":[

{

"filterType":"resourceGroupByName"

},

{

"filterType":"resourceGroupByUuid"

},

{

"filterType":"resourceGroupByBusinessAccountUuid"

},

{

"filterType":"resourceGroupByTag"

}

]

},

"BusinessAccount":{
"criteria":[

{

"filterType":"businessAccountByName"

},

{

"filterType":"businessAccountByUuid"

},

{

"filterType":"subBusinessAccountOfUuid"

},

{

"filterType":"businessAccountValidationStatus"

},

{

"filterType":"businessAccountTargetName"

},

{

"filterType":"businessAccountCloudProvider"

}

]

},

"BillingFamily":{
"criteria":[

{

"filterType":"billingFamilyByName"

}

]

},

"ViewPod":{

"criteria":[

{

"filterType":"viewPodByName"

}

]

},

"DesktopPool":{
"criteria":[

{

"filterType":"desktopPoolByName"

},

{

"filterType":"desktopPoolByViewPod"

}

]

},

"BusinessUser":{
"criteria":[

{

"filterType":"businessUserByName"

},

{

"filterType":"businessUserByDesktopPool"

}

]

}

}

管理エンドポイント

管理エンドポイントは、さまざまな管理機能を実行できるようにするリクエストのコレクションです。管理エンドポイントを使用するには、管理者ユーザーとして Workload Optimization Manager にログインする必要があります。

管理エンドポイントを使用すると、次のことができます。

■      環境で使用するために既存の構成ファイルをロードする

■      診断をローカルにエクスポートし、サポートに送信する

■      プロキシ設定を取得または設定する

■      環境のさまざまなコンポーネントのログ レベルを取得または設定する

■      現在の製品バージョン情報を取得する

■      更新を確認して、Workload Optimization Manager アプライアンスに適用する

管理者リクエスト

現在のバージョンの取得

インスタンスが実行している Workload Optimization Manager パッケージのバージョンを取得します。[check_for_updates] パラメータを true に設定して、利用可能なアップデートをさらにチェックします。

このリクエストは、次のパラメータを取ります：

例：GET https：//10.10.10.10/api/v3/admin/versions?check_for_updates=true

応答：現在のバージョンと利用可能な更新に関する詳細を説明する ProductVersionDTO。最新バージョンの Workload Optimization Manager を実行している場合、更新値は "No Updates Available\n" になります。

{

"versionInfo": "Turbonomic Operations Manager 6.1.7 (Build 20180813223950000)\nvmt-platfor m-6.1.7-20180813223950000.i586

...,

"updates": "Available Packages\nvmt-bundle.i586 6.2.0-20180817180112000 vmturbo\nvmt-config.x86_64

...,

"marketVersion": 2

}

診断のエクスポート

Workload Optimization Manager に問題が発生した場合は、サポートエンジニアが診断データのエクスポートを要求する場合があります。要求に応じて、データをエクスポートし、サポートエンジニアに送信することができます。

例：POST https://10.10.10.10/api/v3/admin/exports

応答：成功した場合は true、エクスポートの作成中にエラーが発生した場合は false。エクスポート ファイルは /tmp に保存されます。

インスタンス上のディレクトリに、bkp- で始まるファイル名を付けます。

外部構成ファイルのロード

一部の問題の診断に役立つように、サポートエンジニアが Workload Optimization Manager アプライアンスにコンフィギュレーション ファイルをロードするように求める場合があります。このリクエストは、プロセスをガイドするサポート エンジニアと協力している場合にのみ使用してください。サポート エンジニアは、必要なパラメータを使用して、ロードする構成ファイルの種類とそのファイルの内容を指定します。

例：POST https://10.10.10.10/api/v3/admin/configfiles?config_type=TOPOLOGY&topology=abc

応答：成功した場合は true、較正のアップロード中にエラーが発生した場合は false。

プロキシの取得と設定

プロキシの現在の状態とプロキシの詳細（有効な場合）を取得します。

例：GET https://10.10.10.10/api/v3/admin/httpproxy

応答：プロキシの詳細を記述する HttpProxyDTO。プロキシが設定されていない場合、このリクエストは

"isProxyEnabled"：false を返します。

{

"isProxyEnabled":true, "proxyHost":"10.10.111.1", "userName":"UserName", "password":"PW"

}

プロキシを設定するには、HttpProxyDTO を渡します。プロキシをすぐにアクティブにする場合は、必ず "isProxyEnabled"：true を含めます。

例：POST https://10.10.10.10/api/v3/admin/httpproxy

httpProxyDTO の例：

{

"isProxyEnabled":true, "proxyHost":"10.10.111.1", "portNumber":"33128", "userName":"ProxyUser", "password":"Password"

}

応答：成功した場合は true、プロキシの設定中にエラーが発生した場合は false。

コンポーネントごとのログ レベルの取得と設定

Workload Optimization Manager のプラットフォームのさまざまなコンポーネントに対して、ロギングのレベルを設定できます。すべてのコンポーネントで、デフォルトのロギングレベルは INFO です。ロギングのレベルを詳細にすればするほど、ログ ファイルの保存に必要なディスク領域が急激に増えることに注意してください。通常、これらの設定は、Workload Optimization Manager のサポートエンジニアとの作業中にのみ、変更するものです。

使用可能なログ レベルは（詳細度の低いものから順に）、INFO、WARN、DEBUG、および TRACE です。

例：GET https://10.10.10.10/api/v3/admin/logginglevels

応答：現在のログ レベル設定に関する詳細を含む LoggingApiDTO：

{

"componentLoggingLevel":{
"拡張機能"："INFO",

"Analysis":"INFO",

"Discovery":"INFO",

"API":"INFO",

"Presentation":"INFO", "Abstraction":"INFO", "Monitoring":"INFO"

}

}

特定のコンポーネントのログレベルを設定するには、コンポーネントとログレベルを含む部分的な LoggingApiDTO を渡します。

例：POST https://10.10.10.10/api/v3/admin/logginglevels

例：LoggingApiDTO：

{

"componentLoggingLevel":{
"Extension":"WARN"

}

}

応答：成功すると、応答本文で入力を返します。

ビジネスユニットのエンドポイント

ビジネスユニットは、パブリッククラウド ターゲットのアカウントとサブスクリプションのモデル化、およびクラウドの予算と価格調整のために使用されるコンテナオブジェクトです。

Workload Optimization Manager API の businessunits エンドポイントを使用すると、次のことができます。

■      指定されたビジネスユニットについて、次のリストを取得します。

–      ビジネスユニット内のエンティティに関連するすべてのアクション

–      クラウドサービスと料金モデル

–      ビジネスユニットに属するすべてのエンティティ

–      価格調整

–      関連する（親、兄弟、または子の）ビジネスユニット

–      ビジネスユニット内のエンティティに関する統計

–      テンプレートは以下で使用できます。

■      指定されたビジネスユニットのサプライチェーンの取得

■      ビジネスユニットの作成

■      ビジネスユニットの編集

■      価格調整の編集

■      ビジネスユニットの削除

ビジネスユニットは、次に説明する 3 つのタイプのいずれかです：

ビジネスユニットのリクエスト

ビジネスユニットの取得

Workload Optimization Manager インスタンスで作成または検出されたすべてのビジネスユニットのリストを取得します。このリクエストは、次のパラメータを取ります：

例：GET https://10.10.10.10/api/v3/businessunits?type=DISCOVERED&cloud_type=AWS

応答：選択された条件を満たす BusinessUnitApiDTO のリスト。この場合は、検出された、AWS 環境の一部であるビジネスユニット。

[

{

"uuid": "323871187550",

"displayName": "Product Trust", "className": "BusinessAccount", "environmentType": "CLOUD", "master": false, "hasRelatedTarget": true, "budget": {

"value": 0

},

"businessUnitType": "DISCOVERED", "cloudType": "AWS",

"targets": [

{

"uuid": "_6glgQEEhEemQ645gSx8RYw", "displayName": "PT-AWS",

"type": "AWS"

}

],

"costPrice": 0, "severity": "Critical", "membersCount": 80, "memberType": "Workload", "related": {

"rateCard": null, "priceAdjustment": null

},

"resourceGroupsCount": 0

},

{

"uuid": "001844731978",

"displayName": "Advanced Engineering", "className": "BusinessAccount", "environmentType": "CLOUD",

"master": false, "hasRelatedTarget": false, "budget": {

"value": 0

},

"businessUnitType": "DISCOVERED", "cloudType": "AWS",

"costPrice": 0, "severity": "Normal", "membersCount": 0, "memberType": "Workload", "related": {

"rateCard": null, "priceAdjustment": null

},

"resourceGroupsCount": 0

},

{

"uuid": "192821421245",

"displayName": "Development", "className": "BusinessAccount", "environmentType": "CLOUD", "master": true, "hasRelatedTarget": true, "budget": {

"value": 0

},

"businessUnitType": "DISCOVERED", "cloudType": "AWS", "childrenBusinessUnits": [

"631949720430",

"001844731978",

"323871187550"

],

"targets": [

{

"uuid": "_cBVj0MvWEeiFJej-UwMSGg", "displayName": "engineering.aws.amazon.com", "type": "AWS"

}

],

"costPrice": 0, "severity": "Critical", "membersCount": 80, "memberType": "Workload", "related": {

"rateCard": null, "priceAdjustment": null

},

"resourceGroupsCount": 0

},

{

"uuid": "631949720430",

"displayName": "Turbonomic SaaS",

"className": "BusinessAccount", "environmentType": "CLOUD", "master": false, "hasRelatedTarget": false, "budget": {

"value": 0

},

"businessUnitType": "DISCOVERED", "cloudType": "AWS",

"costPrice": 0, "severity": "Normal", "membersCount": 0, "memberType": "Workload", "related": {

"rateCard": null, "priceAdjustment": null

},

"resourceGroupsCount": 0

}

]

ビジネスユニットの削除

ビジネスユニットを削除するには、リクエストでビジネスユニットの UUID を渡します。DISCOVERED ビジネスユニットは削除できないことに注意してください。

例：DELETE https://10.10.10.10/api/v3/ businessunits/49d50ac3f8adbfe649d53e72c42dd9428d1d3835

応答：コード 200 の応答は、正常に削除されたことを示します。

指定されたビジネスユニットのクラウドサービスと価格設定モデルのペアを取得する

各クラウドサービスのクラウドサービス名と価格モデルを取得します。

例：GET https://10.10.10.10/api/v3/businessunits/192821421245/cloudservices

応答：ビジネス ユニットが利用できる各クラウド サービスを表す CloudServicePricingModelApiDTO のリスト：

[

{

"uuid": "aws::631949720430::CS::AWSCloudTrail", "displayName": "AWS CloudTrail", "pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::631949720430::CS::AmazonCloudWatch", "displayName": "AWS CloudWatch",

"pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::192821421245::CS::AWSDeveloperSupport", "displayName": "AWS Developer Support", "pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::001844731978::CS::AmazonDynamoDB", "displayName": "AWS DynamoDB",

"pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::631949720430::CS::AmazonEC2",

"displayName": "AWS EC2", "pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::001844731978::CS::AmazonEKS",

"displayName": "AWS EKS", "pricingModel": "ON_DEMAND"

},

...

]

指定されたビジネスユニットに関連する価格調整の取得

指定されたビジネスユニットに影響する価格調整を取得します。

例：GET https://10.10.10.10/api/v3/businessunits/192821421245/priceadjustments

応答：調整後の修正された価格を示す BusinessUnitPriceAdjustmentApiDTO のリスト：

[

{

"servicePriceAdjustments": [

{

"uuid": "aws::192821421245::CS::AmazonCloudWatch", "displayName": "AWS CloudWatch",

"pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::192821421245::CS::AWSDeveloperSupport", "displayName": "AWS Developer Support", "pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::192821421245::CS::AmazonDynamoDB", "displayName": "AWS DynamoDB",

"pricingModel": "ON_DEMAND"

},

{

"uuid": "aws::192821421245::CS::AmazonEC2",

"displayName": "AWS EC2", "pricingModel": "ON_DEMAND", "templateDiscounts": [

{

"uuid": "aws::VMPROFILE::g3.16xlarge", "displayName": "g3.16xlarge", "family": "g3",

"pricesPerDatacenter": [

{

"uuid": "aws::ap-southeast-1::DC::ap-southeast-1", "displayName": "aws-Asia Pacific (Singapore)", "price": 6.68

},

{

"uuid": "aws::us-west-2::DC::us-west-2", "displayName": "aws-US West (Oregon)", "price": 4.56

},

{

"uuid": "aws::ca-central-1::DC::ca-central-1", "displayName": "aws-Canada (Central)", "price": 5.664

},

{

"uuid": "aws::eu-west-1::DC::eu-west-1", "displayName": "aws-EU (Ireland)", "price": 4.84

},

{

"uuid": "aws::eu-west-3::DC::eu-west-3", "displayName": "aws-EU (パリ)", "price": 0

},

{

"uuid": "aws::ap-northeast-1::DC::ap-northeast-1", "displayName": "aws-Asia Pacific (Tokyo)", "price": 6.32

},

{

"uuid": "aws::eu-central-1::DC::eu-central-1", "displayName": "aws-EU (Frankfurt)",

"price": 5.7

},

{

"uuid": "aws::ap-south-1::DC::ap-south-1", "displayName": "aws-Asia Pacific (Mumbai)", "price": 0

},

{

"uuid": "aws::ap-northeast-2::DC::ap-northeast-2", "displayName": "aws-Asia Pacific (Seoul)", "price": 0

},

{

"uuid": "aws::us-east-1::DC::us-east-1", "displayName": "aws-US East (N. Virginia)", "price": 4.56

},

{

"uuid": "aws::us-west-1::DC::us-west-1", "displayName": "aws-US West (N. California)", "price": 6.136

},

{

"uuid": "aws::sa-east-1::DC::sa-east-1", "displayName": "aws-South America (Sao Paulo)", "price": 0

},

{

"uuid": "aws::ap-southeast-2::DC::ap-southeast-2", "displayName": "aws-Asia Pacific (Sydney)", "price": 7.016

},

{

"uuid": "aws::us-east-2::DC::us-east-2", "displayName": "aws-US East (Ohio)", "price": 4.56

},

{

"uuid": "aws::eu-north-1::DC::eu-north-1", "displayName": "aws-EU (Stockholm)", "price": 0

},

{

"uuid": "aws::eu-west-2::DC::eu-west-2", "displayName": "aws-EU (London)", "price": 0

}

]

},

{

"uuid": "aws::VMPROFILE::p3.8xlarge", "displayName": "p3.8xlarge", "family": "p3", "pricesPerDatacenter": [

{

"uuid": "aws::ap-southeast-1::DC::ap-southeast-1", "displayName": "aws-Asia Pacific (Singapore)", "price": 16.936

},

{

"uuid": "aws::us-west-2::DC::us-west-2", "displayName": "aws-US West (Oregon)", "price": 12.24

},

{

"uuid": "aws::ca-central-1::DC::ca-central-1", "displayName": "aws-Canada (Central)", "price": 13.464

},

{

"uuid": "aws::eu-west-1::DC::eu-west-1", "displayName": "aws-EU (Ireland)", "price": 13.22

},

{

"uuid": "aws::eu-west-3::DC::eu-west-3",

"displayName": "aws-EU (Paris)", "price": 0

},

{

"uuid": "aws::ap-northeast-1::DC::ap-northeast-1", "displayName": "aws-Asia Pacific (Tokyo)", "price": 6.32

},

{

"uuid": "aws::eu-central-1::DC::eu-central-1", "displayName": "aws-EU (Frankfurt)",

"price": 15.292

},

{

"uuid": "aws::ap-south-1::DC::ap-south-1", "displayName": "aws-Asia Pacific (Mumbai)", "price": 0

},

{

"uuid": "aws::ap-northeast-2::DC::ap-northeast-2", "displayName": "aws-Asia Pacific (Seoul)", "price": 16.936

},

...

]

}

]

}

]

}

]

指定されたビジネスユニットの価格調整の編集

指定されたビジネスユニットの価格調整を編集するには、BusinessUnitPriceAdjustmentApiDTO に修正された情報を送信します（この例では、割引率を 25 から 50 に変更します）。

例：PUT https://10.10.10.10/api/v3/businessunits/ c0acb428d7b447a5d51f9888d2b6660b5fa5225f

入力例：

{

"name": "Daltest1", "priceAdjustment": {

"type": "DISCOUNT",

"value": 50

},

"childrenBusinessUnits": [ "192821421245"

],

"businessUnitType": "DISCOUNT",

"uuid": "c0acb428d7b447a5d51f9888d2b6660b5fa5225f"

}

応答：修正された値を含む完全な BusinessUnitPriceAdjustmentApiDTO：

{

"uuid": "c0acb428d7b447a5d51f9888d2b6660b5fa5225f", "displayName": "Daltest1",

"className": "BusinessAccount", "environmentType": "CLOUD", "discount": 50, "priceAdjustment": {

"type": "DISCOUNT",

"value": 50

},

"master": false, "hasRelatedTarget": false, "budget": {

"value": 0

},

"businessUnitType": "DISCOUNT", "cloudType": "AWS", "childrenBusinessUnits": [

"192821421245"

],

"costPrice": 0, "severity": "Normal", "membersCount": 0, "memberType": "Workload", "related": {

"rateCard": null, "priceAdjustment": {

"uuid": "c0acb428d7b447a5d51f9888d2b6660b5fa5225f", "displayName": "Daltest1",

"className": "BusinessAccount"

}

},

"resourceGroupsCount": 0

}

ビジネスユニットが利用できるテンプレートの取得

参照エンドポイント：テンプレート（271ページ）

指定されたビジネスユニットで使用可能な各テンプレートに関する詳細を取得します。

例：GET https://10.10.10.10/api/v3/businessunits/192821421245/templates

応答：指定されたビジネス ユニットで使用可能なテンプレートを表す TemplateApiDTO のリスト：

[

{

"links": [

{

"rel": "self",

"href": "https：//10.10.10.10/api/v3/templates/B4166E9F-589B-357D-AC74-0A534B53CE85"

}

],

"uuid": "B4166E9F-589B-357D-AC74-0A534B53CE85",

"displayName": "db.x1e.32xlarge", "className": "DatabaseServerProfile", "price": 0,

"model": "db.x1e.32xlarge", "dbEngine": "Oracle", "dbEdition": "Enterprise", "computeResources": [

{

"stats": [

{

"name": "numOfCpu", "value": 128

},

{

"name": "cpuSpeed",

"units": "MHz", "value": 384000

},

{

"name": "ioThroughputSize", "units": "MB/s",

"value": 546.875

},

{

"name": "memorySize", "units": "MB", "value": 3997696

}

]

}

],

"storageResources": [

{

"stats": [

{

"name": "diskSize",

"units": "GB", "value": 3840

},

{

"name": "diskIops", "value": 35000

}

]

}

],

"deploymentProfile": {

"uuid": "5C57DCA5-72AB-34BF-A22D-06719D13182E",

"displayName": "DEP-RDB-'ap-northeast-1'", "className": "ServiceCatalogItem",

"deployParameters": [

{

"targetType": "AWS", "providers": [

{

"provider": { "discoveredBy": {

"uuid": "_RRn00PMSEeisB7K_chUWVw", "displayName": "vmturbodev.aws.amazon.com", "type": "AWS"

}

}

}

]

}

]

},

"discovered": true

},

{

"links": [

{

"rel": "self",

"href": "https://10.10.10.10/api/v3/templates/aws::VMPROFILE::g3.16xlarge"

}

],

"uuid": "aws::VMPROFILE::g3.16xlarge", "displayName": "g3.16xlarge", "className": "VirtualMachineProfile", "description": "g3.16xlarge", "computeResources": [

{

"stats": [

{

"name": "ioThroughputSize", "units": "MB/s",

"value": 1750

},

{

"name": "networkThroughputSize", "units": "MB/s",

"value": 2500

},

{

"name"： "numOfCpu", "value"： 64

},

{

"name": "cpuSpeed",

"units": "MHz", "value": 6664.6587

},

{

"name": "cpuConsumedFactor",

"units": "%", "value": 50

},

{

"name": "memorySize", "units": "MB", "value": 499712

},

{

"name": "memoryConsumedFactor", "units": "%",

"value": 75

},

{

"name": "ioThroughput", "units": "MB/s", "value": 0

},

{

"name": "networkThroughput", "units": "MB/s",

"value": 0

}

]

}

],

"storageResources": [