I want to create a job using the job management API for AWS Snowball. How can I do that?

Before you begin, be sure that you have set up the following values:

  • AWS Identity and Access Management (IAM) role Amazon Resource Name (ARN): You must have your IAM role ARN to use the job management API for Snowball. After you create your IAM role for using Snowball, you can find the role ARN in the Snowball console.
  • AWS Key Management Service (AWS KMS) key ARN: If you want to associate an existing KMS key with your Snowball job, you must have the KMS key ARN. To find your KMS key ARN using the IAM console or the ListKeys operation, see Finding the Key ID and ARN. To create a new KMS key, see Creating Keys. You must create the key in the same AWS Region as your Snowball job.

First, run this command to create an address ID for the address that the Snowball device should be shipped to:

aws snowball create-address --address "Name=Bob,Company=AWS,Street1=1234 Fake St.,City=All,StateOrProvince=Any,Country=US,PostalCode=12345,PhoneNumber=1234567890"

The command returns a response similar to the following:

{
   "AddressId": "example640c8-a724-112c-b8c3-917f201ffa42"
}

Then, run the following command to create the Snowball job. For --address-id, enter the address ID that you created. For --role-arn, enter the ARN of your IAM role. For --kms-key-arn, enter the ARN of your KMS key.

aws snowball create-job --job-type EXPORT --resources file://snowball --address-id example640c8-a724-112c-b8c3-917f201ffa42 --region us-west-2 --role-arn arn:aws:iam::000000000000:role/snowball-export-s3-only-role --kms-key-arn arn:aws:kms:us-west-2:000000000000:key/Example --shipping-option SECOND_DAY --snowball-type STANDARD

The following parameters are required to create a job using the job management API:

  • --job-type
  • --resources
  • --address-id
  • --region
  • --role-arn
  • --kms-key-arn
  • --shipping-option
  • --device-type
  • --description

Did this page help you? Yes | No

Back to the AWS Support Knowledge Center

Need help? Visit the AWS Support Center

Published: 2018-11-19