Getting full information from a certain Image Storage

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 Image Storage
volumes	VolumeInfo Array	List of Volumes presents on this Image Storage
external_volumes	ExternalVolumeInfo Array	List of External Volumes present on this Image Storage
gluster_volumes	GlusterVolumeInfo Array	List of Gluster Volumes present on this Image Storage
disks	PhysicalDiskInfo Array	List of Pyhisical Disks present and usable on this Image Storage

JSON example

{
    "hosts": ["flexdev01"],
    "volumes": [{
        "volume_id": "samsung_ssd",
        "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
    }],
    "gluster_volumes": [{
        "bricks": [
            "flexdev01:/data/brick1",
            "flexdev01:/data/brick2",
            "flexdev02:/data/brick1",
            "flexdev02:/data/brick2",
            "flexnuc2:/data/brick1",
            "flexnuc2:/data/brick2"
        ],
        "clones": [],
        "configuration": "1 x (4 + 2)",
        "free_space": 376105728,
        "gvolume_name": "test_vol1",
        "images": [],
        "status": "ok",
        "status_msg": "",
        "total_space": 376173056,
        "transport": "tcp",
        "type": "Disperse",
        "volume_id": "test_vol1"
    }],
    "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
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	External Volume's unique identifier
mount_point	String	External Volume'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	External Volume size (KB)
free_space	Integer	Free space in External Volume (KB)
images	ImageInfo Array	List of disk images present on this External Volume
clones	CloneInfo Array	List of cloned disk images present of this External Volume

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
}

GlusterVolumeInfo Object

Esquema de datos

volume_id	String	Gluster Volume's unique identifier
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	External Volume size (KB)
free_space	Integer	Free space in External Volume (KB)
bricks	Array of String	List of bricks of this volume, in the form "host:/path/to/brick"
type	String	Type of Gluster volume (Replica, Dispersed, Distributed Replica, etc.)
configuration	String	Configuration of bricks for this type of volume
transport	String	Transport, one of "tcp", "rdma" or "tcp,rdma"
images	ImageInfo Array	List of disk images present on this External Volume
clones	CloneInfo Array	List of cloned disk images present of this External Volume

JSON example

{
    "bricks": [
        "flexdev01:/data/brick1",
        "flexdev01:/data/brick2",
        "flexdev02:/data/brick1",
        "flexdev02:/data/brick2",
        "flexnuc2:/data/brick1",
        "flexnuc2:/data/brick2"
    ],
    "clones": [],
    "configuration": "1 x (4 + 2)",
    "free_space": 376105728,
    "gvolume_name": "test_vol1",
    "images": [],
    "status": "ok",
    "status_msg": "",
    "total_space": 376173056,
    "transport": "tcp",
    "type": "Disperse",
    "volume_id": "test_vol1"
}

ImageInfo Object

Schema

image_id	String	Image's unique identifier
volume_id	String	Volume's unique identifier (Image's container)
image_storage_id	String	Image Storage'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 Physical Disk, or empty if not reserved

JSON example

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