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

copy-Methode (vol-Objekt)

Description

Ein Volume kopieren

Syntax

/api/v2/vol/copy?app=application&vol=volume&volnew=new-volume&vdc=controller-name 

Argument

app

Name der Anwendung

vol

Name des Volumes

volnew

Name des neuen Volumes

vdc

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

Optionen

appnew

Name der alternativen Anwendung, in die das Volume kopiert werden soll. Standardmäßig wird das Volume in die ursprüngliche Anwendung kopiert.

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Ein Volume "test:vol1" nach "test:vol2" kopieren.

GET http://192.168.123.200/api/v2/vol/copy?app=test&vol=vol1&volnew=vol2&vdc=mygrid 

Ein Volume "atest:vol1" nach "btest:vol2" kopieren.

http://192.168.123.200/api/v2/vol/copy?app=atest&vol=vol1&appnew=btest&volnew=vol2&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 (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 (volnew). - Argument volnew=new_vol ist 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.