aws:runInstances - Amazon EC2 인스턴스 시작

새로운 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스를 시작합니다.

입력

이 작업은 대다수 API 파라미터를 지원합니다. 자세한 내용은 RunInstances API 문서를 참조하십시오.

YAML

name: launchInstance
action: aws:runInstances
maxAttempts: 3
timeoutSeconds: 1200
onFailure: Abort
inputs:
  ImageId: ami-12345678
  InstanceType: t2.micro
  MinInstanceCount: 1
  MaxInstanceCount: 1
  IamInstanceProfileName: myRunCmdRole
  TagSpecifications:
  - ResourceType: instance
    Tags:
    - Key: LaunchedBy
      Value: SSMAutomation
    - Key: Category
      Value: HighAvailabilityFleetHost

JSON

{
   "name":"launchInstance",
   "action":"aws:runInstances",
   "maxAttempts":3,
   "timeoutSeconds":1200,
   "onFailure":"Abort",
   "inputs":{
      "ImageId":"ami-12345678",
      "InstanceType":"t2.micro",
      "MinInstanceCount":1,
      "MaxInstanceCount":1,
      "IamInstanceProfileName":"myRunCmdRole",
      "TagSpecifications":[
         {
            "ResourceType":"instance",
            "Tags":[
               {
                  "Key":"LaunchedBy",
                  "Value":"SSMAutomation"
               },
               {
                  "Key":"Category",
                  "Value":"HighAvailabilityFleetHost"
               }
            ]
         }
      ]
   }
}

AdditionalInfo

예약.

유형: 문자열

필수 항목 여부: 아니요

BlockDeviceMappings

해당 인스턴스용 블록 디바이스.

형식: MapList

필수 항목 여부: 아니요

ClientToken

요청의 멱등성을 보장하는 식별자.

유형: 문자열

필수 항목 여부: 아니요

DisableApiTermination

인스턴스 API 종료를 설정하거나 해제합니다.

유형: Boolean

필수 항목 여부: 아니요

EbsOptimized

Amazon Elastic Block Store(Amazon EBS) 최적화를 설정하거나 해제합니다.

유형: Boolean

필수 항목 여부: 아니요

IamInstanceProfileArn

인스턴스에 대한 AWS Identity and Access Management(IAM) 인스턴스 프로파일의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

필수 항목 여부: 아니요

IamInstanceProfileName

인스턴스용 IAM 인스턴스 프로파일의 이름입니다.

유형: 문자열

필수 항목 여부: 아니요

ImageId

Amazon Machine Image(AMI)의 ID입니다.

유형: 문자열

필수 항목 여부: 예

InstanceInitiatedShutdownBehavior

시스템 종료 시 인스턴스를 중지할지 종료할지 나타냅니다.

유형: 문자열

필수 항목 여부: 아니요

InstanceType

인스턴스 유형.

참고

인스턴스 유형 값이 제공되지 않은 경우에는 m1 스몰 인스턴스 유형이 사용됩니다.

유형: 문자열

필수 항목 여부: 아니요

KernelId

커널 ID.

유형: 문자열

필수 항목 여부: 아니요

KeyName

키 페어 이름.

유형: 문자열

필수 항목 여부: 아니요

MaxInstanceCount

시작되는 인스턴스의 최대 수.

유형: 문자열

필수 항목 여부: 아니요

MetadataOptions

인스턴스에 대한 메타데이터 옵션입니다. 자세한 내용은 InstanceMetadataOptionsRequest를 참조하세요.

형식: StringMap

필수 항목 여부: 아니요

MinInstanceCount

시작되는 인스턴스의 최소 수.

유형: 문자열

필수 항목 여부: 아니요

모니터링(Monitoring)

세부 모니터링을 설정하거나 해제합니다.

유형: Boolean

필수 항목 여부: 아니요

NetworkInterfaces

네트워크 인터페이스.

형식: MapList

필수 항목 여부: 아니요

Placement

인스턴스 배치.

형식: StringMap

필수 항목 여부: 아니요

PrivateIpAddress

기본 IPv4 주소.

유형: 문자열

필수 항목 여부: 아니요

RamdiskId

RAM 디스크 ID.

유형: 문자열

필수 항목 여부: 아니요

SecurityGroupIds

인스턴스에 대한 보안 그룹의 ID.

형식: StringList

필수 항목 여부: 아니요

SecurityGroups

인스턴스에 대한 보안 그룹의 이름.

형식: StringList

필수 항목 여부: 아니요

SubnetId

서브넷 ID.

유형: 문자열

필수 항목 여부: 아니요

TagSpecifications

시작 시 리소스에 적용되는 태그. 시작 시에만 인스턴스와 볼륨에 태그를 지정할 수 있습니다. 지정된 태그는 시작 시 생성된 모든 인스턴스 또는 볼륨에 적용됩니다. 시작된 후 인스턴스에 태그를 지정하려면 aws:createTags - AWS 리소스에 대한 태그 생성 작업을 사용합니다.

형식: MapList. 자세한 내용은 TagSpecification을 참조하십시오.

필수 항목 여부: 아니요

UserData

문자열 리터럴 값으로 제공된 스크립트입니다. 리터럴 값이 입력되면 Base64로 인코딩되어야 합니다.

유형: 문자열

필수 항목 여부: 아니요

출력

InstanceIds

인스턴스의 ID.

InstanceStates

인스턴스의 현재 상태입니다.