AWS EC2 작업

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS EC2 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 EC2 인스턴스 및 EBS 스냅샷을 관리하십시오.

전제 조건

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

인스턴스 실행

작업 식별자는 aws.ec2.runInstances입니다.

권한이 있는 AMI를 사용하여 지정된 수의 인스턴스를 출시합니다. 서브넷 ID를 지정하지 않으면 기본 VPC 서브넷이 사용됩니다. 사용자가 구독하지 않은 제품 코드가 AMI에 있는 경우 요청이 실패합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 출시될 AWS 리전입니다.	`us-east-2`
`imageId`	문자열	필수 항목입니다. 인스턴스에 사용할 AMI의 ID입니다.	`ami-0ca4d5db4872d0c28`
`instanceType`	문자열	필수 항목입니다. 인스턴스에 사용할 인스턴스 유형입니다.	`t2.micro`
`minCount`	Int	필수 항목입니다. 출시할 인스턴스의 최소 수입니다.	`1`
`maxCount`	Int	필수 항목입니다. 출시할 인스턴스의 최대 수입니다.	`10`
`parameters`	지도	선택 사항. run_instances 호출을 위한 추가 boto3 API 파라미터입니다.	`{"EbsOptimized": false, "TagSpecifications": [{"ResourceType": "instance", "Tags": [{"Key": "Name", "Value": "My-Web-Server"}]}]}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

팁

parameters 맵은 boto3 API에서 사용할 수 있는 모든 선택적 인수를 허용하므로 동적으로 requests를 구성할 수 있습니다.

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	run_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`""`

산출

유형

예시

response

물체

run_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

""

설명하기

작업 식별자는 aws.ec2.describeInstances입니다.

지정된 인스턴스 또는 모든 인스턴스를 설명합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 위치한 AWS 리전입니다.	`us-east-2`
`instanceIds`	목록	선택 사항. 설명할 인스턴스 ID 목록입니다.	`["i-0123456789abcdef0", "i-0fedcba9876543210"]`
`filters`	목록	선택 사항. describe 요청에 적용할 필터입니다.	`[{"Name": "instance-state-name", "Values": ["running"]}]`
`nextToken`	문자열	선택 사항. 이전 응답의 페이지 매김 토큰입니다.	`abcdefgh`
`maxResults`	Int	선택 사항. 반환할 결과의 최대 수입니다.	`100`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	describe_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"The parameter instancesSet cannot be used with the parameter maxResults"`

산출

유형

예시

response

물체

describe_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"The parameter instancesSet cannot be used with the parameter maxResults"

중요

인스턴스 ID를 지정하면 출력에 지정된 인스턴스에 대한 정보만 포함됩니다. 필터를 지정하면 출력에 필터 기준을 충족하는 인스턴스에 대한 정보만 포함됩니다. 둘 다 지정하지 않으면 출력에 모든 인스턴스에 대한 정보가 포함됩니다. instanceIds 파라미터는 maxResults과(와) 함께 사용할 수 없습니다.

인스턴스 재시작

작업 식별자는 aws.ec2.startInstances입니다.

이전에 중지한 Amazon EBS 지원 인스턴스를 시작합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 위치한 AWS 리전입니다.	`us-east-2`
`instanceIds`	목록	필수 항목입니다. 시작할 인스턴스 ID 목록입니다.	`["i-0123456789abcdef0", "i-0fedcba9876543210"]`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	start_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"The parameter instancesSet cannot be used with the parameter maxResults"`

산출

유형

예시

response

물체

start_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"The parameter instancesSet cannot be used with the parameter maxResults"

인스턴스를 중지합니다.

작업 식별자는 aws.ec2.stopInstances입니다.

Amazon EBS 기반 인스턴스를 중지합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 위치한 AWS 리전입니다.	`us-east-2`
`instanceIds`	목록	필수 항목입니다. 중지할 인스턴스 ID 목록입니다.	`["i-0123456789abcdef0", "i-0fedcba9876543210"]`
`hibernate`	부울	선택 사항. 인스턴스를 중지하는 대신 Hibernate 하십시오. 기본값: `false` .	`false`
`force`	부울	선택 사항. 인스턴스를 강제 중지하십시오. 기본값: `false` .	`false`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	stop_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"An error occurred (InvalidInstanceID.Malformed) when calling the StopInstances operation: The instance ID 'i-123456789' is malformed"`

산출

유형

예시

response

물체

stop_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"An error occurred (InvalidInstanceID.Malformed) when calling the StopInstances operation: The instance ID 'i-123456789' is malformed"

인스턴스 재부팅을 요청합니다

작업 식별자는 aws.ec2.rebootInstances입니다.

