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

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

説明

Windows アプライアンスの管理者パスワードを変更します。

構文

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

引数

application

アプリケーションの名前

component

Windows コンポーネントの名前

passwd

新しい管理者パスワード

controller-name

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

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

test:main.WIN03S のパスワードを変更します。

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

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

メモ

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