Cluster
A regional grouping of one or more container instances where you can run task requests. Each account receives a default cluster the first time you use the Amazon ECS service, but you may also create other clusters. Clusters may contain more than one instance type simultaneously.
Types
Properties
The number of services that are running on the cluster in an ACTIVE
state. You can view these services with PListServices.
The resources attached to a cluster. When using a capacity provider with a cluster, the capacity provider and associated resources are returned as cluster attachments.
The status of the capacity providers associated with the cluster. The following are the states that are returned.
The capacity providers associated with the cluster.
The Amazon Resource Name (ARN) that identifies the cluster. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.
A user-generated string that you use to identify your cluster.
The execute command and managed storage configuration for the cluster.
The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.
The number of tasks in the cluster that are in the PENDING
state.
The number of container instances registered into the cluster. This includes container instances in both ACTIVE
and DRAINING
status.
The number of tasks in the cluster that are in the RUNNING
state.
Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled
parameter to true
in the ServiceConnectConfiguration
. You can set the namespace of each service individually in the ServiceConnectConfiguration
to override this default parameter.
The settings for the cluster. This parameter indicates whether CloudWatch Container Insights is on or off for a cluster.
Additional information about your clusters that are separated by launch type. They include the following: