前のトピック: disable メソッド(srv オブジェクト)

次のトピック: power_on メソッド(srv オブジェクト)

set メソッド(srv オブジェクト)

説明

グリッド内のサーバの役割を設定し、コントローラの高可用性を設定します。

構文
/api/v1/srv/set?srv=srv&role=role&vdc=controller-name 
引数
srv

サーバの名前

role

サーバの HA 役割。 「プライマリ」、「セカンダリ」または「なし」にすることができます。

controller-name

ターゲットの仮想データ センターの名前

トランザクション タイプ

同期

リクエスト タイプ

GET

srv1 の役割をセカンダリに設定します。

GET http://192.168.123.200/api/v1/srv/set?srv=srv1&role=secondary&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

必要な引数(role)がありません。 引数 role=ha-role が指定されませんでした。

400.4

必要な引数(srv)がありません。 引数 srv=srv-name が指定されませんでした。

500.2

リクエストの処理に失敗しました。サポートされていない引数「unknown」が指定されています。