Skip to content
GET /unified/cloud-infrastructure/container_services/{id}

Path Parameters

idstring
required·

The ID of the resource.

Example: 23423523

Query Parameters

Refer Specifying query parameters in Truto APIs

regionstring

AWS region to read. One call reads one region; the caller drives any multi-region loop.

1 supported
Amazon Web Services
supported
cluster_idstring

The cluster ARN or name. Only needed for an old-format service ARN or a bare service name; a new-format ARN names its cluster.

1 supported
Amazon Web Services
supported
Show Truto-specific parameters
integrated_account_idstring · uuid
required·

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_formatstring

The format of the response.

  • unified returns the response with unified mappings applied.
  • raw returns the unprocessed, raw response from the remote API.
  • normalized applies the unified mappings and returns the data in a normalized format.
  • stream returns 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.
  • debug returns the final unified result alongside raw remote fetch information. The response is an envelope containing result (identical to unified mode output) and debug (with requestUrl, requestOptions, data, responseHeaders, and for list operations: nextCursor, isLooping, isEmptyResult, resultCount). When the upstream body exceeds 1 MiB, data is replaced by { truto_truncated: true, truto_max_bytes, truto_excerpt }. debug is null for static responses or when truto_skip_api_call=true.

Defaults to unified.

Example: unified
Possible values:
unifiedrawnormalizedstreamdebug
truto_ignore_remote_databoolean

Excludes the remote_data attribute from the response.

truto_exclude_fieldsstring[]

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_queryRecord<string, any>

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

Response Body

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.

1 supported
Amazon Web Services
supported
accountstring

The account, subscription or project this object belongs to.

References: Accounts → id
1 supported
Amazon Web Services
supported
assign_public_ipboolean

Whether tasks get a public IP address on their network interface. Null when the service does not use per-task networking (awsvpc), where the host's network decides.

1 supported
Amazon Web Services
supported
attached_rule_setsobject[]

The firewall rule sets (security groups) attached to the tasks' network interfaces (awsvpc networking).

1 supported
Amazon Web Services
supported
idstring

The target's id.

capacity_providersstring[]

Capacity pools in the service's capacity provider strategy, verbatim (on AWS ECS: FARGATE, FARGATE_SPOT or customer-named providers). Empty when the service uses a launch type.

1 supported
Amazon Web Services
supported
clusterobject

The container cluster this object runs in.

1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
compute_typestring

Where the tasks run, 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). unknown: the service uses capacity providers whose kind is not read here (only FARGATE and FARGATE_SPOT are known to be serverless), or no launch type and no strategy (the cluster default applies) - see unreadable_fields.

Possible values:
serverlesscustomer_managed_serversprovider_managed_serversexternal_serversunknown
1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
desired_sizeinteger

Number of tasks the service is meant to keep running.

1 supported
Amazon Web Services
supported
exec_enabledboolean

Whether interactive exec into the running containers is turned on (on AWS: ECS Exec, enableExecuteCommand).

1 supported
Amazon Web Services
supported
load_balancer_target_idsstring[]

Load balancer target groups (ARNs) the service registers its tasks with.

1 supported
Amazon Web Services
supported
namestring

The service name, verbatim.

1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
pending_countinteger

Number of tasks in the pending state.

1 supported
Amazon Web Services
supported
platform_versionstring

The serverless platform version, verbatim (AWS Fargate only).

1 supported
Amazon Web Services
supported
providerstring

Which cloud this object was read from.

Possible values:
awsazuregcp
1 supported
Amazon Web Services
supported
provider_idstring

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

1 supported
Amazon Web Services
supported
provider_launch_typestring

The provider's own launch type, verbatim (on AWS ECS: EC2, FARGATE, EXTERNAL or MANAGED_INSTANCES). Null when the service uses a capacity provider strategy instead - see capacity_providers.

1 supported
Amazon Web Services
supported
provider_statusstring

The provider's own state string, verbatim (on AWS ECS: ACTIVE, DRAINING or INACTIVE).

1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
remote_dataRecord<string, any>

Raw data returned from the remote API call.

1 supported
Amazon Web Services
supported
running_countinteger

Number of tasks in the running state.

1 supported
Amazon Web Services
supported
statusstring

State, normalised. On AWS ECS: DRAINING (the service is being deleted) is deleting, INACTIVE is deleted. provider_status has the provider's value verbatim.

Possible values:
activedeletingdeletedunknown
1 supported
Amazon Web Services
supported
subnet_idsstring[]

Subnets the tasks are placed in (per-task networking, awsvpc).

1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
task_definitionobject

The task definition revision the service runs. GET container_task_definitions with this id to read that exact revision.

1 supported
Amazon Web Services
supported
idstring

The target's 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.

1 supported
Amazon Web Services
supported
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.

1 supported
Amazon Web Services
supported
truto unified cloud-infrastructure containerservices '<resource_id>' \
  -m get \
  -a '<integrated_account_id>' \
  -o json
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

const result = await truto.unifiedApi.get(
  'cloud-infrastructure',
  'containerservices',
  '<resource_id>',
  { 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():
    result = await truto_api.unified_api.get(
        "cloud-infrastructure",
        "containerservices",
        "<resource_id>",
        {"integrated_account_id": "<integrated_account_id>"}
    )
    print(result)

asyncio.run(main())
curl -X GET 'https://api.truto.one/unified/cloud-infrastructure/container_services/{id}?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_services/{id}?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_services/{id}"
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())