Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › vol-Objekt › export-Methode (vol-Objekt)

export-Methode (vol-Objekt)

Description

Exportieren eines Volumes in eine Containerdatei auf /vol/_impex/

Syntax

/api/v2/vol/export?app=application&vol=volume&target=filename.img.gz&vdc=controller-name 

Argument

app

Name der Anwendung oder des Volumes, die bzw. das die Domäne hostet

vol

Name des Volumes

target

Name der Containerdatei, in die das Volume exportiert werden soll.

Erstellt die Datei am Stamm des Import-/Export-Volumes des Grid: /vol/_impex/ - Optional kann die Datei mithilfe von "gzip" komprimiert werden (bei Angabe von .gz als Erweiterung des Dateinamens)

vdc

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

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Exportieren des Volumes "test1:vol1" zur komprimierten Containerdatei "/vol/_impex/test.img.gz".

GET http://192.168.123.200/api/v2/vol/export?app=test1&vol=vol1&target=test.img.gz&vdc=mygrid

Beispielausgabe

XML:

<job>bdc176a5-c069-4b23-89d2-d933127a9765</job> 

JSON:

{
   "job" : "bdc176a5-c069-4b23-89d2-d933127a9765"
} 

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 ist in der Anfrage nicht vorhanden.

400.4

Erforderliche Argumente fehlen (vol). - Argument vol=vol ist in der Anfrage nicht vorhanden.

400.4

Erforderliche Argumente fehlen (target). - Argument "target=filename" in der Anfrage nicht vorhanden.

Hinweis: 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.