AmazonECSClient.CreateCluster Method (CreateClusterRequest)

Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the CreateCluster action.

When you call the CreateCluster API operation, Amazon ECS attempts to create the Amazon ECS service-linked role for your account. This is so that it can manage required resources in other Amazon Web Services services on your behalf. However, if the user that makes the call doesn't have permissions to create the service-linked role, it isn't created. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateClusterAsync.

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

Syntax

public virtual CreateClusterResponse CreateCluster(
         CreateClusterRequest request
)

Parameters

request: Type: Amazon.ECS.Model.CreateClusterRequest

Container for the necessary parameters to execute the CreateCluster service method.

Return Value

Type: CreateClusterResponse

The response from the CreateCluster service method, as returned by ECS.

Exceptions

Exception	Condition
ClientException	These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.
InvalidParameterException	The specified parameter isn't valid. Review the available parameters for the API request.
NamespaceNotFoundException	The specified namespace wasn't found.
ServerException	These errors are usually caused by a server issue.

Examples

This example creates a cluster in your default region.

To create a new cluster


var client = new AmazonECSClient();
var response = client.CreateCluster(new CreateClusterRequest 
{
    ClusterName = "my_cluster"
});

Cluster cluster = response.Cluster;

Version Information

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

AmazonECSClient.CreateCluster (CreateClusterRequest)

Method