EcsRunTaskJsonataProps

class aws_cdk.aws_stepfunctions_tasks.EcsRunTaskJsonataProps(*, comment=None, query_language=None, state_name=None, credentials=None, heartbeat=None, heartbeat_timeout=None, integration_pattern=None, task_timeout=None, timeout=None, assign=None, outputs=None, cluster, launch_target, task_definition, assign_public_ip=None, container_overrides=None, cpu=None, enable_execute_command=None, memory_mib=None, propagated_tag_source=None, revision_number=None, security_groups=None, subnets=None)

Bases: TaskStateJsonataBaseProps

Properties for ECS Tasks using JSONata.

Parameters:

comment (Optional[str]) – A comment describing this state. Default: No comment
query_language (Optional[QueryLanguage]) – The name of the query language used by the state. If the state does not contain a queryLanguage field, then it will use the query language specified in the top-level queryLanguage field. Default: - JSONPath
state_name (Optional[str]) – Optional name for this state. Default: - The construct ID will be used as state name
credentials (Union[Credentials, Dict[str, Any], None]) – Credentials for an IAM Role that the State Machine assumes for executing the task. This enables cross-account resource invocations. Default: - None (Task is executed using the State Machine’s execution role)
heartbeat (Optional[Duration]) – (deprecated) Timeout for the heartbeat. Default: - None
heartbeat_timeout (Optional[Timeout]) – Timeout for the heartbeat. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
integration_pattern (Optional[IntegrationPattern]) – AWS Step Functions integrates with services directly in the Amazon States Language. You can control these AWS services using service integration patterns. Depending on the AWS Service, the Service Integration Pattern availability will vary. Default: - IntegrationPattern.REQUEST_RESPONSE for most tasks. IntegrationPattern.RUN_JOB for the following exceptions: BatchSubmitJob, EmrAddStep, EmrCreateCluster, EmrTerminationCluster, and EmrContainersStartJobRun.
task_timeout (Optional[Timeout]) – Timeout for the task. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
timeout (Optional[Duration]) – (deprecated) Timeout for the task. Default: - None
assign (Optional[Mapping[str, Any]]) – Workflow variables to store in this step. Using workflow variables, you can store data in a step and retrieve that data in future steps. Default: - Not assign variables
outputs (Any) – Used to specify and transform output from the state. When specified, the value overrides the state output default. The output field accepts any JSON value (object, array, string, number, boolean, null). Any string value, including those inside objects or arrays, will be evaluated as JSONata if surrounded by {% %} characters. Output also accepts a JSONata expression directly. Default: - $states.result or $states.errorOutput
cluster (ICluster) – The ECS cluster to run the task on.
launch_target (IEcsLaunchTarget) – An Amazon ECS launch type determines the type of infrastructure on which your tasks and services are hosted.
task_definition (TaskDefinition) – [disable-awslint:ref-via-interface] Task Definition used for running tasks in the service. Note: this must be TaskDefinition, and not ITaskDefinition, as it requires properties that are not known for imported task definitions If you want to run a RunTask with an imported task definition, consider using CustomState
assign_public_ip (Optional[bool]) – Assign public IP addresses to each task. Default: false
container_overrides (Optional[Sequence[Union[ContainerOverride, Dict[str, Any]]]]) – Container setting overrides. Specify the container to use and the overrides to apply. Default: - No overrides
cpu (Optional[str]) – Cpu setting override. Default: - No override
enable_execute_command (Optional[bool]) – Whether ECS Exec should be enabled. Default: false
memory_mib (Optional[str]) – Memory setting override. Default: - No override
propagated_tag_source (Optional[PropagatedTagSource]) – Specifies whether to propagate the tags from the task definition to the task. An error will be received if you specify the SERVICE option when running a task. Default: - No tags are propagated.
revision_number (Union[int, float, None]) – The revision number of ECS task definition family. Default: - ‘$latest’
security_groups (Optional[Sequence[ISecurityGroup]]) – Existing security groups to use for the tasks. Default: - A new security group is created
subnets (Union[SubnetSelection, Dict[str, Any], None]) – Subnets to place the task’s ENIs. Default: - Public subnets if assignPublicIp is set. Private subnets otherwise.

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk
from aws_cdk import aws_ec2 as ec2
from aws_cdk import aws_ecs as ecs
from aws_cdk import aws_stepfunctions as stepfunctions
from aws_cdk import aws_stepfunctions_tasks as stepfunctions_tasks

# assign: Any
# cluster: ecs.Cluster
# container_definition: ecs.ContainerDefinition
# ecs_launch_target: stepfunctions_tasks.IEcsLaunchTarget
# outputs: Any
# security_group: ec2.SecurityGroup
# subnet: ec2.Subnet
# subnet_filter: ec2.SubnetFilter
# task_definition: ecs.TaskDefinition
# task_role: stepfunctions.TaskRole
# timeout: stepfunctions.Timeout

