List Container tasks
/unified/cloud-infrastructure/container_tasks
Query Parameters
Refer Specifying query parameters in Truto APIs
Required. The container_clusters id (cluster ARN) or the cluster name. ECS lists one cluster at a time.
1 supported1 required
AWS region to read. One call reads one region; the caller drives any multi-region loop.
1 supported
Only tasks started by this service: a container_services id (ARN) or a service name.
1 supported
running (default) or stopped. Stopped tasks stay listed for about an hour after they stop.
pendingrunningstoppedunknown
1 supported
Show Truto-specific parameters
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79dThe format of the response.
unifiedreturns the response with unified mappings applied.rawreturns the unprocessed, raw response from the remote API.normalizedapplies the unified mappings and returns the data in a normalized format.streamreturns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.debugreturns the final unified result alongside raw remote fetch information. The response is an envelope containingresult(identical to unified mode output) anddebug(withrequestUrl,requestOptions,data,responseHeaders, and for list operations:nextCursor,isLooping,isEmptyResult,resultCount). When the upstream body exceeds 1 MiB,datais replaced by{ truto_truncated: true, truto_max_bytes, truto_excerpt }.debugisnullfor static responses or whentruto_skip_api_call=true.
Defaults to unified.
unifiedunifiedrawnormalizedstreamdebug
By default the result attribute is an array of objects. This parameter allows you to specify a field in each result objects to use as key, which transforms the result array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
idIgnores the limit query parameter.
Excludes the remote_data attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=nameQuery parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=barResponse Body
Present only when truto_response_format=debug. Contains raw fetch details: requestUrl, requestOptions, data, responseHeaders, nextCursor, isLooping, isEmptyResult, resultCount. data is the parsed upstream body; when its JSON form exceeds 1 MiB it is replaced by { truto_truncated: true, truto_max_bytes, truto_excerpt }, where truto_excerpt is the leading bytes of that body. The same applies to a string requestOptions.body. null for static responses or when truto_skip_api_call=true.
The cursor to use for the next page of results. Pass this value as next_cursor in the query parameter in the next request to get the next page of results.
List of Container tasks
Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.
1 supported
The account, subscription or project this object belongs to.
1 supported
Availability zone the task runs in.
1 supported
The capacity pool that placed the task, verbatim (on AWS ECS: the capacity provider name).
1 supported
The container cluster this object runs in.
1 supported
1 property
The target's id.
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.
1 supported
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).
serverlesscustomer_managed_serversprovider_managed_serversexternal_serversunknown
1 supported
The containers in the task.
1 supported
6 properties
Container health, normalised. Verbatim in remote_data (on AWS ECS: containers[].healthStatus).
healthyunhealthyunknown
Image reference, verbatim.
The resolved image digest the container runs.
Container name.
NAMES of environment variables set by start-time overrides for this container. Values are never returned.
Container state, normalised. Verbatim in remote_data (on AWS ECS: containers[].lastStatus).
pendingrunningstoppedunknown
When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
1 supported
The state the orchestrator is driving the task to, normalised. provider_desired_status has the value verbatim.
pendingrunningstoppedunknown
1 supported
Whether interactive exec into the containers is turned on.
1 supported
Health of the essential containers, normalised. unknown also covers containers without a health check. provider_health_status has the value verbatim.
healthyunhealthyunknown
1 supported
The provider's own type string, unmodified — for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.
1 supported
The serverless platform version (AWS Fargate only).
1 supported
Private IPv4 address of the task's network interface (awsvpc networking).
1 supported
Which cloud this object was read from.
awsazuregcp
1 supported
The state the orchestrator is driving the task to, verbatim (on AWS ECS: PENDING, RUNNING or STOPPED).
1 supported
Health of the essential containers, verbatim (on AWS ECS: HEALTHY, UNHEALTHY or UNKNOWN).
1 supported
The provider's own identifier, passed through verbatim — a full ARN, resource id, or self-link. Never truncated, prefixed, or normalized.
1 supported
The provider's own launch type, verbatim (on AWS ECS: EC2, FARGATE, EXTERNAL or MANAGED_INSTANCES).
1 supported
The task's last known state, verbatim (on AWS ECS lastStatus: PROVISIONING, PENDING, ACTIVATING, RUNNING, DEACTIVATING, STOPPING, DEPROVISIONING, STOPPED, DELETED).
1 supported
Why the task stopped, verbatim (on AWS ECS stopCode: TaskFailedToStart, EssentialContainerExited, UserInitiated, ServiceSchedulerInitiated, SpotInterruption, TerminationNotice).
1 supported
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.
1 supported
Raw data returned from the remote API call.
1 supported
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.
1 supported
1 property
The target's id.
When the task started running.
1 supported
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.
pendingrunningstoppingstoppedunknown
1 supported
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.
failed_to_startcontainer_exiteduser_initiatedorchestrator_initiatedcapacity_reclaimedunknown
1 supported
When the task stopped. Null while running.
1 supported
Subnet of the task's network interface (awsvpc networking).
1 supported
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.
1 supported
The task definition revision the task was started from.
1 supported
1 property
The target's id.
The task id (the last segment of the provider id).
1 supported
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.
1 supported
3 properties
Explanation of the reason, where one adds anything.
The property on this resource that could not be read.
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.
not_supported_by_providernot_configuredpermission_deniednot_collectedcollection_errorpartially_collectedavailable_on_get
When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
1 supported
truto unified cloud-infrastructure containertasks \
-a '<integrated_account_id>' \
-o jsonimport Truto from '@truto/truto-ts-sdk';
const truto = new Truto({
token: '<your_api_token>',
});
const result = await truto.unifiedApi.list(
'cloud-infrastructure',
'containertasks',
{ integrated_account_id: '<integrated_account_id>' }
);
console.log(result);import asyncio
from truto_python_sdk import TrutoApi
truto_api = TrutoApi(token="<your_api_token>")
async def main():
async for item in truto_api.unified_api.list(
"cloud-infrastructure",
"containertasks",
{"integrated_account_id": "<integrated_account_id>"}
):
print(item)
asyncio.run(main())curl -X GET 'https://api.truto.one/unified/cloud-infrastructure/container_tasks?integrated_account_id=<integrated_account_id>' \
-H 'Authorization: Bearer <your_api_token>' \
-H 'Content-Type: application/json'const integratedAccountId = '<integrated_account_id>';
const response = await fetch(`https://api.truto.one/unified/cloud-infrastructure/container_tasks?integrated_account_id=${integratedAccountId}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer <your_api_token>',
'Content-Type': 'application/json',
},
});
const data = await response.json();
console.log(data);import requests
url = "https://api.truto.one/unified/cloud-infrastructure/container_tasks"
headers = {
"Authorization": "Bearer <your_api_token>",
"Content-Type": "application/json",
}
params = {
"integrated_account_id": "<integrated_account_id>"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())