Método import (objeto vol)

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

Método import (objeto vol)

Descripción

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

Sintaxis

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

Argumentos

app

Nombre de la aplicación o del dominio para alojar el volumen nuevo.

vol

Nombre del nuevo volumen

target

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

Recupera los datos del volumen del archivo que se encuentra en la raíz del volumen de importación/exportación en el grid especificado: /vol/_impex/. Espera los datos comprimidos en gzip si la extensión del archivo es .gz.

vdc

Nombre del centro de datos virtual de destino.

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Importe el volumen test2:vol2 del archivo de contenedor comprimido

/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

Ejemplo de salida

XML:


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

JSON:


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

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 (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.

Método migrate (objeto vol)

Descripción

Migra volúmenes entre grids con arquitecturas diferentes.

Sintaxis

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

Argumentos

remote grid

Nombre del grid del que importar el volumen (o para exportar el volumen cuando se especifica el indicador de la opción &export).

Nombre

Nombre de los volúmenes que se deben migrar. El valor sigue este formato:

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

local_ip

Una dirección IP libre en el grid local de la aplicación de migración que se va a utilizar.

El formato del valor es uno de los siguientes:

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

remote_ip

Una dirección IP libre en el grid remoto de la aplicación de migración que se va a utilizar.

El formato del valor es uno de los siguientes:

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

vdc

Nombre del centro de datos virtual de destino.

Opciones

new_name

Nuevo nombre del volumen. El formato del valor es uno de los siguientes:

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

migrating_class

La clase que se va a utilizar en la compilación de la aplicación de migración local. Esta clase debe encontrarse en un catálogo global. El valor predeterminado es /filer:Filer_Linux_ADMI.

encr_key

Especifica el nombre de un volumen que contiene claves de cifrado reparadas que se deben proporcionar a las aplicaciones que realizan la migración del volumen.

<prop>=<val>

Parámetros del volumen.

Los atributos del volumen se recuperan del volumen que se migra. Los siguientes parámetros se pueden utilizar para anular los valores actuales de los volúmenes que se migran. Debe extremarse la precaución al reducir tamaños de volúmenes y particiones.

Parámetro del volumen	Descripción
- fs	Tipo de sistema del archivo (por ejemplo, ext3).
- size	Tamaño del volumen. Se pueden especificar unidades (por ejemplo, 128 MB o 2 GB). De forma predeterminada, el valor se interpreta como un número de megabytes.
- comment	Comentario del volumen.
- fs options	Opciones del sistema de archivos adicionales que se utiliza para formatear el volumen.
- mirrored	El volumen está duplicado.
- parN.	Parámetros de partición (opcionales). Para obtener más información, consulte las notas.

&export: Migre el volumen al grid remoto (valor predeterminado), por lo que se requiere la confianza bidireccional entre los dos grids.
&import: Migra el volumen desde el grid remoto (valor predeterminado).