aws:changeInstanceState - 인스턴스 상태 변경 또는 어설션 - AWS Systems Manager

aws:changeInstanceState - 인스턴스 상태 변경 또는 어설션

인스턴스의 상태를 변경하거나 어설션합니다.

이 작업은 어설션 모드에서 사용될 수 있습니다(API를 실행하여 상태를 변경하는 것이 아니라 인스턴스가 원하는 상태에 있는지 확인함). 어설션 모드를 사용하려면 CheckStateOnly 파라미터를 true로 설정합니다. 이 모드는 배경에서 장시간 실행할 수 있는 비동기식 명령인 Sysprep 명령을 Windows에서 실행할 때 유용합니다. Amazon Machine Image(AMI)를 생성하기 전에 인스턴스가 중지되게 할 수 있습니다.

참고

이 작업의 기본 제한 시간 값은 3600초(1시간)입니다. aws:changeInstanceState 단계에서 timeoutSeconds 파라미터를 지정하여 제한 시간을 제한 또는 연장할 수 있습니다.

입력

YAML
name: stopMyInstance
action: aws:changeInstanceState
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  InstanceIds:
  - i-1234567890abcdef0
  CheckStateOnly: true
  DesiredState: stopped
JSON
{
    "name":"stopMyInstance",
    "action": "aws:changeInstanceState",
    "maxAttempts": 3,
    "timeoutSeconds": 3600,
    "onFailure": "Abort",
    "inputs": {
        "InstanceIds": ["i-1234567890abcdef0"],
        "CheckStateOnly": true,
        "DesiredState": "stopped"
    }
}
InstanceIds

인스턴스의 ID.

유형: StringList

필수 여부: 예

CheckStateOnly

false인 경우 인스턴스 상태를 원하는 상태로 설정합니다. true인 경우 폴링을 사용하여 원하는 상태를 어설션합니다.

기본값: false

타입: 부울

필수 항목 여부: 아니요

DesiredState

원하는 상태. running으로 설정하는 경우 이 작업은 완료하기 전에 Amazon EC2 상태가 Running, 인스턴스 상태가 OK 그리고 시스템 상태가 OK가 될 때까지 기다립니다.

유형: 문자열

유효한 값: running | stopped | terminated

필수 여부: 예

Force

설정되면 인스턴스가 중지합니다. 인스턴스는 파일 시스템 캐시 또는 파일 시스템 메타데이터를 플러시하지 않습니다. 이 옵션을 사용하는 경우 파일 시스템 확인 및 복구 절차를 수행해야 합니다. 이 옵션은 Windows Server용 EC2 인스턴스에는 권장하지 않습니다.

타입: 부울

필수 항목 여부: 아니요

AdditionalInfo

예약.

유형: 문자열

필수 항목 여부: 아니요

출력

None