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

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

説明

サーバ上の指定した NIC の LED を 1 分間点滅させることにより、サーバおよび NIC を識別します。

構文

/api/v1/srv/identify?srv=server&nic=nic&vdc=controller-name 

引数

server

サーバの名前

nic

点滅させる NIC の名前

controller-name

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

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

srv1 上で eth0 を点滅させます。

GET http://192.168.123.200/api/v1/srv/identify?srv=srv1&nic=eth0&vdc=mygrid 

サンプル出力

XML

<job>be805915-76b2-48c8-b8a0-b881cca66da6</job> 

JSON

{
   "job" : "be805915-76b2-48c8-b8a0-b881cca66da6"
}

メモ

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

必要な引数（srv、nic）がありません。引数 srv=srv および nic=nic がありません。

400.4

必要な引数（srv）がありません。引数 srv=srv がありません。

400.4

必要な引数（nic）がありません。引数 nic=nic がありません。

メモ

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