

# Welcome
<a name="Welcome"></a>

## Amazon Snowball Edge
<a name="Welcome_Amazon_Import_Export_Snowball"></a>

**Note**  
 Amazon Snowball Edge is no longer available to new customers. New customers should explore [Amazon DataSync](https://aws.amazon.com/datasync/) for online transfers, [Amazon Data Transfer Terminal](https://aws.amazon.com/data-transfer-terminal/) for secure physical transfers, or Amazon Partner solutions. For edge computing, explore [Amazon Outposts](https://aws.amazon.com/outposts/).

The job management API for Amazon Snowball Edge is a network protocol based on HTTP (RFC 2616). For more information on this RFC, see [HTTP (RFC 2616)](https://www.ietf.org/rfc/rfc2616.txt) on the IETF website. For each call to the job management API, you make an HTTP request to the region-specific job management API endpoint for the Amazon Web Services Region where you want to manage jobs. The API uses JSON (RFC 4627) documents for HTTP request/response bodies.

**Note**  
API calls made within the US regions for listing jobs or describing addresses return all jobs or addresses within the US for that account.

The job management API for Snowball Edge is an RPC model. In this model, there is a fixed set of operations and the syntax for each operation is known to clients without any previous interaction. Following, you can find a description of each API operation using an abstract RPC notation, with an operation name that does not appear on the wire. For each operation, the topic specifies the mapping to HTTP request elements.

The specific job management operation to which a given request maps is determined by a combination of the request's method (GET, PUT, POST, or DELETE) and which of the various patterns its Request-URI matches. If the operation is PUT or POST, Snowball Edge extracts call arguments from the Request-URI path segment, query parameters, and the JSON object in the request body.

Although the operation name, such as `CreateJob`, doesn't appear on the wire, these operation names are meaningful in Amazon Identity and Access Management (IAM) policies. The operation name is also used to name commands in command-line tools and elements of the Amazon SDK APIs. For example, the Amazon Command Line Interface (Amazon CLI) command `create-job` maps to the `CreateJob` operation. The operation name also appears in CloudTrail logs for Snowball Edge API calls.

For more information about using the job management API, including API endpoints, API version, and permission policies, see [Using the Job Management API](https://docs.amazonaws.cn/snowball/latest/developer-guide/api-using.html) in the * Amazon Snowball Edge Developer Guide*.

For information on installing and setting up the Amazon CLI, including specifying what regions you want to make Amazon CLI calls against, see the [Amazon Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/).

**Note**  
The job management API provides a programmatic interface to the same functionality available in the Amazon Snow Family Management Console, that is to create and manage jobs for Snowball Edge. To transfer data locally with a Snowball appliance, use the Snowball Edge Client or the S3 SDK Adapter for Snowball Edge. For more information, see [Transferring Data with a Snowball](https://docs.amazonaws.cn/snowball/latest/ug/snowball-data-transfer.html) in the * Amazon Snowball Edge User Guide*.  
If you use a Snowball Edge, use the Snowball Edge Client to unlock the appliance. For more information, see [Using the Snowball Client](https://docs.amazonaws.cn/snowball/latest/developer-guide/using-client.html) in the * Amazon Snowball Edge Developer Guide*.

## Amazon Snowball Edge Device Management
<a name="Welcome_AWS_Snow_Device_Management"></a>

 Amazon Snowball Edge Device Management allows you to manage your Amazon Snowball Edge devices and local Amazon services remotely. You can use Amazon Snowball Edge Device Management to create and manage tasks such as unlocking or rebooting a device, check device and task status, and manage Amazon EC2-compatible instances and resources on your device. For more information, see [Using Amazon Snowball Edge Device Management to manage Snowball Edge](https://docs.amazonaws.cn/snowball/latest/developer-guide/aws-sdm.html) in the * Amazon Snowball Edge Developer Guide*.