지정된 인스턴스의 재부팅을 요청합니다. 이 작업은 비동기입니다 ― 지정된 인스턴스를 재부팅하라는 요청을 대기열에 넣기만 합니다. 인스턴스가 유효하고 사용자에게 속해 있으면 작업이 성공합니다. 종료된 인스턴스를 재부팅하라는 요청은 무시됩니다. 인스턴스가 몇 분 내에 정상적으로 종료되지 않으면 Amazon EC2에서 하드 재부팅을 수행합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 위치한 AWS 리전입니다.	`us-east-2`
`instanceIds`	목록	필수 항목입니다. 재부팅할 인스턴스 ID 목록입니다.	`["i-0123456789abcdef0", "i-0fedcba9876543210"]`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	reboot_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`""`

산출

유형

예시

response

물체

reboot_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

""

인스턴스를 종료합니다

작업 식별자는 aws.ec2.terminateInstances입니다.

지정된 인스턴스를 종료합니다. 이 작업은 멱등적 입니다 ― 인스턴스를 두 번 이상 종료해도 각 호출은 성공합니다. 여러 인스턴스를 지정하고 요청이 실패하는 경우(예: 단일 인스턴스 ID가 잘못되었기 때문), 인스턴스가 하나도 종료되지 않습니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 인스턴스가 위치한 AWS 리전입니다.	`us-east-2`
`instanceIds`	목록	필수 항목입니다. 종료할 인스턴스의 ID입니다.	`["i-0123456789abcdef0", "i-0fedcba9876543210"]`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	terminate_instances boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"An error occurred (InvalidInstanceID.Malformed) when calling the TerminateInstances operation: The instance ID 'i-012345678' is malformed"`

산출

유형

예시

response

물체

terminate_instances boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"An error occurred (InvalidInstanceID.Malformed) when calling the TerminateInstances operation: The instance ID 'i-012345678' is malformed"

EBS 스냅샷을 생성합니다.

작업 식별자는 aws.ec2.createSnapshot입니다.

EBS 볼륨의 스냅샷을 생성하여 Amazon S3에 저장합니다. 스냅샷을 백업용으로 사용하거나, EBS 볼륨의 복사본을 만들거나, 인스턴스를 종료하기 전에 데이터를 저장하는 데 사용할 수 있습니다. 소스 EBS 볼륨의 위치에 따라 스냅샷을 생성할 수 있는 위치가 결정됩니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. EBS 볼륨이 위치한 AWS 리전입니다.	`us-east-2`
`volumeId`	문자열	필수 항목입니다. 스냅샷을 생성할 EBS 볼륨의 ID입니다.	`vol-0123456789abcdef0`
`description`	문자열	선택 사항. 스냅샷에 대한 설명입니다.	`This is a test snapshot`
`outpostArn`	문자열	선택 사항. 스냅샷을 생성할 Outpost의 Amazon Resource Name(ARN)입니다.	`arn:aws:ec2:us-east-1:123456789012:outpost/op-1a2b3c4d5e6f7g8h9`
`tagSpecifications`	목록	선택 사항. 생성 시 스냅샷에 적용할 태그입니다.	`[{"ResourceType":"snapshot","Tags":[{"Key":"testKey","Value":"testValue"}]}]`
`location`	문자열	선택 사항. 스냅샷의 위치입니다. 유효한 값: `regional` , `local` .	`regional`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	create_snapshot boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`""`

산출

유형

예시

response

물체

create_snapshot boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

""

스냅샷을 삭제하세요

작업 식별자는 aws.ec2.deleteSnapshot입니다.

지정된 스냅샷을 삭제합니다. 등록된 AMI에서 사용하는 EBS 볼륨의 루트 디바이스 스냅샷은 삭제할 수 없습니다 ― 스냅샷을 삭제하려면 먼저 AMI를 등록 취소해야 합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 스냅샷이 위치한 AWS 리전입니다.	`us-east-2`
`snapshotId`	문자열	필수 항목입니다. 삭제할 스냅샷의 ID입니다.	`snapshot-id-1`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	성공 시 응답 본문이 없습니다. delete_snapshot boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"Failed to delete snapshot"`

산출

유형

예시

response

물체

성공 시 응답 본문이 없습니다.

delete_snapshot boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"Failed to delete snapshot"

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

전제 조건.css-21sua1{background:none;border:none;width:0;padding:0;}

인스턴스 실행

팁

설명하기

중요

인스턴스 재시작

인스턴스를 중지합니다.

인스턴스 재부팅을 요청합니다

인스턴스를 종료합니다

EBS 스냅샷을 생성합니다.

스냅샷을 삭제하세요

전제 조건