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

Méthode identify (objet srv)

Description

Identifie le serveur et les NIC en faisant clignoter la diode électroluminescente d'un contrôleur NIC spécifique sur le serveur pendant une minute.

Syntaxe

/api/v2/srv/identify?srv=server&nic=nic&vdc=nom_contrôleur 

Arguments

serveur

Nom du serveur

NIC

Nom du NIC donc la diode doit clignoter

vdc

Nom du centre de données virtuel cible

Type de transaction

Asynchrone

Type de requête

GET

Exemples

Pour faire clignoter la diode du NIC eth0 sur le serveur srv1 :

GET http://192.168.123.200/api/v2/srv/identify?srv=srv1&nic=eth0&vdc=mygrid 

Exemple de sortie

XML

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

JSON

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

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

Missing required arguments (srv,nic) - Les argument srv=serveur et nic=NIC sont manquants.

400.4

Missing required arguments (srv) - L'argument srv=serveur est manquant.

400.4

Missing required arguments (nic) - L'argument nic=NIC est manquant.

Notes

Pour obtenir le statut du job, exécutez une requête /api/v2/job/info en spécifiant l'ID de job renvoyé précédemment comme argument. Pour plus d'informations sur la manière d'obtenir le statut du job, reportez-vous à l'objet job.