ecs_run_task_jsonata_props = stepfunctions_tasks.EcsRunTaskJsonataProps(
    cluster=cluster,
    launch_target=ecs_launch_target,
    task_definition=task_definition,

    # the properties below are optional
    assign={
        "assign_key": assign
    },
    assign_public_ip=False,
    comment="comment",
    container_overrides=[stepfunctions_tasks.ContainerOverride(
        container_definition=container_definition,

        # the properties below are optional
        command=["command"],
        cpu=123,
        environment=[stepfunctions_tasks.TaskEnvironmentVariable(
            name="name",
            value="value"
        )],
        memory_limit=123,
        memory_reservation=123
    )],
    cpu="cpu",
    credentials=stepfunctions.Credentials(
        role=task_role
    ),
    enable_execute_command=False,
    heartbeat=cdk.Duration.minutes(30),
    heartbeat_timeout=timeout,
    integration_pattern=stepfunctions.IntegrationPattern.REQUEST_RESPONSE,
    memory_mi_b="memoryMiB",
    outputs=outputs,
    propagated_tag_source=ecs.PropagatedTagSource.SERVICE,
    query_language=stepfunctions.QueryLanguage.JSON_PATH,
    revision_number=123,
    security_groups=[security_group],
    state_name="stateName",
    subnets=ec2.SubnetSelection(
        availability_zones=["availabilityZones"],
        one_per_az=False,
        subnet_filters=[subnet_filter],
        subnet_group_name="subnetGroupName",
        subnets=[subnet],
        subnet_type=ec2.SubnetType.PRIVATE_ISOLATED
    ),
    task_timeout=timeout,
    timeout=cdk.Duration.minutes(30)
)

Attributes

assign

Workflow variables to store in this step.

Using workflow variables, you can store data in a step and retrieve that data in future steps.

Default:

Not assign variables

See:

https://docs.aws.amazon.com/step-functions/latest/dg/workflow-variables.html

assign_public_ip

Assign public IP addresses to each task.

Default:: false

cluster: The ECS cluster to run the task on.

comment

A comment describing this state.

Default:: No comment

container_overrides

Container setting overrides.

Specify the container to use and the overrides to apply.

Default:

No overrides

cpu

Cpu setting override.

Default:

No override

See:

https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html

credentials

Credentials for an IAM Role that the State Machine assumes for executing the task.

This enables cross-account resource invocations.

Default:

None (Task is executed using the State Machine’s execution role)

See:

https://docs.aws.amazon.com/step-functions/latest/dg/concepts-access-cross-acct-resources.html

enable_execute_command

Whether ECS Exec should be enabled.

Default:: false
See:: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html#ECS-RunTask-request-enableExecuteCommand

heartbeat

(deprecated) Timeout for the heartbeat.

Default:

None

Deprecated:

use heartbeatTimeout

Stability:

deprecated

heartbeat_timeout

Timeout for the heartbeat.

[disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface

Default:

None

integration_pattern

AWS Step Functions integrates with services directly in the Amazon States Language.

You can control these AWS services using service integration patterns.

Depending on the AWS Service, the Service Integration Pattern availability will vary.

Default:

IntegrationPattern.REQUEST_RESPONSE for most tasks.

IntegrationPattern.RUN_JOB for the following exceptions: BatchSubmitJob, EmrAddStep, EmrCreateCluster, EmrTerminationCluster, and EmrContainersStartJobRun.

See:: https://docs.aws.amazon.com/step-functions/latest/dg/connect-supported-services.html

launch_target

An Amazon ECS launch type determines the type of infrastructure on which your tasks and services are hosted.

See:: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html

memory_mib

Memory setting override.

Default:

No override

See:

https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html

outputs

Used to specify and transform output from the state.

When specified, the value overrides the state output default. The output field accepts any JSON value (object, array, string, number, boolean, null). Any string value, including those inside objects or arrays, will be evaluated as JSONata if surrounded by {% %} characters. Output also accepts a JSONata expression directly.

Default:

$states.result or $states.errorOutput

See:

https://docs.aws.amazon.com/step-functions/latest/dg/concepts-input-output-filtering.html

propagated_tag_source

Specifies whether to propagate the tags from the task definition to the task.

An error will be received if you specify the SERVICE option when running a task.

Default:

No tags are propagated.

See:

https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html#ECS-RunTask-request-propagateTags

query_language

The name of the query language used by the state.

If the state does not contain a queryLanguage field, then it will use the query language specified in the top-level queryLanguage field.

Default:

JSONPath

revision_number

The revision number of ECS task definition family.

Default:

‘$latest’

security_groups

Existing security groups to use for the tasks.

Default:

A new security group is created

state_name

Optional name for this state.

Default:

The construct ID will be used as state name

subnets

Subnets to place the task’s ENIs.

Default:

Public subnets if assignPublicIp is set. Private subnets otherwise.

task_definition

ref-via-interface] Task Definition used for running tasks in the service.

Note: this must be TaskDefinition, and not ITaskDefinition, as it requires properties that are not known for imported task definitions If you want to run a RunTask with an imported task definition, consider using CustomState

Type:: [disable-awslint

task_timeout

Timeout for the task.

[disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface

Default:

None

timeout

(deprecated) Timeout for the task.

Default:

None

Deprecated:

use taskTimeout

Stability:

deprecated