AWS EC2 アクション

このページでは、ワークフロー自動化アクションカタログで利用可能なAWS EC2アクションのリファレンスを提供します。これらのアクションを使用して、EC2インスタンス、EBSボリュームとスナップショット、Elastic IPアドレス、Amazon Machine Images（AMI）、セキュリティグループ、キーペア、およびEC2リソースタグを管理します。

前提条件

ワークフロー自動化で AWS アクションを使用する前に、次の点を確認してください。

適切な権限を持つ AWS アカウント。
設定された AWS 認証情報 (IAM ユーザー認証情報、IAM ロール ARN、またはセッション認証情報)。
使用する予定の特定のAWSサービスに必要な IAM 権限。

IAM ユーザーおよび IAM ロールを作成する方法、およびワークフローオートメーションAWSアクションと統合するための静的 AWS 認証情報とセッションAWS認証情報を設定する方法については、 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-backed インスタンスを停止します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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です。

指定されたインスタンスをシャットダウンします。この操作はべき等です — インスタンスを複数回終了しても、各呼び出しは成功します。複数のインスタンスを指定してリクエストが失敗した場合（たとえば、1つの誤ったインスタンス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リソースネーム（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"

Elastic IP アドレスの割り当て

アクション識別子はaws.ec2.allocateAddressです。

