Metodo import (oggetto vol)

Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto vol › Metodo import (oggetto vol)

Metodo import (oggetto vol)

Description

Importare un volume da un file contenitore su /vol/_impex/

Sintassi

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

Argomenti

app

Nome dell'applicazione o del dominio che ospita il nuovo volume

vol

Nome del nuovo volume

target

Nome del file contenitore da cui importare il volume.

Recupera i dati del volume dal file situato alla radice del volume di importazione/esportazione sulla griglia specificata: /vol/_impex/ Attende dati compressi gzip se l'estensione del nome file è .gz

vdc

Nome del data center virtuale di destinazione.

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Importare il volume test2:vol2 dal file contenitore compresso

/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

Output di esempio

XML:


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

JSON:


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

Codici di errore HTTP

404: Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.
400.4: Argomenti necessari mancanti (app). - Argomento app=app mancante nella richiesta.
400.4: Argomenti necessari mancanti (vol). - Argomento vol=vol mancante nella richiesta.
400.4: Argomenti obbligatori mancanti (target). - Argomento target=filename mancante nella richiesta.

Nota: per visualizzare lo stato del processo, inviare una richiesta /api/v2/job/info? con il job_id restituito sopra come argomento. Per ulteriori informazioni su come ottenere lo stato del processo, fare riferimento all'oggetto job.

Metodo migrate (oggetto vol)

Description

Esegue la migrazione dei volumi tra griglie con architetture diverse.

Sintassi

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

Argomenti

remote grid

Nome della griglia da cui importare il volume (o in cui esportare il volume quando il flag dell'opzione &export è specificato).

name

Nome del volume di cui eseguire la migrazione. Il valore segue il formato

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

local_ip

Un indirizzo IP libero sulla griglia locale, per migrare l'applicazione da utilizzare.

Il formato del valore è uno dei seguenti:

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

remote_ip

Un indirizzo IP libero sulla griglia remota, per migrare l'applicazione da utilizzare.

Il formato del valore è uno dei seguenti:

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

vdc

Nome del data center virtuale di destinazione.

Opzioni

new_name

Nuovo nome del volume. Il formato del valore è uno dei seguenti:

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

migrating_class

La classe da utilizzare nella compilazione dell'applicazione di migrazione. Questa classe deve risiedere in un catalogo globale. Il valore predefinito è /filer:Filer_Linux_ADMI.

encr_key

Specifica il nome di un volume che contiene le chiavi di crittografia fisse da fornire alle applicazioni che eseguono la migrazione del volume.

<prop>=<val>

Parametri del volume.

Gli attributi del volume vengono recuperati dal volume di cui viene eseguita la migrazione. I parametri seguenti possono essere utilizzati per ignorare i valori correnti dai volumi di cui si esegue la migrazione. Utilizzare la massima cautela quando si riducono le dimensioni di volumi o partizioni.

Parametro di volume	Description
- fs	Tipo di file system. (ad esempio, ext3)
- size	Dimensioni del volume. Le unità possono essere specificate (ad esempio, 128 M[B], 2 G[B]). Per impostazione predefinita, il valore viene interpretato come il numero di megabyte.
- comment	Commento sul volume
- opzioni fs	Opzioni di file system aggiuntive utilizzate per formattare il volume
- mirrored	Volume con mirroring.
- parN.	Parametri di partizione (facoltativo). Consultare le note per ulteriori dettagli.

&export: Eseguire la migrazione del volume NELLA griglia remota (impostazione predefinita), richiedendo così una relazione di trust bidirezionale tra le due griglie.
&import: Esegue la migrazione del volume DALLA griglia remota (impostazione predefinita)