rename-Methode (vol-Objekt)

Description

Ein Volume umbenennen

Syntax

/api/v2/vol/rename?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

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Ein Volume "test:vol1" in "test:vol2" umbenennen.

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

Beispielausgabe

XML:

<opt></opt>

JSON:

{}

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.
404.1: Volume "test:data" ist nicht vorhanden. - Ungültige Anwendung in der Anfrage.
404.1: Volume "test:data" konnte nicht umbenannt werden. - In der Anfrage angegebenes Volume ist in Verwendung.
404.1: Volume "test:data2" ist nicht vorhanden. - In der Anfrage wurde ein ungültiges Volume angegeben.