public function hasFailed()
{
$this->requiresValidImage(__METHOD__);
// what are we doing?
$log = usingLog()->startAction("make sure EC2 image '{$this->amiId}' has failed");
// get the state of the image
$imageState = $this->image['State'];
if ($imageState != 'failed') {
$log->endAction("image state is '{$imageState}'");
throw new E5xx_ExpectFailed(__METHOD__, "state is 'failed'", "state is '{$imageState}'");
}
// if we get here, all is well
$log->endAction();
}