--- title: Getting Started with Datadog description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog --- # aws_ecs_container_instance{% #aws_ecs_container_instance %} ## `account_id`{% #account_id %} **Type**: `STRING` ## `agent_connected`{% #agent_connected %} **Type**: `BOOLEAN`**Provider name**: `agentConnected`**Description**: This parameter returns `true` if the agent is connected to Amazon ECS. An instance with an agent that may be unhealthy or stopped return `false`. Only instances connected to an agent can accept task placement requests. ## `agent_update_status`{% #agent_update_status %} **Type**: `STRING`**Provider name**: `agentUpdateStatus`**Description**: The status of the most recent agent update. If an update wasn't ever requested, this value is `NULL`. ## `attachments`{% #attachments %} **Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `attachments`**Description**: The resources attached to a container instance, such as an elastic network interface. - `details`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `details`**Description**: Details of the attachment. For elastic network interfaces, this includes the network interface ID, the MAC address, the subnet ID, and the private IPv4 address. For Service Connect services, this includes `portName`, `clientAliases`, `discoveryName`, and `ingressPortOverride`. For Elastic Block Storage, this includes `roleArn`, `deleteOnTermination`, `volumeName`, `volumeId`, and `statusReason` (only when the attachment fails to create or attach). - `name`**Type**: `STRING`**Provider name**: `name`**Description**: The name of the key-value pair. For environment variables, this is the name of the environment variable. - `value`**Type**: `STRING`**Provider name**: `value`**Description**: The value of the key-value pair. For environment variables, this is the value of the environment variable. - `id`**Type**: `STRING`**Provider name**: `id`**Description**: The unique identifier for the attachment. - `status`**Type**: `STRING`**Provider name**: `status`**Description**: The status of the attachment. Valid values are `PRECREATED`, `CREATED`, `ATTACHING`, `ATTACHED`, `DETACHING`, `DETACHED`, `DELETED`, and `FAILED`. - `type`**Type**: `STRING`**Provider name**: `type`**Description**: The type of the attachment, such as `ElasticNetworkInterface`, `Service Connect`, and `AmazonElasticBlockStorage`. ## `attributes`{% #attributes %} **Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `attributes`**Description**: The attributes set for the container instance, either by the Amazon ECS container agent at instance registration or manually with the [PutAttributes](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAttributes.html) operation. - `name`**Type**: `STRING`**Provider name**: `name`**Description**: The name of the attribute. The `name` must contain between 1 and 128 characters. The name may contain letters (uppercase and lowercase), numbers, hyphens (-), underscores (_), forward slashes (/), back slashes (), or periods (.). - `target_id`**Type**: `STRING`**Provider name**: `targetId`**Description**: The ID of the target. You can specify the short form ID for a resource or the full Amazon Resource Name (ARN). - `target_type`**Type**: `STRING`**Provider name**: `targetType`**Description**: The type of the target to attach the attribute with. This parameter is required if you use the short form ID for a resource instead of the full ARN. - `value`**Type**: `STRING`**Provider name**: `value`**Description**: The value of the attribute. The `value` must contain between 1 and 128 characters. It can contain letters (uppercase and lowercase), numbers, hyphens (-), underscores (_), periods (.), at signs (@), forward slashes (/), back slashes (), colons (:), or spaces. The value can't start or end with a space. ## `capacity_provider_name`{% #capacity_provider_name %} **Type**: `STRING`**Provider name**: `capacityProviderName`**Description**: The capacity provider that's associated with the container instance. ## `container_instance_arn`{% #container_instance_arn %} **Type**: `STRING`**Provider name**: `containerInstanceArn`**Description**: The Amazon Resource Name (ARN) of the container instance. For more information about the ARN format, see [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) in the Amazon ECS Developer Guide. ## `ec2_instance_id`{% #ec2_instance_id %} **Type**: `STRING`**Provider name**: `ec2InstanceId`**Description**: The ID of the container instance. For Amazon EC2 instances, this value is the Amazon EC2 instance ID. For external instances, this value is the Amazon Web Services Systems Manager managed instance ID. ## `health_status`{% #health_status %} **Type**: `STRUCT`**Provider name**: `healthStatus`**Description**: An object representing the health status of the container instance. - `details`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `details`**Description**: An array of objects representing the details of the container instance health status. - `last_status_change`**Type**: `TIMESTAMP`**Provider name**: `lastStatusChange`**Description**: The Unix timestamp for when the container instance health status last changed. - `last_updated`**Type**: `TIMESTAMP`**Provider name**: `lastUpdated`**Description**: The Unix timestamp for when the container instance health status was last updated. - `status`**Type**: `STRING`**Provider name**: `status`**Description**: The container instance health status. - `type`**Type**: `STRING`**Provider name**: `type`**Description**: The type of container instance health status that was verified. - `overall_status`**Type**: `STRING`**Provider name**: `overallStatus`**Description**: The overall health status of the container instance. This is an aggregate status of all container instance health checks. ## `pending_tasks_count`{% #pending_tasks_count %} **Type**: `INT32`**Provider name**: `pendingTasksCount`**Description**: The number of tasks on the container instance that are in the `PENDING` status. ## `registered_at`{% #registered_at %} **Type**: `TIMESTAMP`**Provider name**: `registeredAt`**Description**: The Unix timestamp for the time when the container instance was registered. ## `registered_resources`{% #registered_resources %} **Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `registeredResources`**Description**: For CPU and memory resource types, this parameter describes the amount of each resource that was available on the container instance when the container agent registered it with Amazon ECS. This value represents the total amount of CPU and memory that can be allocated on this container instance to tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent when it registered the container instance with Amazon ECS. - `double_value`**Type**: `DOUBLE`**Provider name**: `doubleValue`**Description**: When the `doubleValue` type is set, the value of the resource must be a double precision floating-point type. - `integer_value`**Type**: `INT32`**Provider name**: `integerValue`**Description**: When the `integerValue` type is set, the value of the resource must be an integer. - `long_value`**Type**: `INT64`**Provider name**: `longValue`**Description**: When the `longValue` type is set, the value of the resource must be an extended precision floating-point type. - `name`**Type**: `STRING`**Provider name**: `name`**Description**: The name of the resource, such as `CPU`, `MEMORY`, `PORTS`, `PORTS_UDP`, or a user-defined resource. - `string_set_value`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `stringSetValue`**Description**: When the `stringSetValue` type is set, the value of the resource must be a string type. - `type`**Type**: `STRING`**Provider name**: `type`**Description**: The type of the resource. Valid values: `INTEGER`, `DOUBLE`, `LONG`, or `STRINGSET`. ## `remaining_resources`{% #remaining_resources %} **Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `remainingResources`**Description**: For CPU and memory resource types, this parameter describes the remaining CPU and memory that wasn't already allocated to tasks and is therefore available for new tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent (at instance registration time) and any task containers that have reserved port mappings on the host (with the `host` or `bridge` network mode). Any port that's not specified here is available for new tasks. - `double_value`**Type**: `DOUBLE`**Provider name**: `doubleValue`**Description**: When the `doubleValue` type is set, the value of the resource must be a double precision floating-point type. - `integer_value`**Type**: `INT32`**Provider name**: `integerValue`**Description**: When the `integerValue` type is set, the value of the resource must be an integer. - `long_value`**Type**: `INT64`**Provider name**: `longValue`**Description**: When the `longValue` type is set, the value of the resource must be an extended precision floating-point type. - `name`**Type**: `STRING`**Provider name**: `name`**Description**: The name of the resource, such as `CPU`, `MEMORY`, `PORTS`, `PORTS_UDP`, or a user-defined resource. - `string_set_value`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `stringSetValue`**Description**: When the `stringSetValue` type is set, the value of the resource must be a string type. - `type`**Type**: `STRING`**Provider name**: `type`**Description**: The type of the resource. Valid values: `INTEGER`, `DOUBLE`, `LONG`, or `STRINGSET`. ## `running_tasks_count`{% #running_tasks_count %} **Type**: `INT32`**Provider name**: `runningTasksCount`**Description**: The number of tasks on the container instance that have a desired status (`desiredStatus`) of `RUNNING`. ## `status`{% #status %} **Type**: `STRING`**Provider name**: `status`**Description**: The status of the container instance. The valid values are `REGISTERING`, `REGISTRATION_FAILED`, `ACTIVE`, `INACTIVE`, `DEREGISTERING`, or `DRAINING`. If your account has opted in to the `awsvpcTrunking` account setting, then any newly registered container instance will transition to a `REGISTERING` status while the trunk elastic network interface is provisioned for the instance. If the registration fails, the instance will transition to a `REGISTRATION_FAILED` status. You can describe the container instance and see the reason for failure in the `statusReason` parameter. Once the container instance is terminated, the instance transitions to a `DEREGISTERING` status while the trunk elastic network interface is deprovisioned. The instance then transitions to an `INACTIVE` status. The `ACTIVE` status indicates that the container instance can accept tasks. The `DRAINING` indicates that new tasks aren't placed on the container instance and any service tasks running on the container instance are removed if possible. For more information, see [Container instance draining](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-draining.html) in the Amazon Elastic Container Service Developer Guide. ## `status_reason`{% #status_reason %} **Type**: `STRING`**Provider name**: `statusReason`**Description**: The reason that the container instance reached its current status. ## `tags`{% #tags %} **Type**: `UNORDERED_LIST_STRING` ## `version`{% #version %} **Type**: `INT64`**Provider name**: `version`**Description**: The version counter for the container instance. Every time a container instance experiences a change that triggers a CloudWatch event, the version counter is incremented. If you're replicating your Amazon ECS container instance state with CloudWatch Events, you can compare the version of a container instance reported by the Amazon ECS APIs with the version reported in CloudWatch Events for the container instance (inside the `detail` object) to verify that the version in your event stream is current. ## `version_info`{% #version_info %} **Type**: `STRUCT`**Provider name**: `versionInfo`**Description**: The version information for the Amazon ECS container agent and Docker daemon running on the container instance. - `agent_hash`**Type**: `STRING`**Provider name**: `agentHash`**Description**: The Git commit hash for the Amazon ECS container agent build on the [amazon-ecs-agent ](https://github.com/aws/amazon-ecs-agent/commits/master)GitHub repository. - `agent_version`**Type**: `STRING`**Provider name**: `agentVersion`**Description**: The version number of the Amazon ECS container agent. - `docker_version`**Type**: `STRING`**Provider name**: `dockerVersion`**Description**: The Docker version that's running on the container instance.