AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

A regional grouping of one or more container instances on which 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.

Inheritance Hierarchy


Namespace: Amazon.ECS.Model
Assembly: AWSSDK.ECS.dll
Version: 3.x.y.z


public class Cluster

The Cluster type exposes the following members


Public Method Cluster()


Public Property ActiveServicesCount System.Int32

Gets and sets the property ActiveServicesCount.

The number of services that are running on the cluster in an ACTIVE state. You can view these services with ListServices.

Public Property ClusterArn System.String

Gets and sets the property ClusterArn.

The Amazon Resource Name (ARN) that identifies the cluster. The ARN contains the arn:aws:ecs namespace, followed by the Region of the cluster, the AWS account ID of the cluster owner, the cluster namespace, and then the cluster name. For example, arn:aws:ecs:region:012345678910:cluster/test..

Public Property ClusterName System.String

Gets and sets the property ClusterName.

A user-generated string that you use to identify your cluster.

Public Property PendingTasksCount System.Int32

Gets and sets the property PendingTasksCount.

The number of tasks in the cluster that are in the PENDING state.

Public Property RegisteredContainerInstancesCount System.Int32

Gets and sets the property RegisteredContainerInstancesCount.

The number of container instances registered into the cluster. This includes container instances in both ACTIVE and DRAINING status.

Public Property RunningTasksCount System.Int32

Gets and sets the property RunningTasksCount.

The number of tasks in the cluster that are in the RUNNING state.

Public Property Statistics System.Collections.Generic.List<Amazon.ECS.Model.KeyValuePair>

Gets and sets the property Statistics.

Additional information about your clusters that are separated by launch type, including:

  • runningEC2TasksCount

  • RunningFargateTasksCount

  • pendingEC2TasksCount

  • pendingFargateTasksCount

  • activeEC2ServiceCount

  • activeFargateServiceCount

  • drainingEC2ServiceCount

  • drainingFargateServiceCount

Public Property Status System.String

Gets and sets the property Status.

The status of the cluster. The valid values are ACTIVE or INACTIVE. ACTIVE indicates that you can register container instances with the cluster and the associated instances can accept tasks.

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms