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

image2class-Methode (util-Objekt)

Description

Virtuelle Computer-Images als AppLogic-Appliance-Klassen importieren.

Syntax

/api/v2/util/image2class?class=class&image=image&vdc=controller-name 

Argument

Klasse

Der Name der AppLogic-Appliance-Klasse, die erstellt werden soll.

image

Das zu importierende Image oder Volume.

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Ein OVA-Image aus dem impex-Volume des Grid als nicht verwaltete Singleton-Klasse importieren.

 GET
http://192.168.123.200/api/v2/util/image2class?class=myapp:TOMCAT&image=tomcat.ova&unmanaged&vdc=mygrid

Ein OVA-Image aus einer URL importieren, dabei eine verwaltete Katalogklasse erstellen und die im .ovf-Deskriptor angegebenen Ressourcen aufheben.

GET
http://192.168.123.200/api/v2/util/image2class?class=/proto:TOMCAT&image=http%3A%2F%2Fexample.com%2Ftomcat.ova&user=user&pwd=password&managed&cpu=2&mem=512M&os=linux&vdc=mygrid

Ein Upgrade für eine verwaltete Katalogklasse durchführen; dabei deren Volumes durch diejenigen eines OVA-Images ersetzen

GET
http://192.168.123.200/api/v2/util/image2class?class=/proto:TOMCAT&image=tomcat.ova&upgrade&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 (class).

- Argument class=class nicht vorhanden.

Erforderliche Argumente fehlen (image).

- Argument image=image nicht vorhanden.

Hinweise

Dieses Objekt kann erst verwendet werden, nachdem das Grid mithilfe des appstore_bind-Objekts an den Marketplace gebunden worden ist.

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.