

 AWS SDK for Java 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 머신 이미지(AMI)에서 동일하게 구성된 하나 이상의 EC2 인스턴스를 시작합니다. 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에서 제공하는 퍼블릭 AMI 확인 방법을 알아보거나 사용자 자신의 표현식을 생성하려면 [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-)   
   + 지정한 AMI와 호환되는 인스턴스 유형. 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 [인스턴스 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)을 참조하세요.  
 [withMinCount](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/services/ec2/model/RunInstancesRequest.html#withMinCount-java.lang.Integer-)   
   + 시작할 최소 EC2 인스턴스 수. 이 값이 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-)   
   + 시작할 최대 EC2 인스턴스 수. 이 값이 Amazon EC2가 대상 가용 영역에서 시작할 수 있는 인스턴스 수보다 많으면 Amazon EC2는 `MinCount`보다 많은 최대 가능 인스턴스 수를 시작합니다. 1과 인스턴스 유형에 대해 허용된 최대 인스턴스 수 사이에서 시작할 수 있습니다. 자세한 내용은 Amazon EC2 일반적인 FAQ에서 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 인스턴스용 Amazon EC2 사용 설명서에서 [Linux 인스턴스에 연결](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html)을 참조하세요.