register Jedes AMI ist mit einer eideutigen ID assoziiert welche vom Amazon EC2 Service über die RegisterImage Operation zur Verfügung gestellt wird. Wärend der Registrierung empfängt Amazon EC2 das spezifizierte Manifest des Images von Amazon S3 und überprüft ob das Image dem Benutzer gehört der das Image registriert.

register gibt die imageId für das registrierte Image zurück.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
$ip = $ec2_img->register('imageLocation');

deregister, de-registriert ein AMI. Einmal de-registriert können Instanzen dieses AMI nicht mehr gestartet werden.

deregister gibt ein boolsches TRUE oder FALSE zurück.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
$ip = $ec2_img->deregister('imageId');

describe gibt Informationen über AMIs, AKIs und ARIs zurück die für den Benutzer verfügbar sind. Die zurückgegebenen Informationen enthalten den Imagetyp, Produktcodes, Architektur, Kernel und RAM Disk IDs. Images die für den Benutzer verfügbar sind, enthalten öffentliche Images die zum Starten für jeden Benutzer vorhanden sind, private Images die dem Benutzer gehören der die Anfrage stellt, und private Images die anderen Benutzern gehören welche dem Benutzer explizit die Rechte zum Starten gegeben haben.

Die Liste der zurückgegebenen AMIs kann durch die Spezifikation von AMI IDs, AMI Eigentümer oder Benutzern mit Starterechtigung, geändert werden. Wenn keine Option spezifiziert wird, gibt Amazon EC2 alle AMIs zurück für die der Benutzer eine Startberechtigung hat.

Wenn eine oder mehrere AMI IDs spezifiziert werden, werden nur die AMIs zurückgegeben welche die spezifizierten IDs besitzen. Wenn man eine ungültige AMI ID spezifiziert, wird ein Fehler zurückgegeben. Wenn man eine AMI ID spezifiziert für die man keinen Zugriff hat, wird diese nicht in den zurückgegebenen Ergebnissen enthalten sein.

Wenn ein oder mehrere AMI Eigentümer spezifiziert werden, werden nur die AMIs der spezifizierten Eigentümer, für die man auch Zugriffsrechte hat, zurückgegeben. Die Ergebnisse können account für die Account IDs des spezifizierten Eigentümers enthalten, amazon für AMIs die Amazon selbst gehören oder self für AMIs die man selbst besitzt.

Wenn man eine Liste von ausführbaren Benutzern spezifiziert, werden nur die Benutzer zurückgegeben die eine Startberechtigung für die AMIs haben. Man kann mit account, Account IDs spezifizieren (wenn man die AMIs besitzt), self für AMIs die man selbst besitzt oder explizite Zugriffsrechte hat, oder all für öffentliche AMIs.

describe gibt ein Array für alle Images zurück die den übergebenen Kriterien entsprechen. Das Array enthält imageId, imageLocation, imageState, imageOwnerId, isPublic, architecture, imageType, kernedId, ramdiskId und platform.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
$ip = $ec2_img->describe();

Ein Attribut eines AMI verändern

modifyAttribute gibt ein boolsches TRUE oder FALSE zurück.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
// Ändert die Startberechtigung (launchPermission) eines AMI
$return = $ec2_img->modifyAttribute('imageId',
                                    'launchPermission',
                                    'add',
                                    'userId',
                                    'userGroup');

// Setzt den Produktcode des AMI.
$return = $ec2_img->modifyAttribute('imageId',
                                    'productCodes',
                                    'add',
                                    null,
                                    null,
                                    'productCode');

resetAttribute setzt die Attribute eines AMI auf dessen Standardwerte zurück. Das productCodes Attribut kann nicht zurückgesetzt werden.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
$return = $ec2_img->resetAttribute('imageId', 'launchPermission');

describeAttribute gibt Informationen über ein Attribut eines AMI zurück. Pro Aufruf kann nur ein Attribut spezifiziert werden. Aktuell werden nur launchPermission und productCodes unterstützt.

describeAttribute gibt ein Array mit dem Wert des Attributes zurück das angefragt wurde.

$ec2_img = new Zend_Service_Amazon_Ec2_Image('aws_key','aws_secret_key');
$return = $ec2_img->describeAttribute('imageId', 'launchPermission');