Skip to content

Relationships

Schema relationships
graph LR
    ContainerTasks -->|"account"| Accounts
    ContainerTasks -->|"cluster"| ContainerClusters
    ContainerTasks -->|"task_definition"| ContainerTaskDefinitions
    ContainerTasks -->|"service"| ContainerServices

Properties

idstring
required·

Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.

accountstring

The account, subscription or project this object belongs to.

References: Accounts → id
availability_zonestring

Availability zone the task runs in.

capacity_providerstring

The capacity pool that placed the task, verbatim (on AWS ECS: the capacity provider name).

clusterobject

The container cluster this object runs in.

idstring

The target's id.

collected_atstring · date-time

When Truto actually read this object from the provider, in UTC ISO 8601 with the offset present — not the request time, and not a provider timestamp.

compute_typestring

Where the task runs, normalised. serverless: the provider runs the machines (AWS Fargate, Azure Container Apps consumption, GCP Cloud Run). customer_managed_servers: servers in the customer's account that the customer runs (on AWS ECS: EC2 container instances). provider_managed_servers: servers in the customer's account that the provider patches and scales (on AWS: ECS Managed Instances). external_servers: the customer's own servers outside the cloud (on AWS: ECS Anywhere).

Possible values:
serverlesscustomer_managed_serversprovider_managed_serversexternal_serversunknown
containersobject[]

The containers in the task.

health_statusstring

Container health, normalised. Verbatim in remote_data (on AWS ECS: containers[].healthStatus).

Possible values:
healthyunhealthyunknown
imagestring

Image reference, verbatim.

image_digeststring

The resolved image digest the container runs.

namestring

Container name.

overridden_environment_variable_namesstring[]

NAMES of environment variables set by start-time overrides for this container. Values are never returned.

statusstring

Container state, normalised. Verbatim in remote_data (on AWS ECS: containers[].lastStatus).

Possible values:
pendingrunningstoppedunknown
created_atstring · date-time

When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.

desired_statusstring

The state the orchestrator is driving the task to, normalised. provider_desired_status has the value verbatim.

Possible values:
pendingrunningstoppedunknown
exec_enabledboolean

Whether interactive exec into the containers is turned on.

health_statusstring

Health of the essential containers, normalised. unknown also covers containers without a health check. provider_health_status has the value verbatim.

Possible values:
healthyunhealthyunknown
native_typestring

The provider's own type string, unmodified — for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.

platform_versionstring

The serverless platform version (AWS Fargate only).

private_ip_addressstring

Private IPv4 address of the task's network interface (awsvpc networking).

providerstring

Which cloud this object was read from.

Possible values:
awsazuregcp
provider_desired_statusstring

The state the orchestrator is driving the task to, verbatim (on AWS ECS: PENDING, RUNNING or STOPPED).

provider_health_statusstring

Health of the essential containers, verbatim (on AWS ECS: HEALTHY, UNHEALTHY or UNKNOWN).

provider_idstring

The provider's own identifier, passed through verbatim — a full ARN, resource id, or self-link. Never truncated, prefixed, or normalized.

provider_launch_typestring

The provider's own launch type, verbatim (on AWS ECS: EC2, FARGATE, EXTERNAL or MANAGED_INSTANCES).

provider_statusstring

The task's last known state, verbatim (on AWS ECS lastStatus: PROVISIONING, PENDING, ACTIVATING, RUNNING, DEACTIVATING, STOPPING, DEPROVISIONING, STOPPED, DELETED).

provider_stop_codestring

Why the task stopped, verbatim (on AWS ECS stopCode: TaskFailedToStart, EssentialContainerExited, UserInitiated, ServiceSchedulerInitiated, SpotInterruption, TerminationNotice).

regionstring

Where the object is located. 'global' denotes genuinely global resources (e.g. IAM, GCP VPC networks) rather than a guessed region. A substituted region (when none is derivable) is flagged in unreadable_fields.

remote_dataRecord<string, any>

Raw data returned from the remote API call.

serviceobject

The service that started the task, when a service did. On AWS ECS built from the task's group (service:) and cluster as the long-format service ARN, arn::ecs:::service//; a service created before its account moved to long ARNs has a short ARN without the cluster, which this does not match.

idstring

The target's id.

started_atstring · date-time

When the task started running.

statusstring

The task's last known state, normalised as compute_instances.state is. On AWS ECS: PROVISIONING, PENDING and ACTIVATING are pending; DEACTIVATING, STOPPING and DEPROVISIONING are stopping; STOPPED and DELETED are stopped. provider_status has the value verbatim.

Possible values:
pendingrunningstoppingstoppedunknown
stop_causestring

Why the task stopped, normalised. Null while the task runs. On AWS ECS: TaskFailedToStart is failed_to_start, EssentialContainerExited is container_exited, UserInitiated is user_initiated, ServiceSchedulerInitiated is orchestrator_initiated, SpotInterruption and TerminationNotice are capacity_reclaimed. provider_stop_code has the value verbatim; stoppedReason in remote_data has the provider's own words.

Possible values:
failed_to_startcontainer_exiteduser_initiatedorchestrator_initiatedcapacity_reclaimedunknown
stopped_atstring · date-time

When the task stopped. Null while running.

subnet_idstring

Subnet of the task's network interface (awsvpc networking).

tagsobject

Key-value pairs exactly as the customer set them: no case folding, key/value normalization, or merging of separate provider concepts. An empty object means no tags; tags that could not be read appear in unreadable_fields instead.

task_definitionobject

The task definition revision the task was started from.

idstring

The target's id.

task_idstring

The task id (the last segment of the provider id).

unreadable_fieldsobject[]

Fields on this object that could not be read, and why. An empty array means everything was read. Use this to tell a real value from a missing one.

detailstring

Explanation of the reason, where one adds anything.

fieldstring

The property on this resource that could not be read.

reasonstring

Why the field could not be read. available_on_get: Not read on list to keep the list fast; call GET for this resource's id to get it.

Possible values:
not_supported_by_providernot_configuredpermission_deniednot_collectedcollection_errorpartially_collectedavailable_on_get
updated_atstring · date-time

When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.