repo_zf1/documentation/manual/de/module_specs/Zend_Service_Amazon_Ec2-ReservedInstance.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.service.amazon.ec2.reserved.instance">
    <title>Zend_Service_Amazon_Ec2: Reservierte Instanzen</title>

    <para>
        Mit Amazon <acronym>EC2</acronym> Reservierte Instanzen, kann man eine geringe
        Einmalzahlung für jede zu reservierende Instanz tätigen und einen signifikanten Rabatt auf
        einer Stundenbasierenden Verwendung für diese Instanz erhalten.
    </para>

    <para>
        Amazon <acronym>EC2</acronym> Reservierte Instanzen basieren auf Instanz Typ und Ort
        (Region und Vorhandene Zone) für eine spezifizierte Zeitperiode (z.B. 1 Jahr oder 3 Jahre)
        und sind nur für Linux oder UNIX Instanzen erhältlich.
    </para>

    <sect2 id="zend.service.amazon.ec2.reserved.instance.howitworks">
        <title>Wie werden Reservierte Instanzen angehängt</title>

        <para>
            Reservierte Instanzen werden an Instanzen angehängt welche den Typen- und Ortskriterien
            während der spezifizierten Periode entsprechen. In diesem Beispiel verwendet ein Benutzer
            die folgenden Instanzen:
        </para>

        <itemizedlist>
            <listitem>
                <para>(4) m1.small Instanzen in der Vorhandenen Zone us-east-1a</para>
            </listitem>

            <listitem>
                <para>(4) c1.medium Instanzen in der Vorhandenen Zone us-east-1b</para>
            </listitem>

            <listitem>
                <para>(2) c1.xlarge Instanzen ind er Vorhandenen Zone us-east-1b</para>
            </listitem>
        </itemizedlist>

        <para>
            Der Benutzer erwirbt anschließend die folgenden Reservierten Instanzen.
        </para>

        <itemizedlist>
            <listitem>
                <para>(2) m1.small Instanzen in der Vorhandenen Zone us-east-1a</para>
            </listitem>

            <listitem>
                <para>(2) c1.medium Instanzen in der Vorhandenen Zone us-east-1a</para>
            </listitem>

            <listitem>
                <para>(2) m1.xlarge Instanzen in der Vorhandenen Zone us-east-1a</para>
            </listitem>
        </itemizedlist>

        <para>
            Amazon <acronym>EC2</acronym> fügt die zwei m1.small Reservierten Instanzen den zwei
            Instanzen in der Vorhandenen Zone us-east-1a hinzu. Amazon <acronym>EC2</acronym>
            fügt die zwei c1.medium Reservierten Instanzen nicht hinzu weil die c1.medium Instanzen
            in einer anderen Vorhandenen Zone sind und es fügt auch nicht die m1.xlarge
            Reservierten Instanzen hinzu weil es keine laufenden m1.xlarge Instanzen gibt.
        </para>
    </sect2>

    <sect2 id="zend.service.amazon.ec2.reserved.instance.operations">
        <title>Verwendung Reservierter Instanzen</title>

        <example id="zend.service.amazon.ec2.reserved.instance.operations.describe">
            <title>Beschreibt Reservierte Instanzen die man gekauft hat</title>

            <para>
                <methodname>describeInstances()</methodname> gibt Informationen über eine
                reservierte Instanz oder Instanzen zurück die man gekauft hat.
            </para>

            <para>
                <methodname>describeInstances()</methodname> gibt ein mehrdimensionales Array
                zurück welches folgendes enthält: reservedInstancesId, instanceType,
                availabilityZone, duration, fixedPrice, usagePrice, productDescription,
                instanceCount und state.
            </para>

            <programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->describeInstances('instanceId');
]]></programlisting>
        </example>

        <example id="zend.service.amazon.ec2.reserved.instance.offerings.describe">
            <title>Beschreiben der aktuell vorhandenen Reservierten Instanz Angebote</title>

            <para>
                <methodname>describeOfferings()</methodname> beschreibt Angebote für Reservierte
                Instanzen die für einen Kauf vorhanden sind. Mit Amazon <acronym>EC2</acronym>
                Reservierten Instanzen kauft man das Recht amazon <acronym>EC2</acronym> Instanzen
                für eine bestimmte Zeitdauer zu starten (ohne Fehler wegen unzureichender Kapazität
                zu erhalten) und einen geringeren Preis für die Verwendung der wirklich verwendeten
                Zeit zu erhalten.
            </para>

            <para>
                <methodname>describeOfferings()</methodname> gibt ein mehrdimensionales Array
                zurück das die folgenden Daten enthält: reservedInstancesId, instanceType,
                availabilityZone, duration, fixedPrice, usagePrice und productDescription.
            </para>

            <programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->describeOfferings();
]]></programlisting>
        </example>

        <example id="zend.service.amazon.ec2.reserved.instance.offerings.purchase">
            <title>Das CloudWatch Monitoring bei Instanzen ausschalten</title>

            <para>
                <methodname>purchaseOffering()</methodname> erwirbt eine Reservierte Instanz für
                die Verwendung mit dem eigenen Account. Mit Amazon <acronym>EC2</acronym>
                Reservierten Instanzen kauft man das Recht amazon <acronym>EC2</acronym> Instanzen
                für eine bestimmte Zeitdauer zu starten (ohne Fehler wegen unzureichender Kapazität
                zu erhalten) und einen geringeren Preis für die Verwendung der wirklich verwendeten
                Zeit zu erhalten.
            </para>

            <para>
                <methodname>purchaseOffering()</methodname> gibt die reservedInstanceId zurück.
            </para>

            <programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Reserved('aws_key',
                                                     'aws_secret_key');
$return = $ec2_instance->purchaseOffering('offeringId', 'instanceCount');
]]></programlisting>
        </example>
    </sect2>
</sect1>