Argomento precedente: Metodo migrate_status (oggetto vol)Argomento successivo: Metodo fscheck (oggetto vol)


Metodo move (oggetto vol)
Description

Sposta un volume in un'altra posizione

Sintassi

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

Argomenti
app

Nome dell'applicazione di origine

vol

Nome del volume.

volnew

Nuova posizione del volume, nella forma <application>:<volume_name>

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Spostamento di un volume atest:vol1 in btest:vol2.

GET http://192.168.123.200/api/v2/vol/move?app=atest&vol=vol1&volnew=btest:vol2&vdc=mygrid
Output di esempio
XML:

<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>

JSON:

{

"job" : "be805915-76b2-48c8-b8a0-b881cca66da6"

}

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 necessari mancanti (volnew). - Argomento volnew=new_vol 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 (consultare pagina 308).

Metodo relocate (oggetto vol)
Description

Trasferisce i volumi in un archivio dei volumi diverso (locale o san) o nei server abilitati

Sintassi
/api/v2/vol/relocate?app=application&name=app-or-volume&vdc=controller-name
Argomenti
name

Nome del volume da trasferire

vdc

Nome del data center virtuale di destinazione

Opzioni
store

Specificare l'archivio dei volumi in cui il volume deve essere trasferito. Il valore può essere "san" o "local".

n

Specificare il numero di volumi da trasferire simultaneamente. Valore predefinito: un volume alla volta.

&all

Riposiziona tutti i volumi da riposizionare.

&status

Elenco dei volumi che devono essere riposizionati o lo stato di riposizionamento di un volume specifico.

&suspend

Sospensione dei riposizionamenti dei volumi in corso.

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Riposizionamento di un volume di applicazione MYAPP:data in un archivio locale:

GET http://aux/api/v2/vol/relocate?name=MYAPP:data&store=local&vdc=mygrid

Riposizionamento di tutti i volumi per l'applicazione MYAPP in un SAN:

GET http://aux/api/v2/vol/relocate?name=MYAPP&store=san&vdc=mygrid

Riposizionamento di tutti i volumi dei server disabilitati, tre alla volta:

GET http://aux/api/v2/vol/relocate?&all&n=3&vdc=mygrid

Output di esempio
XML:
 <job>b88969ea-9264-40b2-ba08-29b7ecbcc150</job>
JSON:
{
   "job" : "b88969ea-9264-40b2-ba08-29b7ecbcc150"
}
Codici di errore HTTP
404

Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

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 relocate_status (oggetto vol)
Description

Segnala lo stato dei trasferimenti dei volumi in corso su una griglia

Sintassi
/api/v2/vol/relocate_status?&vdc=controller-name 
Argomenti
vdc

Nome del data center virtuale di destinazione

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Controllare l'avanzamento dei riposizionamenti dei volumi sulla griglia mygrid:

GET http://aux/api/v2/vol/relocate_status?&vdc=mygrid 
Output di esempio
XML:
<opt></opt>

JSON:
{
   "message" : ""
}

Codici di errore HTTP
404

Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.