View a markdown version of this page

ContainerTaskConfiguration - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

ContainerTaskConfiguration

Configuration for a container task, including the container image, IAM role, and compute settings.

Contents

ecrUri

The Amazon ECR image URI for the task container.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: ((\d{12}\.dkr\.ecr\.[a-z0-9-]+\.[a-z.]+)|public\.ecr\.aws/[a-z][a-z0-9]+([._-][a-z0-9]+)*)/[a-z0-9]+((\.||__|_|-+)[a-z0-9]+)*(/[a-z0-9]+((\.||__|_|-+)[a-z0-9]+)*)*(:[a-zA-Z0-9._-]+|@sha256:[a-f0-9]{64})?

Required: Yes

processingType

The processing type for compute resources.

Type: String

Valid Values: GENERIC_COMPUTE_PROCESSING | HARDWARE_ACCELERATED_PROCESSING

Required: Yes

processingUnit

The processing unit allocation that determines the vCPU, memory, and GPU resources.

Type: String

Valid Values: UNITS_2 | UNITS_4 | UNITS_8 | UNITS_12 | UNITS_16 | UNITS_24 | UNITS_32 | UNITS_36 | UNITS_48 | UNITS_60 | UNITS_64 | UNITS_72 | UNITS_84 | UNITS_96

Required: Yes

taskExecutionRole

The ARN of the IAM role that grants the containerized workload permissions to access resources.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: arn:aws(-cn|-us-gov)?:iam::\d{12}:role/[\w+=,.@/-]+

Required: Yes

command

The command to execute in the container.

Type: Array of strings

Required: No

environmentVariables

Environment variables passed to the container at runtime.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Key Length Constraints: Minimum length of 1. Maximum length of 255.

Key Pattern: (?!(?i)AWS_)[a-zA-Z_][a-zA-Z0-9_]*

Value Length Constraints: Minimum length of 0. Maximum length of 1024.

Required: No

timeoutSeconds

The timeout in seconds for task execution. Default: 3600 (1 hour).

Type: Long

Valid Range: Minimum value of 60. Maximum value of 86400.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: