Getting full information from a certain ImageStorage

Format

Method	GET
URL	/imagestorages/$IMAGE_STORAGE_ID
Request contents	Empty
Successful answer	ImageStorageInfo Object
Non-successful answer	ErrorMessage Object
Unexpected error	HTTP 500

ImageStorageInfo Object

Schema

hosts	String Array	List of Hosts linked to this ImageStorage
volumes	VolumeInfo Array	List of Volumes presents on this ImageStorage
external_volumes	ExternalVolumeInfo Array	List of ExternalVolumes present on this ImageStorage
disks	PhysicalDiskInfo Array	List of PyhisicalDisks present and usable on this ImageStorage

JSON example

{
    "hosts": ["flexdev01"],
    "volumes": [{
        "volume_id": "samsung_ssd",
        "secondary_disk_id": "",
        "total_space": 250057728,
        "clones": [],
        "status": "ok",
        "status_msg": "",
        "primary_disk_id": "3500253887013e77e",
        "images": [{
            "volume_id": "samsung_ssd",
            "image_id": "windows7_020216",
            "guest_id": "windows7_020216",
            "image_storage_id": "internal",
            "size_mb": 20480
        }, {
            "volume_id": "samsung_ssd",
            "image_id": "windows7_public",
            "guest_id": "windows7_public",
            "image_storage_id": "internal",
            "size_mb": 40960
        }, {
            "volume_id": "samsung_ssd",
            "image_id": "windowsXP_public",
            "guest_id": "windowsXP_public",
            "image_storage_id": "internal",
            "size_mb": 20480
        }, {
            "volume_id": "samsung_ssd",
            "image_id": "voidlinux_slp",
            "guest_id": "voidlinux_slp",
            "image_storage_id": "internal",
            "size_mb": 15360
        }, {
            "volume_id": "samsung_ssd",
            "image_id": "opensuse421_public",
            "guest_id": "opensuse421_public",
            "image_storage_id": "internal",
            "size_mb": 20480
        }, {
            "volume_id": "samsung_ssd",
            "image_id": "voidlinux_slp_home",
            "guest_id": "voidlinux_slp",
            "image_storage_id": "internal",
            "size_mb": 61440
        }],
        "free_space": 67063808
    }],
    "external_volumes": [{
        "volume_id": "home_flexvdi",
        "total_space": 876659228,
        "clones": [{
            "clone_id": "corus_demo_corus",
            "image_id": "corus",
            "guest_id": "corus"
        }],
        "status": "ok",
        "status_msg": "",
        "mount_point": "/home/flexvdi",
        "images": [{
            "volume_id": "home_flexvdi",
            "image_id": "webportal_devel",
            "guest_id": "webportal_devel",
            "image_storage_id": "internal",
            "size_mb": 20480
        }, {
            "volume_id": "home_flexvdi",
            "image_id": "corus",
            "guest_id": "corus",
            "image_storage_id": "internal",
            "size_mb": 20480
        }, {
            "volume_id": "home_flexvdi",
            "image_id": "test",
            "guest_id": "test",
            "image_storage_id": "internal",
            "size_mb": 1024
        }],
        "free_space": 514361156
    }],
    "disks": [{
        "volume_id": "samsung_ssd",
        "product_number": "Samsung",
        "physical_disk_id": "3500253887013e77e",
        "vendor": "ATA",
        "host_device": "/dev/sdb"
    }]
}

VolumeInfo Object

Schema

volume_id	String	Volume's unique identifier
primary_disk_id	String	Physical disk's unique identifier
secondary_disk_id	String	Legacy
status	String	Current state. Either "unknown", "ok", "degraded" or "broken"
status_msg	String	Status message, obtained by last pool. Can be empty
total_space	Integer	Volume size (KB)
free_space	Integer	Free space in Volume (KB)
images	ImageInfo Array	List of disk images present on this Volume
clones	CloneInfo Array	List of cloned disk images present of this Volume

JSON example

