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

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

説明

Windows アプライアンスのコンピュータ名を変更します。

構文

/api/v1/util/wincfg_passwd?app=application&comp=component&comp_name=new-name&vdc=controller-name 

引数

application

アプリケーションの名前

component

Windows コンポーネントの名前

new-name

新しいコンピュータ名

controller-name

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

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

test:main.WIN03S のコンピュータ名を変更します。

GET http://192.168.123.200/api/v1/util/wincfg_comp_name?app=test&comp=main.WIN03S&comp_name=WIN03TST&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

必要な引数（component）がありません。リクエストに引数 comp=component がありません。

400.4

必要な引数（app）がありません。リクエストに引数 app=app がありません。

400.4

必要な引数（comp_name）がありません。リクエストに引数 comp_name=component がありません。

メモ

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