O AWS SDK para Java 1.x chegou end-of-support em 31 de dezembro de 2025. Recomendamos que você migre para o [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para 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
<a name="run-instance"></a>

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](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html). 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](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withImageId-java.lang.String-)   
   + O ID da AMI. Para saber como encontrar AMIs públicas fornecidas pela Amazon ou criar sua própria, consulte [Imagem de máquina da Amazon (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html).  
 [withInstanceType](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withInstanceType-java.lang.String-)   
   + Um tipo de instância compatível com a AMI especificada. Para obter mais informações, consulte [Tipos de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) no Guia do usuário do Amazon EC2 para instâncias do Linux.  
 [withMinCount](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withMinCount-java.lang.Integer-)   
   + 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](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withMaxCount-java.lang.Integer-)   
   + 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](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withKeyName-java.lang.String-)   
   + 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](create-key-pair.md).  
 [withSecurityGroups](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withSecurityGroups-java.util.Collection-)   
   + Um ou mais security groups. Para obter mais informações, consulte [Criar um grupo de segurança do Amazon EC2](create-security-group.md).

1. Execute as instâncias passando o objeto de requisição para o método [runInstances](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/AmazonEC2Client.html#runInstances-com.amazonaws.services.ec2.model.RunInstancesRequest-). O método retorna um objeto [RunInstancesResult](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesResult.html) 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html) no Guia do usuário do Amazon EC2 para instâncias do Linux.