IAmazonSnowball.CreateCluster Method (CreateClusterRequest)

Creates an empty cluster. Each cluster supports five nodes. You use the CreateJob action separately to create the jobs for each of these nodes. The cluster does not ship until these five node jobs have been created.

Note:

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

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

Syntax

public abstract CreateClusterResponse CreateCluster(
         CreateClusterRequest request
)

Parameters

request: Type: Amazon.Snowball.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 Snowball.

Exceptions

Exception	Condition
Ec2RequestFailedException	Your user lacks the necessary Amazon EC2 permissions to perform the attempted action.
InvalidInputCombinationException	Job or cluster creation failed. One or more inputs were invalid. Confirm that the CreateClusterRequest$SnowballType value supports your CreateJobRequest$JobType, and try again.
InvalidResourceException	The specified resource can't be found. Check the information you provided in your last request, and try again.
KMSRequestFailedException	The provided Key Management Service key lacks the permissions to perform the specified CreateJob or UpdateJob action.

Examples

To create a cluster


var client = new AmazonSnowballClient();
var response = client.CreateCluster(new CreateClusterRequest 
{
    AddressId = "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b",
    Description = "MyCluster",
    JobType = "LOCAL_USE",
    KmsKeyARN = "arn:aws:kms:us-east-1:123456789012:key/abcd1234-12ab-34cd-56ef-123456123456",
    Notification = new Notification {
        JobStatesToNotify = new List<string> {
                        
        },
        NotifyAll = false
    },
    Resources = new JobResource { S3Resources = new List<S3Resource> {
        new S3Resource {
            BucketArn = "arn:aws:s3:::MyBucket",
            KeyRange = new KeyRange {  }
        }
    } },
    RoleARN = "arn:aws:iam::123456789012:role/snowball-import-S3-role",
    ShippingOption = "SECOND_DAY",
    SnowballType = "EDGE"
});

string clusterId = response.ClusterId;

Version Information

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

IAmazonSnowball.CreateCluster (CreateClusterRequest)

Method