• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

AWS Auto Scaling 작업

|View as Markdown (English)

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS Auto Scaling 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 Auto Scaling 그룹(ASG)을 관리하십시오 — 인스턴스 연결 및 분리, 용량 조정, 스케일링 정책 실행, 인스턴스 새로 고침 관리, 스케일링 프로세스 제어 및 ASG 상태 쿼리.

전제 조건

사전 요구 사항 및 자격 증명 설정에 대해서는 AWS 자격 증명 설정을 참조하십시오.

인스턴스 연결

작업 식별자는 aws.autoscaling.attachInstances입니다.

기존 Auto Scaling 그룹에 하나 이상의 EC2 인스턴스를 연결하십시오. 인스턴스를 연결하면 연결된 수만큼 원하는 용량이 증가합니다. 호출당 최대 20개의 인스턴스를 연결할 수 있습니다. 인스턴스는 실행 중이거나 중지된 상태여야 하며, 연결 시 그룹의 최대 크기를 초과해서는 안 됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

instanceIds

목록

필수 항목입니다.

연결할 EC2 인스턴스 ID입니다.

["i-0123456789abcdef0", "i-0fedcba9876543210"]

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

attach_instances — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 EC2 인스턴스를 Auto Scaling 그룹에 연결합니다.

워크플로 예

name: asg-attach-instances
workflowInputs:
  arnRole:
    type: String
  asgName:
    type: String
steps:
  - name: attachInstances
    type: action
    action: aws.autoscaling.attachInstances
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: ${{ .workflowInputs.asgName }}
      instanceIds:
        - i-0123456789abcdef0
    next: end

인스턴스 분리

작업 식별자는 aws.autoscaling.detachInstances입니다.

Auto Scaling 그룹에서 하나 이상의 EC2 인스턴스를 분리합니다. 호출당 최대 20개의 인스턴스를 분리할 수 있습니다. 인스턴스는 InService 또는 Standby 상태여야 합니다. shouldDecrementDesiredCapacity이(가) false인 경우, ASG는 원하는 용량을 유지하기 위해 대체 인스턴스를 출시합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

instanceIds

목록

필수 항목입니다.

분리할 EC2 인스턴스 ID입니다.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

부울

필수 항목입니다.

true

인 경우, 분리된 인스턴스 수만큼 원하는 용량을 줄입니다.

false

인 경우, ASG는 교체 항목을 출시합니다.

true

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "activities", "expression": ".response.Activities"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

detach_instances — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제에서는 인스턴스를 분리하고 원하는 용량을 감소시킵니다.

워크플로 예

name: asg-detach-instances
workflowInputs:
  arnRole:
    type: String
steps:
  - name: detachInstances
    type: action
    action: aws.autoscaling.detachInstances
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      instanceIds:
        - i-0123456789abcdef0
      shouldDecrementDesiredCapacity: true
    next: end

원하는 용량 설정

작업 식별자는 aws.autoscaling.setDesiredCapacity입니다.

Auto Scaling 그룹의 원하는 인스턴스 수를 업데이트합니다. 새 값은 그룹의 MinSize과(와) MaxSize 사이에 있어야 합니다. honorCooldown이(가) true인 경우, ASG가 휴지 기간 내에 있으면 요청이 거부됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

desiredCapacity

Int

필수 항목입니다.

인스턴스의 목표 수입니다. 그룹의

MinSize

및

MaxSize

사이여야 합니다.

3

honorCooldown

부울

선택 사항.

true

인 경우, ASG가 휴지 기간에 있을 때 요청을 거부합니다. 기본값은

false

입니다.

false

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

set_desired_capacity ― Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예는 원하는 용량을 5개의 인스턴스로 설정합니다.

워크플로 예

name: asg-set-capacity
workflowInputs:
  arnRole:
    type: String
steps:
  - name: setDesiredCapacity
    type: action
    action: aws.autoscaling.setDesiredCapacity
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      desiredCapacity: 5
      honorCooldown: false
    next: end

스케일링 정책 실행

작업 식별자는 aws.autoscaling.executePolicy입니다.

Auto Scaling 그룹에서 명명된 조정 정책을 실행합니다. 정책이 그룹에 이미 존재해야 합니다. 단계 조정 정책의 경우, metricValue 및 breachThreshold이(가) 정책 임계값을 재정의할 수 있습니다. honorCooldown이(가) true 이고 ASG가 휴지 기간에 있는 경우, 호출은 성공하지만 조정 활동은 트리거되지 않습니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

