Version AWS SDK für Java 1.x wurde am 31. Juli 2024 in den Wartungsmodus versetzt und wird end-of-supportam 31. Dezember 2025 verfügbar sein. Wir empfehlen Ihnen, auf den zu migrieren AWS SDK for Java 2.x, um weiterhin neue Funktionen, Verfügbarkeitsverbesserungen und Sicherheitsupdates zu erhalten.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon EC2 Instanzen verwalten

Erstellen einer Instance

Erstellen Sie eine neue Amazon EC2 Instance, indem Sie die runInstances Methode des EC2 Amazon-Clients aufrufen und ihr ein RunInstancesRequestzu verwendendes Amazon Machine Image (AMI) und einen Instance-Typ zur Verfügung stellen.

Importe

import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.InstanceType;
import com.amazonaws.services.ec2.model.RunInstancesRequest;
import com.amazonaws.services.ec2.model.RunInstancesResult;
import com.amazonaws.services.ec2.model.Tag;

Code

RunInstancesRequest run_request = new RunInstancesRequest()
    .withImageId(ami_id)
    .withInstanceType(InstanceType.T1Micro)
    .withMaxCount(1)
    .withMinCount(1);

RunInstancesResult run_response = ec2.runInstances(run_request);

String reservation_id = run_response.getReservation().getInstances().get(0).getInstanceId();

Siehe vollständiges Beispiel.

Starten einer Instance

Um eine Amazon EC2 Instance zu starten, rufen Sie die startInstances Methode des EC2 Amazon-Clients auf und geben ihr eine, die die ID der zu startenden Instance StartInstancesRequestenthält.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.StartInstancesRequest;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

StartInstancesRequest request = new StartInstancesRequest()
    .withInstanceIds(instance_id);

ec2.startInstances(request);

Siehe vollständiges Beispiel.

Anhalten einer Instance

Um eine Amazon EC2 Instance zu stoppen, rufen Sie die stopInstances Methode des EC2 Amazon-Clients auf und geben ihr eine, die die ID der zu stoppenden Instance StopInstancesRequestenthält.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.StopInstancesRequest;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

StopInstancesRequest request = new StopInstancesRequest()
    .withInstanceIds(instance_id);

ec2.stopInstances(request);

Siehe vollständiges Beispiel.

Neustarten einer Instance

Um eine Amazon EC2 Instance neu zu starten, rufen Sie die rebootInstances Methode des EC2 Amazon-Clients auf und geben ihr eine, die die ID der Instance RebootInstancesRequestenthält, die neu gestartet werden soll.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.RebootInstancesRequest;
import com.amazonaws.services.ec2.model.RebootInstancesResult;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

RebootInstancesRequest request = new RebootInstancesRequest()
    .withInstanceIds(instance_id);

RebootInstancesResult response = ec2.rebootInstances(request);

Siehe vollständiges Beispiel.

Beschreiben von Instances

Um Ihre Instances aufzulisten, erstellen Sie eine describeInstances Methode des EC2 Amazon-Clients DescribeInstancesRequestund rufen Sie sie auf. Es wird ein DescribeInstancesResultObjekt zurückgegeben, mit dem Sie die Amazon EC2 Instances für Ihr Konto und Ihre Region auflisten können.

Instances werden nach Reservierung gruppiert. Jede Reservierung entspricht dem Aufruf von startInstances, durch den die Instance gestartet wurde. Um Ihre Instances aufzulisten, sollten Sie zuerst die getReservations' method, and then call `getInstances-Methode der DescribeInstancesResult-Klasse für jedes zurückgegebene Reservation-Objekt aufrufen.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Instance;
import com.amazonaws.services.ec2.model.Reservation;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();
boolean done = false;

DescribeInstancesRequest request = new DescribeInstancesRequest();
while(!done) {
    DescribeInstancesResult response = ec2.describeInstances(request);

    for(Reservation reservation : response.getReservations()) {
        for(Instance instance : reservation.getInstances()) {
            System.out.printf(
                "Found instance with id %s, " +
                "AMI %s, " +
                "type %s, " +
                "state %s " +
                "and monitoring state %s",
                instance.getInstanceId(),
                instance.getImageId(),
                instance.getInstanceType(),
                instance.getState().getName(),
                instance.getMonitoring().getState());
        }
    }

    request.setNextToken(response.getNextToken());

    if(response.getNextToken() == null) {
        done = true;
    }
}

Die Ergebnisse werden seitenweise zurückgegeben. Sie können die weiteren Ergebnisse abrufen, indem Sie den von der getNextToken-Methode des Rückgabeobjekts zurückgegebenen Wert an die setNextToken-Methode des Original-Anforderungsobjekts übergeben. Verwenden Sie dann das gleiche Anforderungsobjekt für den nächsten Aufruf von describeInstances.

Siehe vollständiges Beispiel.

Überwachung einer Instance

Sie können verschiedene Aspekte Ihrer Amazon EC2 Instances überwachen, z. B. die CPU- und Netzwerkauslastung, den verfügbaren Arbeitsspeicher und den verbleibenden Festplattenspeicher. Weitere Informationen zur Instanzüberwachung finden Sie unter Überwachung Amazon EC2 im Amazon EC2 Benutzerhandbuch für Linux-Instances.

Um mit der Überwachung einer Instance zu beginnen, müssen Sie eine MonitorInstancesRequestmit der ID der zu überwachenden Instance erstellen und sie an die monitorInstances Methode des EC2 Amazon-Clients übergeben.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.MonitorInstancesRequest;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

MonitorInstancesRequest request = new MonitorInstancesRequest()
        .withInstanceIds(instance_id);

ec2.monitorInstances(request);

Siehe vollständiges Beispiel.

Anhalten der Instance-Überwachung

Um die Überwachung einer Instance zu beenden, erstellen Sie eine UnmonitorInstancesRequestmit der ID der Instance, deren Überwachung beendet werden soll, und übergeben Sie sie an die unmonitorInstances Methode des EC2 Amazon-Clients.

Importe

import com.amazonaws.services.ec2.AmazonEC2;
import com.amazonaws.services.ec2.AmazonEC2ClientBuilder;
import com.amazonaws.services.ec2.model.UnmonitorInstancesRequest;

Code

final AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

UnmonitorInstancesRequest request = new UnmonitorInstancesRequest()
    .withInstanceIds(instance_id);

ec2.unmonitorInstances(request);

Siehe vollständiges Beispiel.

Weitere Informationen