Método move (objeto vol)

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

Método move (objeto vol)

Descripción

Mueve un volumen a una ubicación alternativa.

Sintaxis

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

Argumentos

app: Nombre de la aplicación de origen.
vol: Nombre del volumen
volnew: Nueva ubicación del volumen con el formato <application>:<volume_name>
vdc: Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Trasladar un volumen atest:vol1 a btest:vol2

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

Ejemplo de salida

XML:

JSON:

{

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

}

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 (volnew): el argumento volnew=new_vol falta 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 acerca de cómo obtener el estado de la tarea, consulte el objeto job (vea la página 308).

Método relocate (objeto vol)

Descripción

Reubica volúmenes a un almacén de volúmenes distinto (local o SAN) o a servidores permitidos.

Sintaxis

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

Argumentos

Nombre: Nombre de los volúmenes que se deben reubicar.
vdc: Nombre del centro de datos virtual de destino

Opciones

store: Especifica el almacén del volumen en el que se reubica el volumen. El valor puede ser "san" o "local".
n: Especifica el número de volúmenes que se reubican simultáneamente. Valor predeterminado: un volumen cada vez.
&all: Reubica todos los volúmenes que necesitan reubicación.
&status: Muestra los volúmenes que necesitan reubicarse o el estado de reubicación de un volumen concreto.
&suspend: Suspenda las reubicaciones de volúmenes en curso.

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Reubique un volumen de la aplicación MYAPP:data a un almacén local:

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

Reubique todos los volúmenes de la aplicación MYAPP en una SAN:

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

Reubique todos los volúmenes de los servidores desactivas, tres cada vez:

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

Ejemplo de salida

XML:

 <job>b88969ea-9264-40b2-ba08-29b7ecbcc150</job>

JSON:

{
   "job" : "b88969ea-9264-40b2-ba08-29b7ecbcc150"
}

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.

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

Descripción

Informe acerca del estado de las reubicaciones de los volúmenes en curso en un grid.

Sintaxis

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

Argumentos

vdc: Nombre del centro de datos virtual de destino

Tipo de transacción

asincrónico

Tipo de solicitud

GET

Ejemplos

Compruebe el progreso de las reubicaciones de volúmenes en el grid mygrid:

GET http://aux/api/v2/vol/relocate_status?&vdc=mygrid

Ejemplo de salida

XML:

<opt></opt>

JSON:

{
   "message" : ""
}

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.