VPC内のEC2インスタンスで使用する新しいElastic IPアドレスを割り当てます。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`domain`	弦	オプション。アドレスのスコープ。VPCインスタンスには `vpc` を使用します。	`vpc`
`address`	弦	オプション。以前に解放した、復元対象の特定のElastic IPアドレス。	`203.0.113.25`
`networkBorderGroup`	弦	オプション。IPアドレスがアドバタイズされるグループを制限します。	`us-east-2`
`tagSpecifications`	リスト	オプション。割り当て時にアドレスに適用されるタグ。	`[{"ResourceType": "elastic-ip", "Tags": [{"Key": "Name", "Value": "nat-eip"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "allocationId", "expression": ".response.AllocationId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	allocate_address boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

allocate_address boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

Elastic IPアドレスを関連付ける

アクション識別子はaws.ec2.associateAddressです。

Elastic IPアドレスを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`
`allocationId`	弦	オプション。関連付けるElastic IP割り当てID。VPCインスタンスの場合は、 `instanceId` または `networkInterfaceId` とともに使用します。	`eipalloc-0123456789abcdef0`
`instanceId`	弦	オプション。アドレスを関連付けるインスタンス。	`i-0123456789abcdef0`
`publicIp`	弦	オプション。EC2-Classicアドレスの `allocationId` の代替。	`203.0.113.25`
`networkInterfaceId`	弦	オプション。インスタンスの代わりとなるターゲットネットワークインターフェイス。	`eni-0123456789abcdef0`
`privateIpAddress`	弦	オプション。関連付けるネットワークインターフェイス上の特定のプライベートIP。	`10.0.1.25`
`allowReassociation`	ブール値	オプション。アドレスを既存の関連付けから移動できるようにします。デフォルト： `false` 。	`false`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "associationId", "expression": ".response.AssociationId"}]`

重要

識別子の特定の組み合わせのみが有効です。VPCインスタンスの場合は、allocationIdをinstanceIdまたはnetworkInterfaceIdとともに使用します。EC2-Classicインスタンスの場合は、publicIpとinstanceIdを使用してください。2つの形式を混在させないでください。

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	associate_address boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

associate_address boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

Elastic IPアドレスの関連付け解除

アクション識別子はaws.ec2.disassociateAddressです。

現在のインスタンスまたはネットワークインターフェイスからElastic IPアドレスの関連付けを解除します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`associationId`	弦	オプション。 `aws.ec2.associateAddress` によって返される関連付けID。VPCアドレスに使用します。	`eipassoc-0123456789abcdef0`
`publicIp`	弦	オプション。EC2-Classicアドレスの `associationId` の代替。	`203.0.113.25`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

重要

アドレスが関連付けられたドメインに一致する識別子を1つだけ使用します。VPCアドレスの場合は、associationIdを使用します。EC2-Classicアドレスの場合は、publicIpを使用します。

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	成功時のレスポンス本文はありません。 disassociate_address boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

成功時のレスポンス本文はありません。

disassociate_address boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

Elastic IPアドレスを解放する

アクション識別子はaws.ec2.releaseAddressです。

Elastic IPアドレスをAWSプールに解放します。アドレスを解放するには、事前に関連付けを解除しておく必要があります。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`allocationId`	弦	オプション。解放するVPCアドレスのアロケーションID。	`eipalloc-0123456789abcdef0`
`publicIp`	弦	オプション。EC2-Classicアドレスの `allocationId` の代替。	`203.0.113.25`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	成功時のレスポンスボディはありません。 release_address boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

成功時のレスポンスボディはありません。

release_address boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

Elastic IPアドレスを記述します。

アクション識別子はaws.ec2.describeAddressesです。

Elastic IPアドレスとその現在の関連付けについて説明します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`publicIps`	リスト	オプション。結果をこれらのパブリックIPアドレスに制限します。	`["203.0.113.25"]`
`allocationIds`	リスト	オプション。結果をこれらの割り当てIDに制限します。	`["eipalloc-0123456789abcdef0"]`
`filters`	リスト	オプション。クエリに適用するAWSフィルター。	`[{"Name": "domain", "Values": ["vpc"]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "addresses", "expression": ".response.Addresses"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	describe_addresses boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

describe_addresses boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

タグを作成

アクション識別子はaws.ec2.createTagsです。

任意のEC2リソース — インスタンス、ボリューム、スナップショット、セキュリティグループ、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`
`resources`	リスト	必須。タグ付けするEC2リソースのID。	`["i-0123456789abcdef0"]`
`tags`	リスト	必須。適用するタグのキーの値のペア。	`[{"Key": "Name", "Value": "app-server"}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	成功した場合、レスポンス本文はありません。 create_tags boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

create_tags boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

タグを削除

アクション識別子はaws.ec2.deleteTagsです。

任意のEC2リソースからタグを削除します。指定されたリソースからすべてのタグを削除するには、tagsフィールドを省略します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`resources`	リスト	必須。タグを削除するEC2リソースのID。	`["i-0123456789abcdef0"]`
`tags`	リスト	オプション。削除するタグ。値に関係なくキーを削除するには、 `Value` を省略します。すべてのタグを削除するには、フィールドを完全に省略します。	`[{"Key": "Name"}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	成功した場合、レスポンス本文はありません。 delete_tags boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

delete_tags boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

タグの説明

アクション識別子はaws.ec2.describeTagsです。

リソースID、リソースタイプ、キー、または値によるオプションのフィルタリングを使用して、任意の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`
`filters`	リスト	オプション。クエリに適用されるAWSフィルター。 `resource-id` 、 `resource-type` 、 `key` または `value` でフィルタリングします。	`[{"Name": "resource-id", "Values": ["i-0123456789abcdef0"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返すタグの最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "tags", "expression": ".response.Tags"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	describe_tags boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

describe_tags boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームの作成

アクション識別子はaws.ec2.createVolumeです。

指定されたアベイラビリティーゾーンに新しい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`
`availabilityZone`	弦	必須。ボリュームを作成するアベイラビリティーゾーンです。	`us-east-2a`
`size`	Int	オプション。GiB単位のボリュームサイズ。 `snapshotId` が指定されていない場合は必須です。	`100`
`volumeType`	弦	オプション。EBSボリュームタイプ。有効な値： `gp2` 、 `gp3` 、 `io1` 、 `io2` 、 `st1` 、 `sc1` 、 `standard` 。デフォルト： `gp2` 。	`gp3`
`snapshotId`	弦	オプション。ボリュームの復元元となるスナップショット。	`snap-0123456789abcdef0`
`iops`	Int	オプション。プロビジョンドIOPS。 `gp3` 、 `io1` 、および `io2` ボリュームにのみ有効です。	`3000`
`throughput`	Int	オプション。MiB/s単位のスループット。 `gp3` ボリュームにのみ有効です。	`125`
`tagSpecifications`	リスト	オプション。作成時にボリュームに適用されるタグ。	`[{"ResourceType": "volume", "Tags": [{"Key": "Name", "Value": "app-data"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "volumeId", "expression": ".response.VolumeId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	create_volume boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

create_volume boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームの削除

アクション識別子はaws.ec2.deleteVolumeです。

EBSボリュームを削除します。ボリュームを削除する前に、ボリュームはavailable状態（完全にデタッチ済み）である必要があります。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`volumeId`	弦	必須。削除するボリュームのID。	`vol-0123456789abcdef0`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	成功時のレスポンスボディはありません。 delete_volume boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

成功時のレスポンスボディはありません。

delete_volume boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームのアタッチ

アクション識別子はaws.ec2.attachVolumeです。

実行中または停止中のEC2インスタンスに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`
`volumeId`	弦	必須。アタッチするボリュームのIDです。 `available` 状態である必要があります。	`vol-0123456789abcdef0`
`instanceId`	弦	必須。アタッチするインスタンス。 `running` または `stopped` である必要があります。	`i-0123456789abcdef0`
`device`	弦	必須。インスタンス上でボリュームが公開されるデバイス名。	`/dev/sdf`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "attachmentState", "expression": ".response.State"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	attach_volume boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

attach_volume boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームのデタッチ

アクション識別子はaws.ec2.detachVolumeです。

EC2インスタンスから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`
`volumeId`	弦	必須。デタッチするボリュームのIDです。	`vol-0123456789abcdef0`
`instanceId`	弦	オプション。デタッチを特定のインスタンスに絞り込みます。ボリュームがマルチアタッチされている場合に便利です。	`i-0123456789abcdef0`
`device`	弦	オプション。デタッチをインスタンス上の特定のデバイス名に絞り込みます。	`/dev/sdf`
`force`	ブール値	オプション。ゲストOSからアンマウントせずにデタッチを強制します。データ損失やファイルシステムの破損を引き起こす可能性があります。デフォルト： `false` 。	`false`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "detachmentState", "expression": ".response.State"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	detach_volume boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

detach_volume boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームの変更

アクション識別子はaws.ec2.modifyVolumeです。

EBSボリュームのサイズを変更するか、ボリュームタイプ、IOPS、またはスループットを変更します。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`
`volumeId`	弦	必須。変更するボリュームのID。	`vol-0123456789abcdef0`
`size`	Int	オプション。GiB単位の新しいサイズ。	`200`
`volumeType`	弦	オプション。新しいボリュームタイプ。	`gp3`
`iops`	Int	オプション。新しいプロビジョンドIOPS。 `gp3` 、 `io1` 、および `io2` ボリュームにのみ有効です。	`4000`
`throughput`	Int	オプション。MiB/s単位の新しいスループット。 `gp3` ボリュームにのみ有効です。	`250`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "modificationState", "expression": ".response.VolumeModification.ModificationState"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	modify_volume boto3 リファレンスをご覧ください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

modify_volume boto3 リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

ボリュームの説明

アクション識別子はaws.ec2.describeVolumesです。

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`
`volumeIds`	リスト	オプション。結果を特定のボリュームIDに制限します。リージョン内のすべてのボリュームを記述するには省略します。	`["vol-0123456789abcdef0"]`
`filters`	リスト	オプション。サーバー側のフィルター（たとえば、 `status` 、 `availability-zone` 、または `volume-type` によるもの）。	`[{"Name": "status", "Values": ["available"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返すボリュームの最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "volumes", "expression": ".response.Volumes"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	describe_volumes boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

describe_volumes boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

スナップショットのコピー

アクション識別子はaws.ec2.copySnapshotです。

バックアップおよびディザスタリカバリのために、EBSスナップショットを別のリージョンにコピーします。regionフィールドは、宛先リージョンを指定します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`	弦	必須。スナップショットがコピーされる宛先リージョン。	`us-west-2`
`sourceSnapshotId`	弦	必須。コピーするスナップショットのID。	`snap-0123456789abcdef0`
`sourceRegion`	弦	必須。ソーススナップショットが現在存在するリージョン。	`us-east-1`
`description`	弦	オプション。新しいスナップショットに適用される説明。	`Cross-region DR copy`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "snapshotId", "expression": ".response.SnapshotId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	copy_snapshot boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

copy_snapshot boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

スナップショットの記述

アクション識別子はaws.ec2.describeSnapshotsです。

所有者、ボリューム、またはフィルター条件によって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`
`snapshotIds`	リスト	オプション。結果を特定のスナップショットIDに制限します。	`["snap-0123456789abcdef0"]`
`ownerIds`	リスト	オプション。スナップショットの所有者でフィルターします。呼び出し元アカウントが所有するスナップショットのみを返すには、 `self` を使用します。	`["self"]`
`filters`	リスト	オプション。ボリューム、ステータス、タグなどによるAWSフィルター。	`[{"Name": "volume-id", "Values": ["vol-0123456789abcdef0"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返すスナップショットの最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "snapshots", "expression": ".response.Snapshots"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	describe_snapshots boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

describe_snapshots boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

画像を作成する

アクション識別子はaws.ec2.createImageです。

実行中または停止中のEC2インスタンスからAmazon Machine Image（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`
`instanceId`	弦	必須。イメージをキャプチャするEC2インスタンス。	`i-0123456789abcdef0`
`name`	弦	必須。新しいAMIの名前。リージョン内で一意である必要があります。	`my-server-ami-2026-09-21`
`description`	弦	オプション。AMIの自由形式の説明。	`Nightly backup AMI`
`noReboot`	ブール値	オプション。 `false` の場合、ファイルシステムの一貫性があるイメージを保証するために、AWSはインスタンスをシャットダウンして再起動します。イメージの一貫性を犠牲にして再起動をスキップするには、 `true` を設定します。デフォルト： `false` 。	`false`
`tagSpecifications`	リスト	オプション。作成時に新しいAMIとそのスナップショットに適用されるタグです。	`[{"ResourceType": "image", "Tags": [{"Key": "Name", "Value": "nightly-backup"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "imageId", "expression": ".response.ImageId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	create_image boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`""`

出力

タイプ

例

response

オブジェクト

create_image boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

イメージのコピー

アクション識別子はaws.ec2.copyImageです。

ディザスタリカバリまたはマルチリージョンデプロイメントのために、Amazon Machine Image（AMI）を別のリージョンにコピーします。regionフィールドは、宛先リージョンを指定します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`	弦	必須。コピーが作成される宛先リージョン。	`us-west-2`
`sourceImageId`	弦	必須。コピーするAMI。	`ami-0123456789abcdef0`
`sourceRegion`	弦	必須。現在ソースAMIを保持しているリージョン。	`us-east-1`
`name`	弦	オプション。宛先リージョンの新しいAMIの名前。	`my-server-ami-copy`
`description`	弦	オプション。コピーされたAMIの自由形式の説明。	`Cross-region DR copy`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "imageId", "expression": ".response.ImageId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

copy_image boto3リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

イメージの登録解除

アクション識別子はaws.ec2.deregisterImageです。

所有しているAmazon Machine Image（AMI）の登録を解除します。AMIの登録を解除しても、そのバッキング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`	弦	必須。AMIが登録されているAWSリージョン。	`us-east-2`
`imageId`	弦	必須。登録解除するAMI。呼び出し元アカウントが所有するAMIである必要があります。	`ami-0123456789abcdef0`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

deregister_image boto3 リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

イメージの記述

アクション識別子はaws.ec2.describeImagesです。

アカウントが所有している、アカウントと共有されている、またはアカウントに公開されているAmazon Machine Imageを記述します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`imageIds`	リスト	オプション。結果を特定のAMI IDに制限します。	`["ami-0123456789abcdef0"]`
`owners`	リスト	オプション。所有者で結果を絞り込みます。AWSアカウントID、 `self` 、 `amazon` 、または `aws-marketplace` を受け入れます。	`["self"]`
`filters`	リスト	オプション。サーバー側のフィルター（たとえば、 `name` 、 `state` 、または `tag:<key>` によるもの）。	`[{"Name": "name", "Values": ["my-server-ami-*"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返すAMIの最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "images", "expression": ".response.Images"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

describe_images boto3リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

インスタンスのステータスを記述します。

アクション識別子はaws.ec2.describeInstanceStatusです。

システムおよびインスタンスのステータスチェックやスケジュールされたイベントなど、1つ以上の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"]`
`includeAllInstances`	ブール値	オプション。 `true` の場合、実行中以外の状態のインスタンスが含まれます。デフォルト： `false` 。	`false`
`filters`	リスト	オプション。クエリに適用するAWSフィルター。	`[{"Name": "instance-status.status", "Values": ["impaired"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返す結果の最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "instanceStatuses", "expression": ".response.InstanceStatuses"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

describe_instance_status boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

インスタンスタイプの説明

アクション識別子はaws.ec2.describeInstanceTypesです。

EC2インスタンスタイプの仕様（vCPU、メモリ、ネットワーク、ストレージ）を記述します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`instanceTypes`	リスト	オプション。記述する特定のインスタンスタイプ。	`["t3.micro", "m5.large"]`
`filters`	リスト	オプション。クエリに適用するAWSフィルター。	`[{"Name": "instance-type", "Values": ["t3.*"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返す結果の最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "instanceTypes", "expression": ".response.InstanceTypes"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

describe_instance_types boto3リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

インスタンス属性を変更

アクション識別子はaws.ec2.modifyInstanceAttributeです。

インスタンスタイプ、終了保護、ユーザーデータ、送信元/送信先チェックなど、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`
`instanceId`	弦	必須。属性が変更されるインスタンス。	`i-0123456789abcdef0`
`parameters`	地図	必須。AWS APIが想定する形式で変更する属性。1回の呼び出しで変更できる属性は1つだけです。	`{"DisableApiTermination": {"Value": true}}`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

重要

1回の呼び出しで変更できる属性は1つだけです。各属性は parameters マップ内で異なる形状を持ちます — たとえば、インスタンスタイプを変更する場合は {"InstanceType": {"Value": "t3.large"}}、終了保護を有効にする場合は {"DisableApiTermination": {"Value": true}} です。ほとんどの属性では、最初にインスタンスを停止する必要があります。

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功時のレスポンス本文はありません。

modify_instance_attribute boto3 リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

詳細な監視を有効にする

アクション識別子はaws.ec2.monitorInstancesです。

1つ以上のEC2インスタンスに対して、詳細なCloudWatch監視（1分間のメトリクス）を有効にします。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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"]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "instanceMonitorings", "expression": ".response.InstanceMonitorings"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

monitor_instances boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

詳細な監視の無効化

アクション識別子はaws.ec2.unmonitorInstancesです。

1つ以上のEC2インスタンスの詳細なCloudWatch監視を無効にし、標準の5分間のメトリクスに戻します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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"]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "instanceMonitorings", "expression": ".response.InstanceMonitorings"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

unmonitor_instances boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

コンソール出力の取得

アクション識別子はaws.ec2.getConsoleOutputです。

起動およびトラブルシューティングの診断のために、EC2インスタンスのコンソール出力を取得します。出力はbase64エンコードされています。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`instanceId`	弦	必須。コンソール出力を取得するインスタンス。	`i-0123456789abcdef0`
`latest`	ブール値	オプション。 `true` の場合、処理中であっても最新の出力を返します。デフォルト： `false` 。	`true`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "output", "expression": ".response.Output"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

get_console_output boto3 リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

Windowsパスワードデータを取得します。

アクション識別子はaws.ec2.getPasswordDataです。

Windows EC2インスタンスの暗号化されたアドミニストレーターパスワードを取得します。Windows以外のインスタンスの場合は空のPasswordDataフィールドを返します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`instanceId`	弦	必須。パスワードデータを取得するWindowsインスタンス。	`i-0123456789abcdef0`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "passwordData", "expression": ".response.PasswordData"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

get_password_data boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

キーペアのインポート

アクション識別子はaws.ec2.importKeyPairです。

既存のパブリックキーをキーペアとしてEC2にインポートします。AWSはパブリックキーのみを保存します — プライベートキーがユーザーの管理下から離れることはありません。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`keyName`	弦	必須。インポートしたキーペアを登録する一意の名前です。	`my-imported-key`
`publicKeyMaterial`	弦	必須。インポートするパブリックキーです。シークレットとして渡します。	`${{ :secrets:opsPublicKeyMaterial }}`
`tagSpecifications`	リスト	オプション。インポート時にキーペアに適用されるタグ。	`[{"ResourceType": "key-pair", "Tags": [{"Key": "Name", "Value": "my-imported-key"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "keyPairId", "expression": ".response.KeyPairId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

import_key_pair boto3 リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

キーペアの削除

アクション識別子はaws.ec2.deleteKeyPairです。

EC2キーペアを削除します。keyNameまたはkeyPairIdのいずれかを指定します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`keyName`	弦	オプション。削除するキーペアの名前。 `keyName` または `keyPairId` のいずれかを指定します。	`my-key-pair`
`keyPairId`	弦	オプション。削除するキーペアのIDです。 `keyName` または `keyPairId` のいずれかを指定します。	`key-0123456789abcdef0`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

delete_key_pair boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

キーペアの説明

アクション識別子はaws.ec2.describeKeyPairsです。

アカウントおよびリージョン内の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`
`keyNames`	リスト	オプション。結果をこれらのキーペア名に制限します。	`["my-key-pair"]`
`keyPairIds`	リスト	オプション。結果をこれらのキーペアIDに制限します。	`["key-0123456789abcdef0"]`
`filters`	リスト	オプション。AWSフィルター（たとえば、 `key-name` またはタグによるもの）。	`[{"Name": "key-name", "Values": ["my-key-*"]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "keyPairs", "expression": ".response.KeyPairs"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

describe_key_pairs boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

セキュリティグループを作成します。

アクション識別子はaws.ec2.createSecurityGroupです。

VPC内に新しい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`
`groupName`	弦	必須。新しいセキュリティグループの名前です。VPC内で一意である必要があります。	`web-servers-sg`
`description`	弦	必須。セキュリティグループの説明。	`Security group for web servers`
`vpcId`	弦	オプション。グループを作成するVPC。デフォルトはリージョンのデフォルトVPCです。	`vpc-0123456789abcdef0`
`tagSpecifications`	リスト	オプション。作成時にグループに適用されるタグ。	`[{"ResourceType": "security-group", "Tags": [{"Key": "Name", "Value": "web-servers-sg"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "groupId", "expression": ".response.GroupId"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

create_security_group boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

セキュリティグループを削除

アクション識別子はaws.ec2.deleteSecurityGroupです。

EC2セキュリティグループを削除します。groupId（推奨）またはgroupNameのいずれかを指定します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`groupId`	弦	オプション。削除するセキュリティグループです。任意のVPCで機能します。 `groupName` よりも推奨されます。	`sg-0123456789abcdef0`
`groupName`	弦	オプション。 `groupId` の代替手段です。デフォルトVPC内のグループにのみ有効です。	`web-servers-sg`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

delete_security_group boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

セキュリティグループの記述

アクション識別子はaws.ec2.describeSecurityGroupsです。

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`
`groupIds`	リスト	オプション。結果を特定のセキュリティグループIDに制限します。	`["sg-0123456789abcdef0"]`
`groupNames`	リスト	オプション。グループ名で結果を制限します。デフォルトVPC内のグループにのみ有効です。	`["web-servers-sg"]`
`filters`	リスト	オプション。AWSフィルター。例： `vpc-id` 、 `group-name` 、 `tag:<key>` によるもの。	`[{"Name": "vpc-id", "Values": ["vpc-0123456789abcdef0"]}]`
`nextToken`	弦	オプション。以前のレスポンスからのページネーショントークン。	`nextToken`
`maxResults`	Int	オプション。1ページあたりに返すグループの最大数。	`10`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "securityGroups", "expression": ".response.SecurityGroups"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

describe_security_groups boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

インバウンドルールの追加

アクション識別子はaws.ec2.authorizeSecurityGroupIngressです。

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`
`groupId`	弦	必須。インバウンドルールを追加するセキュリティグループです。	`sg-0123456789abcdef0`
`ipProtocol`	弦	オプション。フラット形式。単一のIPv4ルールの場合は、 `fromPort` 、 `toPort` 、および `cidrIp` とともに使用します。	`tcp`
`fromPort`	Int	オプション。フラット形式。ポート範囲の開始。	`443`
`toPort`	Int	オプション。フラット形式。ポート範囲の終了。	`443`
`cidrIp`	弦	オプション。フラット形式。ルールで許可された送信元CIDRブロック。	`0.0.0.0/0`
`ipPermissions`	リスト	オプション。構造化された形式。1回の呼び出しでの複数のルール、ルールの説明、IPv6範囲、プレフィックスリスト、またはソースセキュリティグループに必要です。	`[{"IpProtocol": "tcp", "FromPort": 443, "ToPort": 443, "IpRanges": [{"CidrIp": "0.0.0.0/0", "Description": "HTTPS from anywhere"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

ヒント

このアクションは2つのルール形式をサポートしています — 呼び出しごとに1つを選択してください。フラット形式（ipProtocol、fromPort、toPort、cidrIp）は、単一のIPv4ルールの省略形です。複数のルール、説明、IPv6範囲、プレフィックスリスト、または送信元セキュリティグループには、ipPermissionsを使用してください。

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

authorize_security_group_ingress boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

インバウンドルールを削除

アクション識別子はaws.ec2.revokeSecurityGroupIngressです。

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`
`groupId`	弦	必須。インバウンドルールを削除するセキュリティグループ。	`sg-0123456789abcdef0`
`ipProtocol`	弦	オプション。フラット形式。 `fromPort` 、 `toPort` 、および `cidrIp` とともに使用します。	`tcp`
`fromPort`	Int	オプション。フラット形式。ポート範囲の開始。	`443`
`toPort`	Int	オプション。フラット形式。ポート範囲の終了。	`443`
`cidrIp`	弦	オプション。フラット形式。削除されるルールの送信元CIDRブロックです。	`0.0.0.0/0`
`ipPermissions`	リスト	オプション。構造化された形式。1回の呼び出しで複数のルールを取り消す場合、またはIPv6範囲、プレフィックスリスト、送信元セキュリティグループに関するルールを取り消す場合に必要です。	`[{"IpProtocol": "tcp", "FromPort": 443, "ToPort": 443, "IpRanges": [{"CidrIp": "0.0.0.0/0"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

revoke_security_group_ingress boto3リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

""

アウトバウンドルールを追加

アクション識別子はaws.ec2.authorizeSecurityGroupEgressです。

構造化されたipPermissions形式を使用して、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`
`groupId`	弦	必須。アウトバウンドルールを追加するセキュリティグループ。	`sg-0123456789abcdef0`
`ipPermissions`	リスト	必須。構造化された形式で追加するアウトバウンドルールです。	`[{"IpProtocol": "tcp", "FromPort": 443, "ToPort": 443, "IpRanges": [{"CidrIp": "0.0.0.0/0"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

重要

インバウンドルールのアクションとは異なり、このアクションはフラットなパラメーター形式（cidrIp、ipProtocol、fromPort、toPort）をサポートしていません。AWS AuthorizeSecurityGroupEgress APIは、これらのパラメーターを完全に拒否します。すべてのアウトバウンドルールは、構造化されたipPermissionsリストを使用する必要があります。

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功時のレスポンスボディはありません。

authorize_security_group_egress boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

アウトバウンドルールの削除

アクション識別子はaws.ec2.revokeSecurityGroupEgressです。

EC2 セキュリティグループからアウトバウンドルールを削除します。ルールの仕様は、既存のルールと完全に一致する必要があります。一般的な用途は、AWS がすべての新しいセキュリティグループにアタッチする、デフォルトのすべてを許可するエグレスルールを削除することです。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`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`
`groupId`	弦	必須。アウトバウンドルールを削除するセキュリティグループ。	`sg-0123456789abcdef0`
`ipPermissions`	リスト	必須。構造化された形式で削除するアウトバウンドルールです。既存のルールと完全に一致する必要があります。	`[{"IpProtocol": "-1", "IpRanges": [{"CidrIp": "0.0.0.0/0"}]}]`
`selectors`	リスト	オプション。アクションの出力から特定のフィールドを抽出するためのJQセレクター。	`[{"name": "response", "expression": ".response"}]`

重要

インバウンドルールのアクションとは異なり、このアクションはフラットなパラメーター形式（cidrIp、ipProtocol、fromPort、toPort）をサポートしていません。すべてのアウトバウンドルールは、構造化されたipPermissionsリストを使用する必要があります。

次の表は、このアクションの出力フィールドについて説明しています。

出力

タイプ

例

response

オブジェクト

成功した場合、レスポンス本文はありません。

revoke_security_group_egress boto3リファレンス

を参照してください。

success

ブール値

true

または

false

errorMessage

弦

""

この機械翻訳は、参考として提供されています。

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

インスタンスを実行する

ヒント

インスタンスを説明する

重要

インスタンスを再起動する

インスタンスを停止する

インスタンスの再起動をリクエストします

インスタンスをシャットダウンする

EBSスナップショットを作成する

スナップショットを削除する

Elastic IP アドレスの割り当て

Elastic IPアドレスを関連付ける

重要

Elastic IPアドレスの関連付け解除

重要

Elastic IPアドレスを解放する

Elastic IPアドレスを記述します。

タグを作成

タグを削除

タグの説明

ボリュームの作成

ボリュームの削除

ボリュームのアタッチ

ボリュームのデタッチ

ボリュームの変更

ボリュームの説明

スナップショットのコピー

スナップショットの記述

画像を作成する

イメージのコピー

イメージの登録解除

イメージの記述

インスタンスのステータスを記述します。

インスタンスタイプの説明

インスタンス属性を変更

重要

詳細な監視を有効にする

詳細な監視の無効化

コンソール出力の取得

Windowsパスワードデータを取得します。

キーペアのインポート

キーペアの削除

キーペアの説明

セキュリティグループを作成します。

セキュリティグループを削除

セキュリティグループの記述

インバウンドルールの追加

ヒント

インバウンドルールを削除

アウトバウンドルールを追加

重要

アウトバウンドルールの削除

重要

前提条件