このページでは、ワークフロー自動化アクション カタログで使用できる AWS EC2 アクションの包括的なリファレンスを提供します。これらのアクションにより、EC2 インスタンスとスナップショットの管理が可能になります。
前提条件
ワークフロー自動化で AWS アクションを使用する前に、次の点を確認してください。
- 適切な権限を持つ AWS アカウント。
- 設定された AWS 認証情報 (IAM ユーザー認証情報、IAM ロール ARN、またはセッション認証情報)。
- 使用する予定の特定のAWSサービスに必要な IAM 権限。
IAM ユーザーおよび IAM ロールを作成する方法、およびワークフロー オートメーションAWSアクションと統合するための静的 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 | 100 |
セレクター | オプション | リスト |
|
重要
アクション入力では、AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを指定する必要があります。ロールが他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | 応答構文については、 describe_instances を参照してください。 |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
重要
- インスタンスIDを指定した場合、出力には指定したインスタンスのみの情報が含まれます。
- フィルターを指定すると、出力にはフィルター条件を満たすインスタンスの情報のみが含まれます。
- インスタンス ID またはフィルターを指定しない場合、出力にはすべてのインスタンスの情報が含まれます。
- パラメーター
instanceIdsはmaxResultsでは使用できません。
ワークフローの例 |
|---|
|
以前に停止した Amazon EBS ベースのインスタンスを起動します。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
instanceIds | 必須 | リスト |
|
セレクター | オプション | リスト |
|
ヒント
アクション入力では、AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを指定する必要があります。ロールは他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | レスポンス構文はstart_instances - Boto3 1.40.50 ドキュメントを参照してください |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|
Amazon EBS ベースのインスタンスを停止します
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
instanceIds | 必須 | リスト |
|
冬眠 | オプション | ブール値 | true または false (デフォルト:
) |
力 | オプション | ブール値 | true または false (デフォルト:
) |
セレクター | オプション | リスト |
|
重要
アクション入力では、AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを指定する必要があります。ロールは他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | レスポンス構文はstop_instancesを参照できます |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|
指定されたインスタンスの再起動を要求します。この操作は非同期であり、指定されたインスタンスを再起動する要求をキューに追加するだけです。インスタンスが有効であり、自分のものである場合、操作は成功します。終了したインスタンスを再起動する要求は無視されます。
インスタンスが数分以内に正常にシャットダウンしない場合、Amazon EC2 はハードリブートを実行します。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
instanceIds | 必須 | リスト |
|
セレクター | オプション | リスト |
|
重要
アクション入力では、AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを指定する必要があります。ロールは他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|
指定されたインスタンスをシャットダウンします。この操作はべき等性があり、インスタンスを複数回終了した場合、各呼び出しは成功します。
複数のインスタンスを指定し、リクエストが失敗した場合 (たとえば、1 つの間違ったインスタンス ID が原因で)、どのインスタンスも終了されません。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
instanceIds | 必須 | リスト |
|
セレクター | オプション | リスト |
|
重要
アクション入力では、AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを指定する必要があります。ロールは他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | レスポンス構文については、 terminate_instances - Boto3 1.40.50 ドキュメントを参照してください。 |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|
EBS ボリュームのスナップショットを作成し、Amazon S3 に保存します。スナップショットは、バックアップ、EBS ボリュームのコピーの作成、インスタンスをシャットダウンする前にデータの保存に使用できます。
ソース EBS ボリュームの場所によって、スナップショットを作成できる場所が決まります。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
description | オプション | 弦 |
|
前哨基地アーン | オプション | 弦 |
|
ボリュームID | 必須 | 弦 |
|
タグ仕様 | オプション | リスト |
|
位置 | オプション | 弦 |
|
セレクター | オプション | リスト |
|
重要
AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを入力する必要があります。ロールが他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | 応答構文についてはcreate_snapshot を参照してください。 |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
指定されたスナップショットを削除します。
登録された AMI によって使用される EBS ボリュームのルートデバイスのスナップショットを削除することはできません。スナップショットを削除する前に、まず AMI を登録解除する必要があります。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
snapshotId | 必須 | 弦 |
|
セレクター | オプション | 弦 |
|
ヒント
AWS 認証情報 (ショート、ロング、ロール) の少なくとも 1 つを入力する必要があります。ロールは他の認証情報よりも優先されます。
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | 応答なしの場合 応答構文については、 delete_snapshot - Boto3 1.40.55 ドキュメントを参照してください。 |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|
AWS Bedrock エージェントを呼び出します。
入力フィールド | オプション性 | タイプ | 例 |
|---|---|---|---|
awsRoleArn | オプション | 弦 |
|
awsAccessKeyId | オプション | 弦 |
|
awsSecretAccessKey | オプション | 弦 |
|
awsSessionToken | オプション | 弦 |
|
リージョン | 必須 | 弦 |
|
エージェントID | 必須 | 弦 |
|
エージェントエイリアスID | 必須 | 弦 |
|
セッションID | オプション | 弦 |
|
入力テキスト | 必須 | 弦 |
|
パラメーター | オプション | 地図 | |
セレクター | オプション | リスト |
|
出力フィールド | タイプ | 例 |
|---|---|---|
response | オブジェクト | |
成功 | ブール値 |
|
エラーメッセージ | 弦 |
|
ワークフローの例 |
|---|
|