Menu
AWS Import/Export
Developer Guide

Structure of an AWS Import/Export POST Request

This section outlines the AWS Import/Export POST requests, which consist of the following:

  • Endpoint—The AWS Import/Export entry point, as shown following:

    https://importexport.amazonaws.com
  • Action—The action you want to perform, for example getting the status of an existing job (GetStatus). For a complete list, see Actions.

  • Parameters—A set of parameters common to all AWS Import/Export actions, and any request parameters supported by the AWS Import/Export API. For details, see Common Query Parameters.

Examples

Example AWS Import Export POST Request

The following is an AWS Import/Export sample POST request to get the status of a job.

POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:207

Action=GetStatus&SignatureMethod=HmacSHA256&JobId=JOBID&SignatureVersion=2&Version=2014-12-18&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D&Timestamp=2014-12-20T22%3A30%3A59.556Z

The body of the request is all on one line. However, line feeds have been added to make the examples easier to read.

POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:207

Action=GetStatus
&JobId=JOBID

&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Version=2014-12-18
&Signature=lBP67vCvGlDMBQ1dofZxg8E8SUEXAMPLE
&Timestamp=2014-12-20T22%3A30%3A59.556Z

The first line represents the type of http request.

Lines 2–4 contain the HTTP headers, including the endpoint of the request.

After the HTTP headers, the body of the request contains the list of parameters. Each parameter is separated from the next by an ampersand (&). The Action parameter indicates the action to perform. For a list of possible actions, see Actions.


Example AWS Import Export POST Response

The following is an AWS Import/Export example response:

<CreateJobResponse xmlns="http://importexport.amazonaws.com/">
  <CreateJobResult>
    <JobId>TEST1</JobId>   
      <SignatureFileContents>version:2.0
signingMethod:HmacSHA1
jobId:WXSPP
signature:jLbLVp54vBa/vuh/XW1MOMdZUxw=
      </SignatureFileContents>
      <AwsShippingAddress>Please use the GetShippingLabel command to print your pre-paid shipping label</AwsShippingAddress>
    <Signature>O3qG7xnI46ZEm9gi+eOy9dnSS9k=</Signature>
  </CreateJobResult>
  <ResponseMetadata>
    <RequestId>ace8cb5b-0ada-11df-a381-155bec6f7c93</RequestId>
  </ResponseMetadata>
  </CreateJobResponse>