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.

Creates a job to import or export data between Amazon S3 and your on-premises data center. Your Amazon Web Services account must have the right trust policies and permissions in place to create a job for a Snow device. If you're creating a job for a node in a cluster, you only need to provide the clusterId value; the other job attributes are inherited from the cluster.

Only the Snowball; Edge device type is supported when ordering clustered jobs.

The device capacity is optional.

Availability of device types differ by Amazon Web Services Region. For more information about Region availability, see Amazon Web Services Regional Services.

Snow Family devices and their capacities.

Note:

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

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

Syntax

C# 
public virtual CreateJobResponse CreateJob(
         CreateJobRequest request
)

Parameters

request
Type: Amazon.Snowball.Model.CreateJobRequest

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

Return Value


Type: CreateJobResponse
The response from the CreateJob service method, as returned by Snowball.

Exceptions

ExceptionCondition
ClusterLimitExceededException Job creation failed. Currently, clusters support five nodes. If you have fewer than five nodes for your cluster and you have more nodes to create for this cluster, try again and create jobs until your cluster has exactly five nodes.
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

Creates a job to import or export data between Amazon S3 and your on-premises data center. Your AWS account must have the right trust policies and permissions in place to create a job for Snowball. If you're creating a job for a node in a cluster, you only need to provide the clusterId value; the other job attributes are inherited from the cluster.

To create a job


var client = new AmazonSnowballClient();
var response = client.CreateJob(new CreateJobRequest 
{
    AddressId = "ADID1234ab12-3eec-4eb3-9be6-9374c10eb51b",
    Description = "My Job",
    JobType = "IMPORT",
    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",
    SnowballCapacityPreference = "T80",
    SnowballType = "STANDARD"
});

string jobId = response.JobId;

Version Information

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

See Also

REST API Reference for CreateJob Operation