統合ガイド › Web サービス API リファレンス ガイド › CA AppLogic API の有効なオブジェクト › util オブジェクト › image2class メソッド（util オブジェクト）

image2class メソッド（util オブジェクト）

説明

仮想マシン イメージを AppLogic アプライアンス クラスとしてインポートします。

構文

/api/v1/util/image2class?class=class&image=image&vdc=controller-name 

引数

class

作成される AppLogic アプライアンス クラスの名前

image

インポートするイメージまたはボリューム

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

グリッドの impex ボリュームから OVA イメージを管理対象外シングルトン クラスとしてインポートします

 GET
http://192.168.123.200/api/v1/util/image2class?class=myapp:TOMCAT&image=tomcat.ova&unmanaged&vdc=mygrid

URL から OVA イメージをインポートし、管理対象カタログ クラスを作成して、.ovf 記述子に指定されたリソースより優先させます

GET
http://192.168.123.200/api/v1/util/image2class?class=/proto:TOMCAT&image=http%3A%2F%2Fexample.com%2Ftomcat.ova&user=user&pwd=password&managed&cpu=2&mem=512M&os=linux&vdc=mygrid

管理対象カタログ クラスのボリュームを OVA イメージからのボリュームで置き換えることによってアップグレードします。

GET
http://192.168.123.200/api/v1/util/image2class?class=/proto:TOMCAT&image=tomcat.ova&upgrade&vdc=mygrid

サンプル出力

JSON：

{
   "job" : "3f8c7462-eab5-48e7-94c1-ed5fc5b9cb97"
}

XML：

<job>358fd142-acba-42b2-bfde-d7deb0ebe03e</job>

HTTP エラー コード

404

エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。

400.4

必要な引数（class）がありません

- 引数 class=class がありません

必要な引数（image）がありません

- 引数 image=image がありません

ノート

このオブジェクトを使用する前に、appstore_bind オブジェクトを使用して、グリッドを Marketplace にバインドします。

ジョブのステータスを取得するには、/api/v1/job/info? リクエストを発行し、上で返された job_id を引数に指定します。 ジョブ ステータスを取得する方法の詳細については、job オブジェクトを参照してください。