適用於 Java 的 AWS SDK 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)，以繼續接收新功能、可用性改善和安全性更新。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 執行 Amazon EC2 執行個體
<a name="run-instance"></a>

使用下列程序，從相同的 Amazon Machine Image (AMI) 啟動一或多個設定相同的 EC2 執行個體。建立 EC2 執行個體後，您可以查看他們的狀態。執行 EC2 執行個體之後，您可以連線到執行個體。

1. 建立和初始化 [RunInstancesRequest](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html) 執行個體。請確定您在建立用戶端物件時指定的區域中存在您指定的 AMI、金鑰對和安全群組。

   ```
   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-)   
   + AMI 的 ID。若要了解如何尋找 Amazon 提供的公AMIs 或建立您自己的 AMI，請參閱 [Amazon Machine Image (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-)   
   + 執行個體類型與所指定的 AMI 相容。如需詳細資訊，請參閱《Linux [執行個體使用者指南》中的執行個體類型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)。 Amazon EC2   
 [withMinCount](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withMinCount-java.lang.Integer-)   
   + 要啟動執行個體的最少數量。如果這比 Amazon EC2 可在目標可用區域中啟動的執行個體更多，則 不會 Amazon EC2 啟動任何執行個體。  
 [withMaxCount](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withMaxCount-java.lang.Integer-)   
   + 要啟動執行個體的最大數量。如果這比 Amazon EC2 可在目標可用區域中啟動的執行個體更多， 會在 上方 Amazon EC2 啟動最多的執行個體數量`MinCount`。您可以啟動的範圍數量介於 1 到執行個體類型允許的執行個體最大數量。如需詳細資訊，請參閱 Amazon EC2 一般常見問答集 Amazon EC2 中的我可以在 中執行多少執行個體。  
 [withKeyName](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withKeyName-java.lang.String-)   
   + EC2 金鑰對的名稱。如果您未指定金鑰對而啟動執行個體，則就無法與它連線。如需詳細資訊，請參閱[建立金鑰對](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-)   
   + 一個或多個安全群組。如需詳細資訊，請參閱[建立 Amazon EC2 安全群組](create-security-group.md)。

1. 透過將請求物件傳遞至 [runInstances](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/AmazonEC2Client.html#runInstances-com.amazonaws.services.ec2.model.RunInstancesRequest-) 方法來啟動執行個體。方法會傳回 [RunInstancesResult](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesResult.html) 物件，如下所示：

   ```
   RunInstancesResult result = amazonEC2Client.runInstances(
                                 runInstancesRequest);
   ```

執行個體執行後，您可以使用 金鑰對來連接至執行個體。如需詳細資訊，請參閱《[Linux 執行個體使用者指南》中的連線至您的](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html) Linux 執行個體。 Amazon EC2