Executar uma instância do Amazon EC2 - AWS SDK for Java 1.x

O AWS SDK for Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e chegará end-of-supportem 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.xpara continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Executar uma instância do Amazon EC2

Use o procedimento a seguir para executar uma ou mais instâncias do EC2 configuradas de maneira idêntica na mesma Amazon Machine Image (AMI – Imagem de máquina da Amazon). Depois de criar as instâncias do EC2, você poderá verificar o status. Depois que as instâncias do EC2 estiverem em execução, você poderá se conectar a elas.

  1. Crie e inicialize uma instância de RunInstancesRequest. Verifique se a AMI, o par de chaves e o security group especificados por você existem na região especificada quando criou o objeto de cliente.

    RunInstancesRequest runInstancesRequest =
   new RunInstancesRequest();

runInstancesRequest.withImageId("ami-a9d09ed1")
                   .withInstanceType(InstanceType.T1Micro)
                   .withMinCount(1)
                   .withMaxCount(1)
                   .withKeyName("my-key-pair")
                   .withSecurityGroups("my-security-group");
    withImageId
    withInstanceType

    • Um tipo de instância compatível com a AMI especificada. Para obter mais informações, consulte Tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Linux.

    withMinCount

    • O número mínimo de instâncias do EC2 a serem executadas. Se isso for mais instâncias do que o Amazon EC2 pode executar na zona de disponibilidade de destino, o Amazon EC2 não executará nenhuma instância.

    withMaxCount

    • O número máximo de instâncias do EC2 a serem executadas. Se isso for mais instâncias do que o Amazon EC2 pode executar na zona de disponibilidade de destino, o Amazon EC2 executará o maior número possível de instâncias acima de MinCount. É possível executar entre 1 e o número máximo de instâncias às quais você tem permissão para o tipo de instância. Para obter mais informações, consulte Quantas instâncias posso executar no Amazon EC2 nas perguntas frequentes do Amazon EC2.

    withKeyName

    • O nome do par de chaves do EC2. Se você iniciar uma instância sem especificar um par de chaves, não poderá se conectar a ela. Para obter mais informações, consulte Criar um par de chaves.

    withSecurityGroups

  2. Execute as instâncias passando o objeto de requisição para o método runInstances. O método retorna um objeto RunInstancesResult da seguinte forma:

    RunInstancesResult result = amazonEC2Client.runInstances(
                              runInstancesRequest);

Depois que a instância estiver em execução, você poderá se conectar a ela usando o par de chaves. Para obter mais informações, consulte Conectar-se à sua instância do Linux no Guia do usuário do Amazon EC2 para instâncias do Linux.