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

Método export (objeto vol)

Descripción

Exporta un volumen a un archivo de contenedor en /vol/_impex/.

Sintaxis

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

Argumentos

app

Nombre de la aplicación o dominio que aloja el volumen.

vol

Nombre del volumen

target

Nombre del archivo de contenedor en el que exportar el volumen.

Crea el archivo en la raíz del volumen de importación/exportación del grid: /vol/_impex/. Opcionalmente, comprime el archivo utilizando gzip (tras la especificación de .gz como una extensión de nombre de archivo).

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Exportar el volumen test1:vol1 al archivo de contenedor comprimido /vol/_impex/test.img.gz

GET http://192.168.123.200/api/v2/vol/export?app=test1&vol=vol1&target=test.img.gz&vdc=mygrid

Ejemplo de salida

XML:

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

JSON:

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

Códigos de error de HTTP

404

Entidad vdc mygrid 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 (target). Falta el argumento target=filename en la solicitud.

Nota: Para obtener el estado de la tarea, envíe una solicitud /api/v2/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.