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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 16389 -->
<!-- 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 und 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ärend 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>Describe current Reserved Instance Offerings available</title>
            <para>
                <methodname>describeOfferings()</methodname> Describes Reserved Instance offerings
                that are available for purchase. With Amazon <acronym>EC2</acronym> Reserved
                Instances, you purchase the right to launch Amazon <acronym>EC2</acronym> instances
                for a period of time (without getting insufficient capacity errors) and pay a lower
                usage rate for the actual time used.
            </para>
            <para>
                <methodname>describeOfferings()</methodname> returns a multi-demential array that
                contains reservedInstancesId, instanceType, availabilityZone, duration, fixedPrice,
                usagePrice and 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>Turn off CloudWatch Monitoring on an Instance(s)</title>
            <para>
                <methodname>purchaseOffering()</methodname> Purchases a Reserved Instance for use
                with your account. With Amazon <acronym>EC2</acronym> Reserved Instances, you
                purchase the right to launch Amazon <acronym>EC2</acronym> instances for a period
                of time (without getting insufficient capacity errors) and pay a lower usage rate
                for the actual time used.
            </para>
            <para>
                <methodname>purchaseOffering()</methodname> returns the reservedInstanceId.
            </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>