lock メソッド（template オブジェクト）

説明

アプリケーションテンプレートをロックします。

構文

/api/v1/template/lock?template=template&pwd=password&vdc=controller-name

引数

トランザクションタイプ

同期

リクエストタイプ

GET

例

アプリケーションテンプレート VDS_CentOS51_r15 をロックします。

GET http://192.168.123.200/api/v1/template/lock?template=VDS_CentOS51_r15&pwd=password&vdc=mygrid

サンプル出力

XML

<opt></opt>

JSON

{}

メモ

JSON の出力はすべて UTF8 にエンコードされています。 UTF8 デコードを使用して UTF8 にエンコードされた出力をデコードします。

UTF8 にエンコードされた JSON 出力をデコードするシンプルな PHP スクリプトの例を以下に示します。

<? 
$json = '{"a": "¥u00e3¥u0081¥u0082" }'; 
$j = json_decode($json); 
echo utf8_decode($j->{'a'}); 
?>

HTTP エラーコード

404: エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。
400.4: 必要な引数（template）がありません。リクエストに引数 template=template がありません。
400.4: 必要な引数（pwd）がありません。リクエストに引数 password=password がありません。
500.2: リクエストの処理に失敗しました。アプリケーション VDS_CentOS_r1 が存在しません。リクエストで指定されたテンプレートが VDC に存在しません。
500.2: リクエストの処理に失敗しました。アプリケーション VDS_CentOS54_r1 をロックできませんでした。アクセスが拒否されました。アプリケーションをロックするには pwd 引数が必要です。リクエストでパスワード引数が正しく指定されていません。

メモ: アプリケーションをロック解除するには、テンプレートアプリケーションをロックするために使用したパスワードが必要です。テンプレートアプリケーションがロックされた場合、アプリケーションに属するボリュームは管理の対象とならないため、アプリケーションは変更されません。