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 (Objeto util)

Método wincfg (Objeto util)

Descripción

Aplica los cambios solicitados al dispositivo de Windows.

Sintaxis

/api/v1/util/wincfg?app=application&comp=component&vdc=controller-name 

Argumentos

app

Nombre de la aplicación

comp

Nombre del componente de Windows

pwd

Contraseña de usuario de Marketplace

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Cambie la contraseña de administrador de un dispositivo basado en Windows.

GET
http://192.168.123.200/api/v1/util/wincfg?app=WINAPP&component=main.WIN08S&admin_pw=password&vdc=mygrid

Cambie el nombre del equipo de un dispositivo basado en Windows.

GET
http://192.168.123.200/api/v1/util/wincfg?app=WINAPP&component=main.WIN08S&computer_name=WINTST&vdc=mygrid
 

Ejemplo de salida

JSON:

{
   "job" : "3f8c7462-eab5-48e7-94c1-ed5fc5b9cb97"
}

XML:

<job>358fd142-acba-42b2-bfde-d7deb0ebe03e</job>
 

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 (app)

- Falta el argumento app=app

Faltan argumentos obligatorios (comp)

- Falta el argumento app=app

Notes

Esta API está disponible con WS_API_r6-1.0.6-1 y superior.

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.