Using the Job Management API - Amazon Snowcone User Guide
Common Uses of JMAPIJMAPI Required StringsJMAPI EndpointsJMAPI CLI CommandsExamples
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Using the Job Management API

The job management API (JMAPI) provides programmatic access to the same functionality available in the Amazon Snow Family Management Console. This enables you to automate job functionality. By using the JMAPI, you can see the job status, create jobs, download the manifest file, unlock code, and view job completion reports. Because the calls are made through the API, you can integrate these calls into a custom application or web front end.

Common Uses of JMAPI

  • Automating ordering of Snowcone devices

  • Downloading the manifest file

  • Downloading the unlock file

  • Listing out the current Snowcone jobs

  • Downloading the Snowcone job completion report

JMAPI Required Strings

When placing an order through the job management API, you use the following required parameters, which are shown with examples.

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

JMAPI Endpoints

API Endpoint

To make calls to each endpoint, the format is snowballEdge.region.amazonaws.com. Following are some examples to help you understand the breakdown of the endpoint.

Region Endpoint
US East (N. Virginia) snowball.us-east-1.amazonaws.com
US West (Oregon) snowball.us-west-2.amazonaws.com

JMAPI CLI Commands

Job Management CLI

The following are the CLI calls that you can make against the job management API.

Command Example
Listing Jobs aws snowball list-jobs
Describe Job aws snowball describe-job --job-id [JOB ID]
Describe Address aws snowball describe-address --address-id
Create Address aws snowball create-address --cli-input-json file://create-address.json
Create Job aws snowball create-job --cli-input-json file://create-job.json
Cancel Job aws snowball cancel-job --job-id [JOB ID]

Examples

The following are examples of commands using the job management API.

KMS JSON Example

The following JSON example is a properly formatted JSON file for using the Amazon KMS policy file.

{
    "KeyMetadata": {
        "Origin": "AWS_KMS",
        "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
        "Description": "",
        "KeyManager": "CUSTOMER",
        "Enabled": true,
        "KeyUsage": "ENCRYPT_DECRYPT",
        "KeyState": "Enabled",
        "CreationDate": 1502910355.475,
        "Arn": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
        "AWSAccountId": "111122223333"
    }
}

Create Address Example

The following examples show you how you would format the command to create your address and what the response is when it is successful.

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

Example Output

{
    "AddressId": "ADID3be640c8-1111-1111-1111-917f201ffa42"
}

Create Job Example

The following command shows you an example command for running the create-job command.

aws snowball create-job --job-type IMPORT --resources file://path/to/resources.json --address-id ADID3be640c8-1111-1111-1111-917f201ffa42 --region us-east-1 --role-arn arn:aws:iam::123456789123:role/example_role --kms-key-arn arn:aws:kms:us-west-2:000000000000:key/Example --snowball-capacity-preference T14 --device-configuration file://path/to/configuration.json --shipping-option SECOND_DAY --snowball-type SNC1_SSD

The above create-job command will create an import job in us-east-1 region with a SNC1_SSD type snowcone device having T14 capacity preference with a SECOND_DAY shipping option.