# Snowball Edge examples using Amazon CLI
<a name="cli_snowball_code_examples"></a>

The following code examples show you how to perform actions and implement common scenarios by using the Amazon Command Line Interface with Snowball Edge.

*Actions* are code excerpts from larger programs and must be run in context. While actions show you how to call individual service functions, you can see actions in context in their related scenarios.

Each example includes a link to the complete source code, where you can find instructions on how to set up and run the code in context.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `get-snowball-usage`
<a name="snowball_GetSnowballUsage_cli_topic"></a>

The following code example shows how to use `get-snowball-usage`.

**Amazon CLI**  
**To get information about the Snowball service limit for your account**  
The following `get-snowball-usage` example displays information about the Snowball service limit for your account, and also the number of Snowballs your account has in use.  

```
aws snowball get-snowball-usage
```
Output:  

```
{
    "SnowballLimit": 1,
    "SnowballsInUse": 0
}
```
FOR more information, see [Amazon Snowball Edge Limits](https://docs.aws.amazon.com/snowball/latest/developer-guide/limits.html) in the *Amazon Snowball Developer Guide*.  
+  For API details, see [GetSnowballUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/snowball/get-snowball-usage.html) in *Amazon CLI Command Reference*. 

### `list-jobs`
<a name="snowball_ListJobs_cli_topic"></a>

The following code example shows how to use `list-jobs`.

**Amazon CLI**  
**To list the current Snowball jobs in your account**  
The following `list-jobs` example displays an array of `JobListEntry` objects. In this example, a single job is listed.  

```
aws snowball list-jobs
```
Output:  

```
{
    "JobListEntries": [
        {
            "CreationDate": 2016-09-27T14:50Z,
             "Description": "Important Photos 2016-08-11",
             "IsMaster": TRUE,
             "JobId": "ABCd1e324fe-022f-488e-a98b-3b0566063db1",
             "JobState": "Complete",
             "JobType": "IMPORT",
             "SnowballType": "EDGE"
        }
   ]
}
```
For more information, see [Jobs for Amazon Snowball Edge devices](https://docs.aws.amazon.com/snowball/latest/developer-guide/jobs.html) in the *Amazon Snowball Developer Guide*.  
+  For API details, see [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/snowball/list-jobs.html) in *Amazon CLI Command Reference*.