policyName

문자열

필수 항목입니다.

실행할 조정 정책의 이름 또는 ARN입니다.

"my-scale-out-policy"

honorCooldown

부울

선택 사항.

true

이고 ASG가 쿨다운 상태인 경우, 호출은 성공하지만 스케일링 활동이 트리거되지 않습니다.

false

metricValue

문자열

선택 사항.

단계 조정 정책에 대한 메트릭 값 재정의입니다.

"50.0"

breachThreshold

문자열

선택 사항.

단계 조정 정책에 대한 위반 임계값 재정의입니다.

"70.0"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

execute_policy — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 명명된 스케일 아웃 정책을 실행합니다.

워크플로 예

name: asg-execute-policy
workflowInputs:
  arnRole:
    type: String
steps:
  - name: executePolicy
    type: action
    action: aws.autoscaling.executePolicy
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      policyName: my-scale-out-policy
      honorCooldown: false
    next: end

인스턴스 새로 고침 시작

작업 식별자는 aws.autoscaling.startInstanceRefresh입니다.

최신 출시 템플릿 또는 설정을 사용하여 인스턴스의 롤링 교체를 시작합니다. 그룹당 한 번에 하나의 새로 고침만 활성화할 수 있습니다 ― 이미 진행 중인 경우 호출은 InstanceRefreshInProgress(으)로 실패합니다. 상태를 폴링하려면 aws.autoscaling.describeInstanceRefreshes을(를) 사용하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

전략

문자열

선택 사항.

새로 고침 전략입니다.

"Rolling"

만 지원되는 값입니다.

"Rolling"

기본 설정

지도

선택 사항.

새로 고침 기본 설정입니다.

MinHealthyPercentage

은(는) 교체 중에 정상 상태를 유지하는 인스턴스 수를 제어합니다(기본값 90%).

InstanceWarmup

은(는) 인스턴스가

InService

에 도달한 후 다음 배치를 교체하기 전에 대기할 시간을 설정합니다.

{"MinHealthyPercentage": 90, "InstanceWarmup": 300}

desiredConfiguration

지도

선택 사항.

이 새로 고침에 대한 출시 템플릿 또는 설정을 재정의합니다.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "2"}}

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

새로 고침을 식별하는

InstanceRefreshId

(문자열 UUID)을 포함합니다. 전체 응답 구문은

start_instance_refresh — Boto3 설명서

를 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 최소 정상 인스턴스가 90%인 롤링 인스턴스 새로 고침을 시작합니다.

워크플로 예

name: asg-start-refresh
workflowInputs:
  arnRole:
    type: String
steps:
  - name: startInstanceRefresh
    type: action
    action: aws.autoscaling.startInstanceRefresh
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      strategy: Rolling
      preferences:
        MinHealthyPercentage: 90
        InstanceWarmup: 300
      selectors:
        - name: instanceRefreshId
          expression: '.response.InstanceRefreshId'
    next: end

인스턴스 새로 고침 취소

작업 식별자는 aws.autoscaling.cancelInstanceRefresh입니다.

진행 중인 인스턴스 새로 고침을 취소합니다. 진행 중인 새로 고침만 취소할 수 있습니다 ― 활성 새로 고침이 없을 때 이를 호출하면 ActiveInstanceRefreshNotFound(으)로 실패합니다. 이미 교체된 인스턴스는 되돌려지지 않으며, 교체된 인스턴스를 되돌리려면 aws.autoscaling.rollbackInstanceRefresh을(를) 사용하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

취소된 새로 고침의

InstanceRefreshId

을(를) 포함합니다. 전체 응답 구문은

cancel_instance_refresh — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 진행 중인 인스턴스 새로 고침을 취소합니다.

워크플로 예

name: asg-cancel-refresh
workflowInputs:
  arnRole:
    type: String
steps:
  - name: cancelRefresh
    type: action
    action: aws.autoscaling.cancelInstanceRefresh
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      selectors:
        - name: instanceRefreshId
          expression: '.response.InstanceRefreshId'
    next: end

인스턴스 새로 고침 롤백

작업 식별자는 aws.autoscaling.rollbackInstanceRefresh입니다.