{
    "volume_id": "samsung_ssd",
    "secondary_disk_id": "",
    "total_space": 250057728,
    "clones": [],
    "status": "ok",
    "status_msg": "",
    "primary_disk_id": "3500253887013e77e",
    "images": [{
        "volume_id": "samsung_ssd",
        "image_id": "windows7_020216",
        "guest_id": "windows7_020216",
        "image_storage_id": "internal",
        "size_mb": 20480
    }, {
        "volume_id": "samsung_ssd",
        "image_id": "windows7_public",
        "guest_id": "windows7_public",
        "image_storage_id": "internal",
        "size_mb": 40960
    }, {
        "volume_id": "samsung_ssd",
        "image_id": "windowsXP_public",
        "guest_id": "windowsXP_public",
        "image_storage_id": "internal",
        "size_mb": 20480
    }, {
        "volume_id": "samsung_ssd",
        "image_id": "voidlinux_slp",
        "guest_id": "voidlinux_slp",
        "image_storage_id": "internal",
        "size_mb": 15360
    }, {
        "volume_id": "samsung_ssd",
        "image_id": "opensuse421_public",
        "guest_id": "opensuse421_public",
        "image_storage_id": "internal",
        "size_mb": 20480
    }, {
        "volume_id": "samsung_ssd",
        "image_id": "voidlinux_slp_home",
        "guest_id": "voidlinux_slp",
        "image_storage_id": "internal",
        "size_mb": 61440
    }],
    "free_space": 67063808
 }

ExternalVolumeInfo Object

Esquema de datos

volume_id	String	ExternalVolume's unique identifier
mount_point	String	ExternalVolume's mount point on each Host
status	String	Current state. Either "unknown", "ok", "degraded" or "broken"
status_msg	String	Status message, obtained by last pool. Can be empty
total_space	Integer	ExternalVolume size (KB)
free_space	Integer	Free space in ExternalVolume (KB)
images	ImageInfo Array	List of disk images present on this ExternalVolume
clones	CloneInfo Array	List of cloned disk images present of this ExternalVolume

JSON example

{
    "volume_id": "home_flexvdi",
    "total_space": 876659228,
    "clones": [{
        "clone_id": "corus_demo_corus",
        "image_id": "corus",
        "guest_id": "corus"
    }],
    "status": "ok",
    "status_msg": "",
    "mount_point": "/home/flexvdi",
    "images": [{
        "volume_id": "home_flexvdi",
        "image_id": "webportal_devel",
        "guest_id": "webportal_devel",
        "image_storage_id": "internal",
        "size_mb": 20480
    }, {
        "volume_id": "home_flexvdi",
        "image_id": "corus",
        "guest_id": "corus",
        "image_storage_id": "internal",
        "size_mb": 20480
    }, {
        "volume_id": "home_flexvdi",
        "image_id": "test",
        "guest_id": "test",
        "image_storage_id": "internal",
        "size_mb": 1024
    }],
    "free_space": 514361156
}

ImageInfo Object

Schema

image_id	String	Image's unique identifier
volume_id	String	Volume's unique identifier (Image's container)
image_storage_id	String	ImageStorage's unique identifier (Volume's container)
guest_id	String	Unique identifier of Guest owning this disk image, or empty if not reserved
size_mb	Integer	Image size (MB)

JSON example

{
    "volume_id": "samsung_ssd",
    "image_id": "windows7_020216",
    "guest_id": "windows7_020216",
    "image_storage_id": "internal",
    "size_mb": 20480
}

CloneInfo Object

Schema

clone_id	String	Cloned disk image's unique identifier
image_id	String	Disk image's unique identifier (cloned disk image's parent)
guest_id	String	Unique identifier of Guest owning this disk image, or empty if not reserved

JSON example

{
    "clone_id": "corus_demo_corus",
    "image_id": "corus",
    "guest_id": "corus"
}

PhysicalDiskInfo Object

Schema

physical_disk_id	String	Physical disk's unique identifier
product_number	String	Physical disk's product string
vendor	String	Physical disk's vendor string
host_device	String	Name associated to this device on the first Host.
volume_id	String	Unique identifier of Guest owning this PhysicalDisk, or empty if not reserved

JSON example

{
    "volume_id": "samsung_ssd",
    "product_number": "Samsung",
    "physical_disk_id": "3500253887013e77e",
    "vendor": "ATA",
    "host_device": "/dev/sdb"
}