identify Method (srv Object)

Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › srv-Objekt › identify Method (srv Object)

identify Method (srv Object)

Description

Identifizieren Sie Server und NICs, indem Sie das LED des angegebenen NIC auf dem Server eine Minute lang blinken lassen.

Syntax

/api/v2/srv/identify?srv=server&nic=nic&vdc=controller-name

Argument

Server: Name des Servers
nic: Name des NIC, der aufblinken soll
vdc: Name des virtuellen Rechenzentrums (Virtual Data Center), welches das Ziel darstellt

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

eth0 auf srv1 blinken.

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

Beispielausgabe

XML:

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

JSON:

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

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(srv,nic) - Argumente srv=srv und nic=nic fehlen
400.4: Erforderliche Argumente fehlen (srv) - Argument srv=srv fehlt
400.4: Erforderliche Argumente fehlen (nic) - Argument nic=nic fehlt

Hinweise

Geben Sie zum Abrufen des Jobstatus eine Anfrage "/api/v2/job/info" aus, wobei die oben zurückgegebene "job_id" als Argument verwendet wird. Weitere Informationen zum Abrufen des Jobstatus finden Sie im Abschnitt zum Job-Objekt.