Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › util-Objekt › wincfg-Methode (util-Objekt)

wincfg-Methode (util-Objekt)

Description

Wenden Sie die angeforderten Änderungen auf die Windows-Appliance an.

Syntax

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

Argument

app

Name der Anwendung

comp

Name der Windows-Komponente

pwd

Marktplatz-Benutzerkennwort

vdc

Name des virtuellen Rechenzentrums (Virtual Data Center), welches das Ziel darstellt

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Administratorkennwort einer Windows-basierten Appliance ändern.

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

Computername einer Windows-basierten Appliance ändern.

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

Beispielausgabe

JSON:

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

XML:

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

HTTP-Fehlercodes

404

Entität vdc mygrid nicht gefunden - Es wurde ein VDC-Name angegeben, der in der WS_API-Anwendung nicht konfiguriert worden ist.

400.4

Erforderliche Argumente fehlen (app).

- Argument app=app nicht vorhanden.

Erforderliche Argumente fehlen (comp).

- Argument app=app nicht vorhanden.

Hinweise

Diese API ist verfügbar mit WS_API_r6-1.0.6-1 und höher.

Um den Jobstatus abzurufen, geben Sie folgenden Befehl ein: /api/v2/job/info? Anfrage mit job_id gab das Argument oben zurück. Weitere Informationen zum Abrufen des Jobstatus finden Sie im Abschnitt zum Job-Objekt.