# Images

Note

Images on Rackspace servers: with standard servers, the entire disk (OS and data) is captured in the image. With Performance servers, only the s ystem disk is captured in the image. The data disks should be backed up using Cloud Backup or Cloud Block Storage to ensure availability in case you need to rebuild or restore a server.

## List images

Below is the simplest usage for retrieving a list of images:

    $images = $service->imageList();

    foreach ($images as $image) {

    }

Get the executable PHP script for this example

### Detailed results

By default, the only fields returned in a list call are id and name, but you can enable more detailed information to be result by passing in true as the first argument of the call, like so:

    $images = $service->imageList(true);

### Filtering

You can also refine the list of images returned by providing specific filters:

Array key | Description
--- | ---
server | Filters the list of images by server. Specify the server reference by ID or by full URL.
name | Filters the list of images by image name.
status | Filters the list of images by status. In-flight images have a status of `SAVING` and the conditional progress element contains a value from 0 to 100, which indicates the percentage completion. For a full list, please consult the `OpenCloud\Compute\Constants\ImageState` class. Images with an `ACTIVE` status are available for use.
changes-since | Filters the list of images to those that have changed since the changes-since time. See the official docs for more information.
marker | The ID of the last item in the previous list. See the official docs for more information.
limit | Sets the page size. See the official docs for more information.
type | Filters base Rackspace images or any custom server images that you have created. Can either be `BASE` or `SNAPSHOT`.

These are defined in an array and passed in as the second argument. For example, to filter images for a particular server:

    $images = $service->imageList(false, array('server' => '{serverId}'));

## Retrieve details about an image

    $image = $service->image('{imageId}');

## Delete an image

    $image->delete();