import-Methode (app-Objekt)

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

import-Methode (app-Objekt)

Description

Importieren eines Volumes aus einer Containerdatei auf /vol/_impex/

Syntax

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

Argument

app

Name der Anwendung oder Domäne, die das neue Volume hosten soll

vol

Name des neuen Volumes

target

Name der Containerdatei, aus der das Volume importiert werden soll.

Ruft die Volume-Daten aus der Datei ab, die sich am Stamm des Import-/Export-Volumes auf dem angegebenen Grid befindet: /vol/_impex/ - Es werden gzip-komprimierte Daten erwartet, wenn die Erweiterung des Dateinamens .gz ist.

vdc

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

Transaktionsart

asynchron

Anfragetyp

GET

Beispiele

Importieren des Volumes "test2:vol2" aus der komprimierten Containerdatei

/vol/_impex/test.img.gz.

GET

http://192.168.123.200/api/v2/vol/import?app=test2&vol=vol2&target=test.img.gz&vdc=mygrid

Beispielausgabe

XML:


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

JSON:


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

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.

migrate-Methode (vol-Objekt)

Description

Migrieren von Volumes zwischen Grids mit verschiedenen Architekturen.

Syntax

/api/v2/vol/migrate?remote_grid=grid_name&name=volume&local_ip=ip_address &remote_ip=ip_address&vdc=controller-name

Argument

remote grid

Name des Grid, aus dem das Volume importiert werden soll (oder der Name des Grid, in das das Volume exportiert werden soll, wenn das Optionsflag "&export" angegeben ist).

Name

Name der zu migrierenden Volumes. Der Wert hat folgendes Format

<application>:<volume>,_GLOBAL:<volume> oder _GLOBAL_RO:<volume>

local_ip

Eine freie IP-Adresse auf dem lokalen Grid, die die Migrationsanwendung verwenden soll.

Das Wertformat hat eines der folgenden Formate:

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

remote_ip

Eine freie IP-Adresse auf dem Remote-Grid, die die Migrationsanwendung verwenden soll.

Das Wertformat hat eines der folgenden Formate:

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

vdc

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

Optionen

new_name

Neuer Name des Volumes. Das Wertformat hat eines der folgenden Formate:

<application>:<volume>,_GLOBAL:<volume> oder _GLOBAL_RO:<volume>

migrating_class

Die Klasse, die beim Erstellen der Migrator-Anwendung verwendet werden soll. Diese Klasse muss sich in einem globalen Katalog befinden. Der Standard ist /filer:Filer_Linux_ADMI.

encr_key

Legt den Namen eines Volumes fest, das feste Verschlüsselungscodes enthält, die den Anwendungen mitgeteilt werden müssen, welche die Volume-Migration ausführen.

<prop>=<val>

Volume-Parameter.

Volume-Attribute werden vom zu migrierenden Volume abgerufen. Folgende Parameter können verwendet werden, um die aktuellen Werte von den zu migrierenden Volumes aus zu überschreiben. Gehen Sie beim Verkleinern von Volumes oder Partitionen mit äußerster Vorsicht vor.

Volume-Parameter	Description
- fs	Dateisystemtyp. (z. B. ext3)
- size	Volume-Größe. Einheiten lassen sich festlegen (z. B., 128M[B], 2G[B]) Standardmäßig wird der Wert als Anzahl von Megabyte interpretiert.
- comment	Kommentar zum Volume
- fs options	Zusätzliche Dateisystemoptionen, die zum Formatieren des Volumes verwendet werden
- mirrored	Volume wird gespiegelt
- parN.	Partitionierungsparameter (optional). Weitere Informationen finden Sie unter den Hinweisen.

&export: Migrieren des Volumes ZUM Remote-Grid (Standard), daher ist ein beidseitiges Vertrauen zwischen den zwei Grids erforderlich.
&import: Migriert das Volume AUS dem Remote-Grid (Standard).