Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto util › Metodo wincfg_comp_name (oggetto util)

Metodo wincfg_comp_name (oggetto util)

Description

Cambia il nome del computer di un'appliance Windows

Sintassi

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

Argomenti

app

Nome dell'applicazione

comp

Nome del componente Windows

comp_name

Nuovo nome del computer

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Modifica del nome del computer per 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 

Output di esempio

XML:

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

JSON:

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

Codici di errore HTTP

404

Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

400.4

Argomenti necessari mancanti (component). - Argomento comp=component mancante nella richiesta.

400.4

Argomenti necessari mancanti (app). - Argomento app=app mancante nella richiesta.

400.4

Argomenti necessari mancanti (comp_name). - Argomento comp_name=component mancante nella richiesta.

Nota: per visualizzare lo stato del processo, inviare una richiesta /api/v2/job/info? con il job_id restituito sopra come argomento. Per ulteriori informazioni su come ottenere lo stato del processo, fare riferimento all'oggetto job.