Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides › objet util › Méthode wincfg (objet util)

Méthode wincfg (objet util)

Description

Applique les modifications demandées à l'appliance Windows.

Syntaxe

/api/v2/util/wincfg?app=application&comp=composant&vdc=nom_contrôleur 

Arguments

app

Nom de l'application

comp

Nom du composant Windows

pwd

Mot de passe de l'utilisateur du marché

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Modifier le mot de passe administrateur d'une appliance Windows

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

Modifier le nom d'ordinateur d'une appliance Windows

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

Exemple de sortie

JSON

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

XML

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

Codes d'erreur HTTP

404

L'entité vdc mygrid est introuvable - Le nom de VDC spécifié n'est pas configuré dans l'application WS_API.

400.4

Arguments requis manquants (app)

- Argument app=app manquant

Missing required arguments (comp)

- Argument app=app manquant

Notes

Cette API est disponible avec WS_API_r6-1.0.6-1 et supérieur.

Pour obtenir le statut du job, exécutez une requête /api/v2/job/info? avec comme argument le job_id renvoyé plus haut. Pour plus d'informations sur la manière d'obtenir le statut du job, reportez-vous à l'objet job.