Menu
AWS Snowball
User Guide

Using the AWS Snowball Management Console

All jobs for AWS Snowball are created and managed from either the AWS Snowball Management Console or the job management API for AWS Snowball. The following provides an overview of how to use the AWS Snowball Management Console.

Getting the Status of Your Jobs

Each job has a status, which changes to denote the current state of the job.

Job StatusDescriptionJob Type That Status Applies To
Job createdYour job has just been created. This status is the only one during which you can cancel a job or its job parts, if the job is an export job.Both
Preparing SnowballAWS is preparing a Snowball for your job.Both
ExportingAWS is exporting your data from Amazon S3 onto a Snowball.Export
Preparing shipmentAWS is preparing to ship a Snowball to you.Both
In transit to youThe Snowball has been shipped to the address you provided during job creation.Both
Delivered to youThe Snowball has arrived at the address you provided during job creation.Both
In transit to AWSYou have shipped the Snowball back to AWS.Both
At AWSYour shipment has arrived at AWS. If you're importing data, your import typically begins within a day of its arrival.Both
ImportingAWS is importing your data into Amazon Simple Storage Service (Amazon S3).Import
CompletedYour import job or export job part has completed successfully.Both
CanceledYour job has been canceled. You can only cancel Snowball import jobs during the Job created status.Both

Cloning an Import Job in the Console

When you first create an import job, you might discover that you need more than one Snowball. Because each Snowball is associated with a single import job, requiring more than one Snowball means that you need to create more than one job. When creating additional jobs, you can go through the job creation wizard again, or you can clone an existing job.

Cloning a job means recreating it exactly, except for an automatically modified name. Cloning is a simple process.

To clone a job

  1. In the AWS Snowball Management Console, choose your job from the table.

  2. For Actions, choose Clone job.

  3. The Create job wizard opens to the last page, Step 6: Review.

  4. Review the information and make any changes you want by choosing the appropriate Edit button.

  5. To create your cloned job, choose Create job.

Cloned jobs are named in the format Job Name-clone-number. The number is automatically appended to the job name and represents the number of times you've cloned this job after the first time you clone it. For example, AprilFinanceReports-clone represents the first cloned job of AprilFinanceReports job, and DataCenterMigration-clone-42 represents the forty-second clone of the DataCenterMigration job.

Using Export Ranges

When you create an export job in the AWS Snowball Management Console, you can choose to export an entire Amazon S3 bucket or a specific range of objects keys. Object key names uniquely identify objects in a bucket. If you choose to export a range, you define the length of the range by providing either an inclusive range beginning, an inclusive range ending, or both.

Ranges are UTF-8 binary sorted. UTF-8 binary data is sorted in the following way:

  • The numbers 0-9 come before both uppercase and lowercase English characters.

  • Uppercase English characters come before all lowercase English characters.

  • Lowercase English characters come last when sorted against uppercase English characters and numbers.

  • Special characters are sorted among the other character sets.

For more information on the specifics of UTF-8 sort order, see https://en.wikipedia.org/wiki/UTF-8.

Export Range Examples

Assume you have a bucket containing the following objects, sorted in UTF-8 binary order.

  • 01

  • Aardvark

  • Aardwolf

  • Aasvogel/apple

  • Aasvogel/banana

  • Aasvogel/cherry

  • Banana

  • Car

Specified Range BeginningSpecified Range EndingObjects in the Range That Will Be Exported
(none)(none)All of the objects in your bucket
(none)Aasvogel

01

Aardvark

Aardwolf

Aasvogel/apple

Aasvogel/banana

Aasvogel/cherry

(none)Aasvogel/banana

01

Aardvark

Aardwolf

Aasvogel/apple

Aasvogel/banana

Aasvogel(none)

Aasvogel/apple

Aasvogel/banana

Aasvogel/cherry

Banana

Car

Aardwolf(none)

Aardwolf

Aasvogel/apple

Aasvogel/banana

Aasvogel/cherry

Banana

Car

Aar(none)

Aardvark

Aardwolf

Aasvogel/apple

Aasvogel/banana

Aasvogel/cherry

Banana

Car

car(none)

No objects will be exported, and you’ll get an error message when you try to create the job. Note that car is sorted below Car according to UTF-8 binary values.

AarAarrr

Aardvark

Aardwolf

Getting Your Job Completion Report and Logs in the Console

Whenever data is imported into or exported out of Amazon S3, you'll get a downloadable PDF job report. For import jobs, this report becomes available at the very end of the import process. For export jobs, your job report typically becomes available for you while the Snowball for your job part is being delivered to you.

The job report provides you insight into the state of your Amazon S3 data transfer. The report includes details about your job or job part for your records. The job report also includes a table that provides a high-level overview of the total number of objects and bytes transferred between the Snowball and Amazon S3.

For deeper visibility into the status of your transferred objects, you can look at the two associated logs: a success log and a failure log. The logs are saved in comma-separated value (CSV) format, and the name of each log includes the ID of the job or job part that the log describes.

You can download the report and the logs from the AWS Snowball Management Console.

To get your job report and logs

  1. Sign in to the AWS Management Console and open the AWS Snowball Management Console.

  2. Select your job or job part from the table and expand the status pane.

    Three options appear for getting your job report and logs: Get job report, Download success log, and Download failure log.

    Reports and logs.
  3. Choose your download.

The following list describes the possible values for the report.

  • Completed – The transfer was completed successfully. You can find more detailed information in the success log.

  • Completed with errors – Some or all of your data was not transferred. You can find more detailed information in the failure log.

Canceling Jobs in the Console

If you need to cancel a job for any reason, you can do so before it enters the Preparing Snowball status. You can only cancel jobs can when they have Job created status. Once a job begins processing, you can no longer cancel it.

To cancel a job

  1. Sign in to the AWS Management Console and open the AWS Snowball Management Console.

  2. Search for and choose your job from the table.

  3. From Actions, choose Cancel job.

You have now canceled your job.