이 페이지는 작업우 자동화 작업 카탈로그에서 사용할 수 있는 AWS EC2 작업에 대한 포괄적인 참조 정보를 제공합니다. 이러한 작업을 통해 EC2 인스턴스 및 스냅샷을 관리할 수 있습니다.
전제 조건
블리자드 자동화에서 AWS 작업을 사용하기 전에 다음 사항이 있는지 확인하세요.
- 적절한 권한이 있는 AWS 계정.
- AWS 자격 증명이 구성되었습니다(IAM 사용자 자격 증명, IAM 역할 ARN 또는 세션 자격 증명).
- 사용하려는 특정 AWS 서비스에 필요한 IAM 권한입니다.
IAM 사용자 및 IAM 역할을 만드는 방법과 펠로우 자동화 AWS 작업과 통합하기 위한 정적 및 세션 AWS 자격 증명을 설정하는 방법에 대한 자세한 내용은 AWS 자격 증명 설정을 참조하세요.
권한이 있는 AMI를 사용하여 지정된 수의 인스턴스를 릴리스합니다.
여러 옵션을 지정하거나 기본 옵션을 그대로 둘 수 있습니다. 다음 규칙이 적용됩니다.
서브넷 ID를 지정하지 않으면 기본 VPC에서 기본 서브넷을 자동으로 선택합니다. 기본 VPC가 없는 경우 요청에 서브넷 ID를 지정해야 합니다.
사용자가 구독하지 않은 제품 코드가 AMI에 첨부되어 있는 경우 요청은 실패합니다.
입력 필드
선택성
유형
예시
awsRoleArn
선택 과목
문자열
arn:aws:iam::123456789012:role/my-workflow-roleawsAccessKeyId
선택 과목
문자열
${{ :secrets:<awsAccessKeyId> }}awsSecretAccessKey
선택 과목
문자열
${{ :secrets:<awsSecretAccessKey> }}awsSessionToken
선택 과목
문자열
${{ :secrets:<awsSessionToken> }}지역
필수의
문자열
region: "us-east-2"imageId
필수의
문자열
"ami-0ca4d5db4872d0c28"instanceType
필수의
문자열
"t2.micro"minCount
필수의
Int
1maxCount
필수의
Int
10매개변수
선택 과목
지도
{"EbsOptimized": false,"TagSpecifications": [{"ResourceType": "instance","Tags": [{"Key": "Name","Value": "My-Web-Server"}]}}선택기
선택 과목
목록
[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]중요
다양한 입력을 지원하기 위해
parameters맵은 사용 가능한 모든 선택적 인수를 허용합니다. 이를 통해 여러 필드를 추가하여 동적으로 requests 구성할 수 있습니다.출력 필드
유형
예시
response
물체
응답 구문은 다음을 참조할 수 있습니다: run_instances - Boto3 1.40.50 설명서
성공
부울
success: true | false오류 메시지
문자열
errorMessage: ""워크플로 예
name: ec2_run_instanceworkflowInputs:arnRole:type: Stringrequired: truesteps:- name: RunInstancetype: actionaction: aws.ec2.runInstancesversion: '1'inputs:awsRoleArn: ${{.workflowInputs.arnRole}}region: us-east-2imageId: ami-0ca4d5db4872d0c28instanceType: t2.microminCount: 1maxCount: 1parameters:EbsOptimized: falseTagSpecifications:- ResourceType: instanceTags:- Key: NameValue: My-Test-Instanceselectors:- name: instanceIdexpression: .response.Instances[0].InstanceId
지정된 인스턴스 또는 모든 인스턴스를 설명합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
instanceIds | 선택 과목 | 목록 |
|
필터 | 선택 과목 | 목록 |
|
nextToken | 선택 과목 | 문자열 |
|
최대 결과 | 선택 과목 | Int | 도면 1 |
선택기 | 선택 과목 | 목록 |
|
중요
실행 입력 시 AWS 자격 증명(짧은 자격 증명, 긴 자격 증명, 역할) 중 하나 이상을 제공해야 하며, 역할 자격 증명이 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | 응답 구문은 describe_instances를 참조할 수 있습니다. |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
중요
- 인스턴스 ID를 지정하면 지정된 인스턴스에 대한 정보만 출력됩니다.
- 필터를 지정하면 필터 기준을 충족하는 인스턴스에 대한 정보만 출력됩니다.
- 인스턴스 ID 또는 필터를 지정하지 않으면 모든 인스턴스에 대한 정보가 출력됩니다.
- 측정값
instanceIds은(는)maxResults과(와) 함께 사용할 수 없습니다.
워크플로우 예제 |
|---|
|
이전에 중지한 Amazon EBS 지원 인스턴스를 시작합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
instanceIds | 필수의 | 목록 |
|
선택기 | 선택 과목 | 목록 |
|
팁
작업 입력에서는 AWS 자격 증명(짧은 자격 증명, 긴 자격 증명, 역할) 중 하나 이상을 제공해야 하며, 역할은 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로 예 |
|---|
|
Amazon EBS 기반 인스턴스를 중지합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
instanceIds | 필수의 | 목록 |
|
동면하다 | 선택 과목 | 부울 | 참 또는 거짓 (기본값:
) |
힘 | 선택 과목 | 부울 | 참 또는 거짓 (기본값:
) |
선택기 | 선택 과목 | 목록 |
|
중요
작업 입력에서는 AWS 자격 증명(짧은 자격 증명, 긴 자격 증명, 역할) 중 하나 이상을 제공해야 하며, 역할은 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | 응답 구문은 stop_instances를참조할 수 있습니다. |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로 예 |
|---|
|
지정된 인스턴스의 재부팅을 요청합니다. 이 작업은 비동기적으로 수행됩니다. 즉, 지정된 인스턴스를 재부팅하라는 요청만 대기열에 넣습니다. 인스턴스가 유효하고 사용자에게 속한 경우 작업이 성공합니다. 종료된 인스턴스를 재부팅하라는 요청은 무시됩니다.
인스턴스가 몇 분 내에 정상적으로 종료되지 않으면 Amazon EC2는 하드 재부팅을 수행합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
instanceIds | 필수의 | 목록 |
|
선택기 | 선택 과목 | 목록 |
|
중요
작업 입력에서는 AWS 자격 증명(짧은 자격 증명, 긴 자격 증명, 역할) 중 하나 이상을 제공해야 하며, 역할은 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로 예 |
|---|
|
지정된 인스턴스를 종료합니다. 이 작업은 멱등성을 갖습니다. 인스턴스를 두 번 이상 종료하더라도 각 호출은 모두 성공합니다.
여러 인스턴스를 지정했는데 요청이 실패하면(예: 잘못된 인스턴스 ID 하나로 인해) 인스턴스가 종료되지 않습니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
instanceIds | 필수의 | 목록 |
|
선택기 | 선택 과목 | 목록 |
|
중요
작업 입력에서는 AWS 자격 증명(짧은 자격 증명, 긴 자격 증명, 역할) 중 하나 이상을 제공해야 하며, 역할은 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로 예 |
|---|
|
EBS 볼륨의 스냅샷을 생성하여 Amazon S3에 저장합니다. 스냅샷은 백업, EBS 볼륨 복사본 생성, 인스턴스 종료 전 데이터 저장 등에 사용할 수 있습니다.
원본 EBS 볼륨의 위치에 따라 스냅샷을 생성할 수 있는 위치가 결정됩니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
description | 선택 과목 | 문자열 |
|
전초기지 | 선택 과목 | 문자열 |
|
볼륨ID | 필수의 | 문자열 |
|
태그사양 | 선택 과목 | 목록 |
|
위치 | 선택 과목 | 문자열 |
|
선택기 | 선택 과목 | 목록 |
|
중요
AWS 자격 증명(짧은 버전, 긴 버전, 역할) 중 하나 이상을 입력해야 하며, 역할이 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | 응답 구문은 create_snapshot을 참조할 수 있습니다. |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
지정된 스냅샷을 삭제합니다.
등록된 AMI에서 사용하는 EBS 볼륨의 루트 장치 스냅샷은 삭제할 수 없습니다. 스냅샷을 삭제하려면 먼저 AMI 등록을 해제해야 합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
snapshotId | 필수의 | 문자열 |
|
선택기 | 선택 과목 | 문자열 |
|
팁
AWS 자격 증명(짧은 버전, 긴 버전, 역할) 중 하나 이상을 입력해야 하며, 역할 자격 증명이 다른 자격 증명보다 우선합니다.
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | 응답 없음 응답 구문은 delete_snapshot - Boto3 1.40.55 설명서를 참조하세요. |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로우 예제 |
|---|
|
AWS Bedrock 에이전트를 실행합니다.
입력 필드 | 선택성 | 유형 | 예시 |
|---|---|---|---|
awsRoleArn | 선택 과목 | 문자열 |
|
awsAccessKeyId | 선택 과목 | 문자열 |
|
awsSecretAccessKey | 선택 과목 | 문자열 |
|
awsSessionToken | 선택 과목 | 문자열 |
|
지역 | 필수의 | 문자열 |
|
에이전트ID | 필수의 | 문자열 |
|
에이전트별칭ID | 필수의 | 문자열 |
|
sessionId | 선택 과목 | 문자열 |
|
입력 텍스트 | 필수의 | 문자열 |
|
매개변수 | 선택 과목 | 지도 | |
선택기 | 선택 과목 | 목록 |
|
출력 필드 | 유형 | 예시 |
|---|---|---|
response | 물체 | |
성공 | 부울 |
|
오류 메시지 | 문자열 |
|
워크플로우 예제 |
|---|
|