진행 중인 인스턴스 새로 고침을 롤백하여, 교체된 인스턴스를 이전 출시 템플릿 또는 설정으로 되돌립니다. 롤백을 지원하려면 그룹에 체크포인트가 활성화되어 있어야 합니다. 롤백할 수 있는 새로 고침이 없으면 호출이 ActiveInstanceRefreshNotFound(으)로 실패합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

롤백된 새로 고침의

InstanceRefreshId

을(를) 포함합니다. 전체 응답 구문은

rollback_instance_refresh — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 진행 중인 인스턴스 새로 고침을 롤백합니다.

워크플로 예

name: asg-rollback-refresh
workflowInputs:
  arnRole:
    type: String
steps:
  - name: rollbackRefresh
    type: action
    action: aws.autoscaling.rollbackInstanceRefresh
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      selectors:
        - name: instanceRefreshId
          expression: '.response.InstanceRefreshId'
    next: end

조정 프로세스 일시 중지

작업 식별자는 aws.autoscaling.suspendProcesses입니다.

Auto Scaling 그룹에 대한 하나 이상의 조정 프로세스를 일시 중지합니다. 원치 않는 조정 활동을 방지하려면 배포 또는 유지 관리 기간 동안 사용하십시오. scalingProcesses을(를) 생략하면 모든 프로세스가 일시 중지됩니다. 일시 중지된 프로세스는 aws.autoscaling.resumeProcesses을(를) 사용하여 명시적으로 재개될 때까지 일시 중지된 상태로 유지됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

scalingProcesses

목록

선택 사항.

일시 중지할 프로세스입니다. 모든 프로세스를 일시 중지하려면 생략하십시오. 유효한 값:

Launch

,

Terminate

,

HealthCheck

,

ReplaceUnhealthy

,

AZRebalance

,

AlarmNotification

,

ScheduledActions

,

AddToLoadBalancer

,

InstanceRefresh

.

["Launch", "Terminate", "HealthCheck"]

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

suspend_processes — Boto3 문서

를 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 배포 전에 출시, 종료 및 상태 확인 프로세스를 일시 중지합니다.

워크플로 예

name: asg-suspend-for-deploy
workflowInputs:
  arnRole:
    type: String
steps:
  - name: suspendProcesses
    type: action
    action: aws.autoscaling.suspendProcesses
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      scalingProcesses:
        - Launch
        - Terminate
        - HealthCheck
    next: end

스케일링 프로세스 재개

작업 식별자는 aws.autoscaling.resumeProcesses입니다.

하나 이상의 일시 중지된 조정 프로세스를 재개합니다. 정상적인 조정 동작을 복원하려면 배포 또는 유지 관리 기간 후에 사용하십시오. scalingProcesses을(를) 생략하면 일시 중지된 모든 프로세스가 재개됩니다. 현재 일시 중지된 프로세스가 없으면 호출은 성공하지만 아무런 효과가 없습니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

scalingProcesses

목록

선택 사항.

재개할 프로세스입니다. 일시 중지된 모든 프로세스를 재개하려면 생략하십시오.

["Launch", "Terminate", "HealthCheck"]

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

resume_processes — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 배포 후 조정 프로세스를 재개합니다.

워크플로 예

name: asg-resume-after-deploy
workflowInputs:
  arnRole:
    type: String
steps:
  - name: resumeProcesses
    type: action
    action: aws.autoscaling.resumeProcesses
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      scalingProcesses:
        - Launch
        - Terminate
        - HealthCheck
    next: end

그룹 내 인스턴스 종료

작업 식별자는 aws.autoscaling.terminateInstanceInAutoScalingGroup입니다.

수명 주기 후크를 준수하면서 Auto Scaling 그룹의 특정 인스턴스를 종료합니다. 인스턴스를 자동으로 교체하려면 shouldDecrementDesiredCapacity을(를) false (으)로 설정하고, 그룹을 축소하려면 true (으)로 설정하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

instanceId

문자열

필수 항목입니다.

종료할 EC2 인스턴스의 ID입니다.

"i-0123456789abcdef0"

shouldDecrementDesiredCapacity

부울

필수 항목입니다.

true

인 경우, 원하는 용량을 1만큼 줄입니다.

false

인 경우, 교체 인스턴스가 자동으로 출시됩니다.

false

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "activityStatus", "expression": ".response.Activity.StatusCode"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

ActivityId

,

StatusCode

및

Progress

이(가) 포함된

Activity

객체를 포함합니다. 전체 응답 구문은

terminate_instance_in_auto_scaling_group ― Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 비정상 인스턴스를 종료하고 대체 인스턴스를 출시합니다.

워크플로 예

name: asg-terminate-unhealthy-instance
workflowInputs:
  arnRole:
    type: String
steps:
  - name: terminateInstance
    type: action
    action: aws.autoscaling.terminateInstanceInAutoScalingGroup
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      instanceId: i-0123456789abcdef0
      shouldDecrementDesiredCapacity: false
      selectors:
        - name: activityStatus
          expression: '.response.Activity.StatusCode'
    next: end

인스턴스를 대기 상태로 이동하십시오.

작업 식별자는 aws.autoscaling.enterStandby입니다.

하나 이상의 인스턴스를 대기 모드로 이동하여, 종료하지 않고 활성 로테이션에서 제외합니다. 특정 인스턴스에 대한 유지 관리에 사용하십시오. 인스턴스를 서비스로 복귀시키려면 aws.autoscaling.exitStandby와(과) 페어링하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

instanceIds

목록

선택 사항.

대기 상태로 이동할 인스턴스 ID입니다. 모든 인스턴스를 이동하려면 생략하십시오.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

부울

필수 항목입니다.

true

인 경우, 대기 상태로 들어가는 인스턴스 수만큼 원하는 용량을 줄입니다.

true

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "activities", "expression": ".response.Activities"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

각 인스턴스의 대기 전환을 설명하는

Activities

어레이가 포함되어 있습니다. 전체 응답 구문은

enter_standby — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 유지 관리를 위해 인스턴스를 대기 상태로 이동합니다.

워크플로 예

name: asg-enter-standby
workflowInputs:
  arnRole:
    type: String
steps:
  - name: enterStandby
    type: action
    action: aws.autoscaling.enterStandby
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      instanceIds:
        - i-0123456789abcdef0
      shouldDecrementDesiredCapacity: true
    next: end

대기 상태 종료

작업 식별자는 aws.autoscaling.exitStandby입니다.

하나 이상의 인스턴스를 대기 모드에서 활성 로테이션으로 복귀시킵니다. 유지 관리가 완료된 후 aws.autoscaling.enterStandby와(과) 페어링합니다. instanceIds을(를) 생략하면 모든 대기 인스턴스가 서비스로 복귀됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

instanceIds

목록

선택 사항.

활성 로테이션으로 복귀시킬 인스턴스 ID입니다. 모든 인스턴스의 대기 상태를 해제하려면 생략하십시오.

["i-0123456789abcdef0"]

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "activities", "expression": ".response.Activities"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

각 인스턴스의 서비스 복귀를 설명하는

Activities

어레이가 포함되어 있습니다. 전체 응답 구문은

exit_standby — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예는 유지 관리 후 대기 상태에서 인스턴스를 반환합니다.

워크플로 예

name: asg-exit-standby
workflowInputs:
  arnRole:
    type: String
steps:
  - name: exitStandby
    type: action
    action: aws.autoscaling.exitStandby
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      instanceIds:
        - i-0123456789abcdef0
    next: end

예약된 작업 생성 또는 업데이트

작업 식별자는 aws.autoscaling.putScheduledUpdateGroupAction입니다.

Auto Scaling 그룹에 대한 예약된 조정 작업을 생성하거나 업데이트합니다. 크론 기반 일정에는 recurrence을(를) 사용하고 일회성 변경에는 startTime을(를) 사용하십시오. 작업을 제거하려면 aws.autoscaling.deleteScheduledAction와(과) 함께 사용하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

scheduledActionName

문자열

필수 항목입니다.

생성 또는 업데이트할 예약된 작업의 이름입니다.

"scale-down-nights"

시작 시간

문자열

선택 사항.

작업이 적용되는 시점의 ISO 8601 UTC 타임스탬프입니다.

"2024-06-01T20:00:00Z"

종료 시간

문자열

선택 사항.

반복 작업이 중지되는 시점의 ISO 8601 UTC 타임스탬프입니다.

"2024-12-31T23:59:59Z"

recurrence

문자열

선택 사항.

반복되는 일정에 대한 크론 표현식입니다.

"0 20 * * *"

시간대(timeZone)

문자열

선택 사항.

반복 cron 표현식의 IANA 시간대입니다.

"America/New_York"

minSize

Int

선택 사항.

예약된 시간에 적용할 최소 그룹 크기입니다.

1

최대 크기

Int

선택 사항.

예약된 시간에 적용할 최대 그룹 크기입니다.

10

desiredCapacity

Int

선택 사항.

예약된 시간에 적용할 원하는 용량입니다.

2

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

put_scheduled_update_group_action — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 야간 축소 작업을 생성합니다.

워크플로 예

name: asg-create-scheduled-action
workflowInputs:
  arnRole:
    type: String
steps:
  - name: putScheduledAction
    type: action
    action: aws.autoscaling.putScheduledUpdateGroupAction
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      scheduledActionName: scale-down-nights
      recurrence: "0 20 * * *"
      timeZone: America/New_York
      desiredCapacity: 2
      minSize: 1
    next: end

예약된 작업 삭제

작업 식별자는 aws.autoscaling.deleteScheduledAction입니다.

Auto Scaling 그룹에서 예약된 조정 작업을 삭제합니다. 호출당 하나의 작업만 삭제할 수 있습니다. 작업 이름이 존재하지 않으면 호출이 ValidationError(으)로 실패합니다. 작업을 삭제해도 이미 진행 중인 조정 활동에는 영향을 미치지 않습니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

scheduledActionName

문자열

필수 항목입니다.

삭제할 예약된 작업의 이름입니다.

"scale-down-nights"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

delete_scheduled_action — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예는 예약된 조정 작업을 삭제합니다.

워크플로 예

name: asg-delete-scheduled-action
workflowInputs:
  arnRole:
    type: String
steps:
  - name: deleteScheduledAction
    type: action
    action: aws.autoscaling.deleteScheduledAction
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      scheduledActionName: scale-down-nights
    next: end

Auto Scaling 그룹 업데이트

작업 식별자는 aws.autoscaling.updateAutoScalingGroup입니다.

기존 Auto Scaling 그룹의 설정 — 최소/최대 크기, 원하는 용량, 상태 확인 설정, 출시 템플릿 등을 업데이트합니다. 아래에 나열되지 않은 boto3 update_auto_scaling_group API의 추가 필드를 전달하려면 parameters 맵을 사용하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

업데이트할 Auto Scaling 그룹의 이름입니다.

"my-asg"

minSize

Int

선택 사항.

새로운 최소 그룹 크기입니다.

1

최대 크기

Int

선택 사항.

새로운 최대 그룹 크기입니다.

10

desiredCapacity

Int

선택 사항.

새로 원하는 인스턴스 수입니다.

3

defaultCooldown

Int

선택 사항.

초 단위의 기본 재사용 대기 시간입니다.

300

healthCheckType

문자열

선택 사항.

상태 확인 유형입니다. 허용되는 값:

EC2

,

ELB

.

"ELB"

healthCheckGracePeriod

Int

선택 사항.

인스턴스 출시 후 상태 검사가 시작되기 전까지의 시간(초)입니다.

300

매개변수

지도

선택 사항.

위에 나열되지 않은 추가 boto3

update_auto_scaling_group

필드입니다.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "$Latest"}, "TerminationPolicies": ["OldestInstance"]}

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "success", "expression": ".success"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

AWS API 응답 객체입니다. 전체 응답 구문은

update_auto_scaling_group — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 최소/최대 경계, 상태 확인 유형 및 출시 템플릿을 업데이트합니다.

워크플로 예

name: asg-update-group
workflowInputs:
  arnRole:
    type: String
steps:
  - name: updateAutoScalingGroup
    type: action
    action: aws.autoscaling.updateAutoScalingGroup
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      minSize: 2
      maxSize: 20
      desiredCapacity: 5
      healthCheckType: ELB
      healthCheckGracePeriod: 300
      parameters:
        LaunchTemplate:
          LaunchTemplateId: lt-0123456789abcdef0
          Version: $Latest
        TerminationPolicies:
          - OldestInstance
    next: end

Auto Scaling 그룹 설명

작업 식별자는 aws.autoscaling.describeAutoScalingGroups입니다.

하나 이상의 Auto Scaling 그룹을 설명하고, 설정 및 인스턴스 상태를 반환합니다. autoScalingGroupNames을(를) 생략하면, 리전의 모든 그룹이 반환됩니다. 대규모 결과 세트를 페이지로 나누려면 maxRecords 및 nextToken을(를) 사용하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupNames

목록

선택 사항.

설명할 그룹의 이름입니다. 리전의 모든 그룹을 반환하려면 생략하십시오.

["my-asg", "my-other-asg"]

최대 레코드

Int

선택 사항.

반환할 그룹의 최대 수입니다. 최대 100입니다.

10

nextToken

문자열

선택 사항.

이전 응답의 페이지 매김 토큰입니다.

"abcdefgh"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "desiredCapacity", "expression": ".response.AutoScalingGroups[0].DesiredCapacity"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

각 그룹에 대한 설정 및 인스턴스 상태가 포함된

AutoScalingGroups

어레이를 포함합니다. 전체 응답 구문은

describe_auto_scaling_groups — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 그룹의 원하는 용량, 최소, 최대 및 인스턴스 수를 검색합니다.

워크플로 예

name: asg-describe-group
workflowInputs:
  arnRole:
    type: String
steps:
  - name: describeGroups
    type: action
    action: aws.autoscaling.describeAutoScalingGroups
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupNames:
        - my-asg
      selectors:
        - name: desiredCapacity
          expression: '.response.AutoScalingGroups[0].DesiredCapacity'
        - name: minSize
          expression: '.response.AutoScalingGroups[0].MinSize'
        - name: maxSize
          expression: '.response.AutoScalingGroups[0].MaxSize'
        - name: instanceCount
          expression: '.response.AutoScalingGroups[0].Instances | length'
    next: end

인스턴스 새로 고침 설명

작업 식별자는 aws.autoscaling.describeInstanceRefreshes입니다.

Auto Scaling 그룹에 대한 하나 이상의 인스턴스 새로 고침 상태를 설명합니다. aws.autoscaling.startInstanceRefresh에서 시작된 새로 고침을 폴링하는 데 사용하십시오. instanceRefreshIds을(를) 생략하면 그룹의 모든 새로 고침이 최신 항목부터 반환됩니다. 완료, 취소 및 실패한 새로 고침은 기록에 유지됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

필수 항목입니다.

Auto Scaling 그룹의 이름입니다.

"my-asg"

instanceRefreshIds

목록

선택 사항.

설명할 특정 새로 고침의 ID입니다. 그룹의 모든 새로 고침을 가져오려면 생략하십시오.

["08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"]

최대 레코드

Int

선택 사항.

반환할 새로 고침의 최대 수입니다. 기본값은 50, 최대값은 100입니다.

10

nextToken

문자열

선택 사항.

이전 응답의 페이지 매김 토큰입니다.

"abcdefgh"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "status", "expression": ".response.InstanceRefreshes[0].Status"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

Status

,

PercentageComplete

및 기타 새로 고침 세부 정보가 포함된

InstanceRefreshes

어레이를 포함합니다. 전체 응답 구문은

describe_instance_refreshes — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 이전 단계에서 시작된 새로 고침의 상태를 폴링합니다.

워크플로 예

name: asg-poll-refresh
workflowInputs:
  arnRole:
    type: String
steps:
  - name: describeRefresh
    type: action
    action: aws.autoscaling.describeInstanceRefreshes
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      instanceRefreshIds:
        - ${{ .steps.startRefresh.outputs.instanceRefreshId }}
      selectors:
        - name: refreshStatus
          expression: '.response.InstanceRefreshes[0].Status'
        - name: percentComplete
          expression: '.response.InstanceRefreshes[0].PercentageComplete'
    next: end

스케일링 활동 설명

작업 식별자는 aws.autoscaling.describeScalingActivities입니다.

진행 중이거나 최근에 완료된 이벤트를 포함하여 Auto Scaling 그룹의 조정 활동을 설명합니다. activityIds을(를) 생략하면 그룹의 모든 활동이 최신순으로 반환됩니다. 활동에는 성공 및 실패한 스케일 인 및 스케일 아웃 이벤트가 모두 포함됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

선택 사항.

쿼리할 그룹의 이름입니다. 모든 그룹의 활동을 반환하려면 생략하십시오.

"my-asg"

activityIds

목록

선택 사항.

반환할 특정 활동의 ID입니다.

["3b05db05-2f6e-4e86-af95-29f1f4c2a2b7"]

includeDeletedGroups

부울

선택 사항.

true

