CA 3Tera AppLogic API の有効なオブジェクト › srv オブジェクト › list メソッド（srv オブジェクト）

list メソッド（srv オブジェクト）

説明

サーバのリストを表示します。

構文

/api/v1/srv/list?vdc=controller-name 

引数

controller-name

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例

サーバを一覧表示します。

GET http://192.168.123.200/api/v1/srv/list?vdc=mygrid 

サンプル出力

XML

<servers>
   <server>
      <name>srv1</name>
      <bw_alloc>350000000</bw_alloc>
      <bw_free>1650000000</bw_free>
      <cpu_alloc>0.55</cpu_alloc>
      <cpu_free>1.35</cpu_free>
      <enabled>1</enabled>
      <mem_alloc>738197504</mem_alloc>
      <mem_free>11534336</mem_free>
      <role>primary</role>
       <state>up</state>
   </server>
   <server>
      <name>srv2</name>
      <bw_alloc>900000000</bw_alloc>
      <bw_free>1100000000</bw_free>
      <cpu_alloc>1.10</cpu_alloc>
      <cpu_free>0.90</cpu_free>
      <enabled>1</enabled>
      <mem_alloc>1476395008</mem_alloc>
      <mem_free>78643200</mem_free>
      <role>secondary</role>
      <state>up</state>
   </server>
   .
   .
   .
</servers>

JSON

{
   "server" : [
      {
          "name" : "srv1",
         "cpu_free" : "1.35",
         "state" : "up",
         "bw_free" : "1650000000",
         "cpu_alloc" : "0.55",
         "mem_alloc" : "738197504",
         "mem_free" : "11534336",
         "role" : "primary",
         "bw_alloc" : "350000000",
         "enabled" : "1"
      },
       {
         "name" : "srv2",
         "cpu_free" : "0.90",
         "state" : "up",
         "bw_free" : "1100000000",
         "cpu_alloc" : "1.10",
         "mem_free" : "78643200",
         "mem_alloc" : "1476395008",
         "role" : "secondary",
         "bw_alloc" : "900000000",
         "enabled" : "1"
      },
      .
      .
      .
   ]
} 

メモ

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 名が指定されました。