DescribeReturnShippingLabel - Amazon Snowball
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).

DescribeReturnShippingLabel

Information on the shipping label of a Snow device that is being returned to Amazon.

Request Syntax

{ "JobId": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

JobId

The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000.

Type: String

Length Constraints: Fixed length of 39.

Pattern: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Required: Yes

Response Syntax

{ "ExpirationDate": number, "ReturnShippingLabelURI": "string", "Status": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

ExpirationDate

The expiration date of the current return shipping label.

Type: Timestamp

ReturnShippingLabelURI

The pre-signed Amazon S3 URI used to download the return shipping label.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: .*

Status

The status information of the task on a Snow device that is being returned to Amazon.

Type: String

Valid Values: InProgress | TimedOut | Succeeded | Failed

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

You get this exception when you call CreateReturnShippingLabel more than once when other requests are not completed.

HTTP Status Code: 400

InvalidJobStateException

The action can't be performed because the job's current state doesn't allow that action to be performed.

HTTP Status Code: 400

InvalidResourceException

The specified resource can't be found. Check the information you provided in your last request, and try again.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: