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

Método info (objeto vol)

Descripción

Permite recuperar la lista de información detallada para un volumen.

Sintaxis

/api/v1/vol/info?app=application&vol=volume&vdc=controller-name 

Argumentos

app

Nombre de la aplicación

vol

Nombre del volumen

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Recuperación de la lista de información detallada para test:vol1

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

Ejemplo de salida

XML:

<volume> 
   <name>vol1</name> 
   <comment></comment> 
   <filesystem>ext3</filesystem> 
   <link></link> 
   <mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56> 
      <server>srv1</server> 
      <state>ok</state> 
   </mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56> 
   <mount_path>none</mount_path> 
   <mount_state>available</mount_state> 
   <n_mirrors>1</n_mirrors> 
   <n_users>0</n_users> 
   <size>1073741824</size> 
   <state>ok</state> 
   <time_accessed>1272052234</time_accessed> 
   <time_created>1272052031</time_created> 
   <time_written>1272052032</time_written> 
   <uuid>cf432100-63fc-450d-8eb7-2da6deca8627</uuid> 
</volume> 

JSON:

{ 
   "link" : "", 
   "time_created" : "1272052031", 
   "time_accessed" : "1272052240", 
   "name" : "vol1", 
   "uuid" : "cf432100-63fc-450d-8eb7-2da6deca8627", 
   "mount_state" : "available", 
   "mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56" : { 
      "server" : "srv1", 
      "state" : "ok" 
   }, 
   "size" : "1073741824", 
   "state" : "ok", 
   "n_users" : "0", 
   "time_written" : "1272052032", 
   "mount_path" : "none", 
   "comment" : "", 
   "filesystem" : "ext3", 
   "n_mirrors" : "1" 
} 

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.

404.1

El volumen "test:data" no existe: se ha especificado una aplicación o un volumen no válido en la solicitud.