Menu
AWS Import/Export
Developer Guide

GetShippingLabel

Description

This action generates a pre-paid shipping label that you will use to ship your device to AWS for processing.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters

Name Description Required

Action

Specifies the action to invoke.

Type: String

Default: None

Valid Values: GetShippingLabel

Yes

JobIDs

Specifies the jobs that will be shipped in the same package. No more than 8 jobs can be specified in one GetShippingLabel action.

Type: Comma separated strings

Default: None

Valid Values: Valid Job IDs

Yes

name

The name of the person sending the package.

Type: String

Default: None

Yes

company

The name of the company sending the package.

Type: String

Default: None

Yes

phoneNumber

A valid contact phone number.

Type: String

Default: None

Yes

stateOrProvince

The name of the state or province the package is being shipped from. Required for USA and Canada.

Type: String

Default: None

Yes

city

The name of the city being shipped from.

Type: String

Default: None

Yes

postalCode

The postal code from where the package is being shipped.

Type: String

Default: None

Yes

street1

The street address from where the package is being shipped.

Type: String

Default: None

Yes

street2

A continuation of the street address from where the package is being shipped.

Type: String

Default: None

No

street3

A continuation of the street address from where the package is being shipped from.

Type: String

Default: None

No

Response Elements

Name Description
ShippingLabelURL

The URL of your preprinted label. The URL returned will reference a PDF file that you should download, print, and attach to the package you will use to ship your devices in.

Type: String

Errors

For a list of common errors, see Error and Status Codes.

Examples

Sample Request

Copy
POST / HTTP/1.1 content-type:application/x-www-form-urlencoded;charset=utf-8 host: https://importexport.amazonaws.com content-length:639 JobIDs=ABC12%2CBCD23%2CCDE34&name=Joe%20User&company=MyCo%20Incorporated&phoneNumber=%28123%29%20456%2D7890&country=USA&stateOrProvince=WA&city=Seattle&postalCode=98123&street1=1234%20Main%20St%2E&street2=Suite%20101&Action=GetShippingLabel&SignatureMethod=HmacSHA256 &SignatureVersion=2&Version=2010-06-01 &Signature=%2F5UvjcJOE1PqUa%2BcmnzadQYs2frTAt8LSo3M5o%2BEH0%3D&Timestamp= 2011-06-20T18%3A49%3A14.981Z

Sample Response

Copy
<GetShippingLabelResponse xmlns="http://importexport.amazonaws.com/"> <GetShippingLabelResult> <ShippingLabelURL>https://s3.amazonaws.com/logbucket/shipping-label.ABC12.BCD23.CDE34.pdf</ShippingLabelURL> <Signature>O3qG7xnI46ZEm9gi+eOy9dnSS9k=</Signature> </GetShippingLabelResult> <ResponseMetadata> <RequestId>ace8cb5b-0ada-11df-a381-155bec6f7c93</RequestId> </ResponseMetadata> </GetShippingLabelResponse>

Related actions

The following actions are related to GetShippingLabel.