<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.service.amazon.ec2.keypairs">
    <title>Zend_Service_Amazon_Ec2: Schlüsselpaare</title>

    <para>
        Schlüsselpaare werden verwendet um auf Instanzen zuzugreifen.
    </para>

    <example id="zend.service.amazon.ec2.keypairs.create">
        <title>Erstellen eines neuen Amazon Schlüsselpaars</title>

        <para>
            <code>create</code>, erstellt ein neues 2048 RSA Schlüsselpaar und gibt eine eindeutige
            ID zurück die verwendet werden kann um auf diese Schlüsselpaare zu referenzieren wenn
            eine neue Instanz gestartet wird.
        </para>

        <para>
            <code>create</code> gibt ein Array zurück das keyName, keyFingerprint und keyMaterial
            enthält.
        </para>

        <programlisting language="php"><![CDATA[
$ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
$return = $ec2_kp->create('my-new-key');
]]></programlisting>
    </example>

    <example id="zend.service.amazon.ec2.keypairs.delete">
        <title>Löschen eines Amazon Schlüsselpaares</title>

        <para>
            <code>delete</code>, löscht das Schlüsselpaar. Das verhindert nur das er von neuen
            Instanzen verwendet wird. Aktuell, mit diesem Schlüsselpaar laufende Instanzen,
            erlauben es trotzdem das man auf Sie zugreigen kann.
        </para>

        <para>
            <code>delete</code> gibt ein boolsches <constant>TRUE</constant> oder
            <constant>FALSE</constant> zurück.
        </para>

        <programlisting language="php"><![CDATA[
$ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
$return = $ec2_kp->delete('my-new-key');
]]></programlisting>
    </example>

    <example id="zend.service.amazon.ec2.describe">
        <title>Ein Amazon Schlüsselpaar beschreiben</title>

        <para>
            <code>describe</code> gibt Informationen über das vorliegende Schlüsselpaar zurück.
            Wenn man ein Schlüsselpaar spezifiziert, werden Informationen über diese
            Schlüsselpaare zurückgegeben. Andernfalls werden Informationen über alle registrierten
            Schlüsselpaare zurückgegeben.
        </para>

        <para>
            <code>describe</code> gibt ein Array zurück das keyName und keyFingerprint enthält.
        </para>

        <programlisting language="php"><![CDATA[
$ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
$return = $ec2_kp->describe('my-new-key');
]]></programlisting>
    </example>
</sect1>
