Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos para la API de CA AppLogic › Objeto vol › Método format (objeto vol)

Método format (objeto vol)

Descripción

Dar formato a un volumen existente

Sintaxis

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

Argumentos

app

Nombre de la aplicación

vol

Nombre del volumen

fs

Sistema de archivos del volumen que se va a crear.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Formatear un volumen test:vol1 con fs=ext3

GET http://192.168.123.200/api/v1/vol/format?app=test&vol=vol1&fs=ext3&vdc=mygrid 

Ejemplo de salida

XML:

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

JSON:

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

Códigos de error de HTTP

404

Entidad mygrid de vdc no encontrada: se ha especificado un nombre de VDC que no está configurado en la aplicación WS_API.

400.4

Faltan argumentos obligatorios (app): el argumento app=app falta en la solicitud.

400.4

Faltan argumentos obligatorios (vol): el argumento vol=vol falta en la solicitud.

400.4

Faltan argumentos obligatorios (fs): el argumento fs=fs falta en la solicitud.

Nota: Esto eliminará todos los datos que se encuentren en el volumen en ese momento. Para obtener el estado de la tarea, envíe una solicitud /api/v1/job/info? con el job_id devuelto anteriormente como argumento. Para obtener más información sobre cómo obtener el estado de la tarea, consulte el objeto job.