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

Metodo format (oggetto vol)

Description

Formatta un volume esistente

Sintassi

/api/v2/vol/format?app=application&vol=volume&fs=filesystem&vdc=controller-name 

Argomenti

app

Nome dell'applicazione

vol

Nome del volume.

fs

File system del volume da creare

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

asincrona

Tipo di richiesta

GET

Esempi

Formattazione di un volume test:vol1 con fs= ext3.

GET http://192.168.123.200/api/v2/vol/format?app=test&vol=vol1&fs=ext3&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 (fs). - Argomento fs=fs mancante nella richiesta.

Nota: verranno cancellati tutti i dati attualmente presenti nel volume. 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.