| Verb | URI | Description | |||
| GET | /images | List available images (IDs and names only) | |||
| GET | /images/detail | List available images (all details) | |||
Normal Response Code(s): 200, 203
Error ResponseCode(s): cloudServersFault (400, 500), serviceUnavailable (503), unauthorized (401), badRequest (400), overLimit (413)
This operation will list all images visible by the account.
In-flight images will have the status attribute
set to SAVING and the conditional
progress element (0-100% completion) will also be
returned. Other possible values for the status
attribute include: UNKNOWN,
PREPARING, ACTIVE,
QUEUED, FAILED. Images
with an ACTIVE status are available
for install.
This operation does not require a request body.
Example 4.33. Images List Response: XML (detail)
<?xml version="1.0" encoding="UTF-8"?>
<images xmlns="http://docs.rackspacecloud.com/servers/api/v1.0">
<image id="1" name="CentOS 5.2"
updated="2010-10-10T12:00:00Z"
created="2010-08-10T12:00:00Z"
status="ACTIVE"
/>
<image id="743" name="My Server Backup"
serverId="12"
updated="2010-10-10T12:00:00Z"
created="2010-08-10T12:00:00Z"
status="SAVING" progress="80"
/>
</images>
Example 4.34. Images List Response: JSON (detail)
{
"images" : [
{
"id" : 1,
"name" : "CentOS 5.2",
"updated" : "2010-10-10T12:00:00Z",
"created" : "2010-08-10T12:00:00Z",
"status" : "ACTIVE"
},
{
"id" : 743,
"name" : "My Server Backup",
"serverId" : 12,
"updated" : "2010-10-10T12:00:00Z",
"created" : "2010-08-10T12:00:00Z",
"status" : "SAVING",
"progress" : 80
}
]
}
