Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos para la API de CA AppLogic › Objeto util › Método wincfg_comp_name (objeto util)

Método wincfg_comp_name (objeto util)

Descripción

Cambiar el nombre del equipo de un dispositivo de Windows

Sintaxis

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

Argumentos

app

Nombre de la aplicación

comp

Nombre del componente de Windows

comp_name

Nuevo nombre del equipo

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Cambiar nombre del equipo para 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 

Ejemplo de salida

XML:

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

JSON:

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

Códigos de error de HTTP

404

Entidad mygrid de vdc no encontrada: se ha especificado un nombre de VDC que no está configurado en la aplicación WS_API.

400.4

Faltan argumentos obligatorios (component): falta el argumento comp=componente en la solicitud.

400.4

Faltan argumentos obligatorios (app): falta el argumento app=app en la solicitud.

400.4

Faltan argumentos obligatorios (comp_name): falta el argumento name=component en la solicitud.

Nota: Para obtener el estado de la tarea, envíe una solicitud /api/v1/job/info? con el job_id devuelto anteriormente como argumento. Para obtener más información sobre cómo obtener el estado de la tarea, consulte el objeto job.