인 경우 삭제된 그룹의 활동을 포함합니다.

false

최대 레코드

Int

선택 사항.

반환할 활동의 최대 수입니다. 최대 100입니다.

10

nextToken

문자열

선택 사항.

이전 응답의 페이지 매김 토큰입니다.

"abcdefgh"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "latestStatus", "expression": ".response.Activities[0].StatusCode"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

ActivityId

,

StatusCode

,

Cause

및 타이밍 필드가 있는

Activities

어레이를 포함합니다. 전체 응답 구문은

describe_scaling_activities — Boto3 설명서

를 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 가장 최근의 스케일링 활동 5개를 검색합니다.

워크플로 예

name: asg-check-activities
workflowInputs:
  arnRole:
    type: String
steps:
  - name: describeActivities
    type: action
    action: aws.autoscaling.describeScalingActivities
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      maxRecords: 5
      selectors:
        - name: latestActivity
          expression: '.response.Activities[0].StatusCode'
    next: end

예약된 작업 설명

작업 식별자는 aws.autoscaling.describeScheduledActions입니다.

Auto Scaling 그룹에 대해 예약된 스케일링 액션을 설명합니다. scheduledActionNames을(를) 생략하면 그룹의 모든 액션이 반환됩니다. startTime 및 endTime (으)로 필터링하여 결과를 시간 창으로 좁힙니다 — scheduledActionNames이(가) 제공되면 이러한 필터는 무시됩니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

awsRoleArn

문자열

선택 사항.

IAM 역할 ARN입니다. 실행자는 AWS에 인증하기 위해 STS를 통해 이 역할을 맡습니다. 정적 자격 증명보다 권장됩니다. 하나 이상의 인증 필드가 필요합니다.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

문자열

선택 사항.

AWS 액세스 키 ID입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

문자열

선택 사항.

AWS 비밀 액세스 키입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

문자열

선택 사항.

임시 자격 증명을 위한 AWS 세션 토큰입니다. 비밀 참조로 전달되어야 합니다.

${{ :secrets:awsSessionToken }}

지역

문자열

필수 항목입니다.

Auto Scaling 그룹이 위치한 AWS 리전입니다.

"us-east-1"

autoScalingGroupName

문자열

선택 사항.

쿼리할 그룹의 이름입니다. 모든 그룹의 작업을 나열하려면 생략하십시오.

"my-asg"

scheduledActionNames

목록

선택 사항.

반환할 특정 작업의 이름입니다. 알 수 없는 이름은 알림 없이 무시됩니다.

["scale-down-nights", "scale-up-mornings"]

시작 시간

문자열

선택 사항.

결과 필터링을 위한 ISO 8601 UTC 타임스탬프 하한입니다.

"2024-01-01T00:00:00Z"

종료 시간

문자열

선택 사항.

결과 필터링을 위한 ISO 8601 UTC 타임스탬프 상한입니다.

"2024-12-31T23:59:59Z"

최대 레코드

Int

선택 사항.

반환할 액션의 최대 수입니다. 최대 100입니다.

10

nextToken

문자열

선택 사항.

이전 응답의 페이지 매김 토큰입니다.

"abcdefgh"

selectors

목록

선택 사항.

작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "scheduledActions", "expression": ".response.ScheduledUpdateGroupActions"}]

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

response

물체

각 작업에 대한 이름, 반복, 시간대 및 용량 필드가 포함된

ScheduledUpdateGroupActions

어레이를 포함합니다. 전체 응답 구문은

describe_scheduled_actions — Boto3 documentation

을 참조하십시오.

success

부울

true

작업이 성공한 경우이며, 그렇지 않으면

false

입니다.

errorMessage

문자열

작업이 실패한 경우의 오류 메시지입니다. 성공 시

null

입니다.

다음 예제는 그룹에 예약된 모든 작업을 나열합니다.

워크플로 예

name: asg-list-scheduled-actions
workflowInputs:
  arnRole:
    type: String
steps:
  - name: describeScheduledActions
    type: action
    action: aws.autoscaling.describeScheduledActions
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      autoScalingGroupName: my-asg
      selectors:
        - name: scheduledActions
          expression: '.response.ScheduledUpdateGroupActions'
    next: end
Copyright © 2026 New Relic Inc.
채용정보서비스 이용약관DMCA 정책개인정보 고지Website Terms특허 고지현대판 노예법

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.