集成指南 › Web 服务 API 参考指南 › 有效对象 › util 对象 › wincfg_comp_name 方法（util 对象）

wincfg_comp_name 方法（util 对象）

说明

更改 Windows 组件的计算机名

语法

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

参数

app

应用的名称

comp

Windows 组件的名称

comp_name

新计算机名

vdc

目标虚拟数据中心的名称

事务类型

异步

请求类型

GET

示例

更改 test:main.WIN03S 的计算机名。

GET http://192.168.123.200/api/v2/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"
} 

HTTP 错误代码

404

未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。

400.4

缺少必需参数 (component)。 －请求中缺少参数 comp=component。

400.4

缺少必需参数 (app)。 －请求中缺少参数 app=app。

400.4

缺少必需参数 (comp_name)。 －请求中缺少参数 comp_name=component。

注意：要获取作业的状态，请以上面返回的 job_id 作为参数发出 /api/v2/job/info? 请求。 有关如何获取作业状态的详细信息，请参考作业对象。