Getting full information from a certain Image Storage
- Javier Celaya (Unlicensed)
Owned by Javier Celaya (Unlicensed)
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"
}