AWS Snowball - Page 77

AWS Snowball User Guide
Using the Amazon S3 Adapter for Snowball
• --human-readable (boolean) File sizes are displayed in human-readable format.
• --summarize (boolean) Summary information is displayed (number of objects, total size).
• rm Deletes an object on the Snowball.
• --dryrun (boolean) The operations that would be performed using the specified command are
displayed without being run.
• --include (string) Don't exclude files or objects in the command that match the specified pattern.
For details, see Use of Exclude and Include Filters in the AWS CLI Command Reference.
• --exclude (string) Exclude all files or objects from the command that matches the specified
pattern.
• --only-show-errors (boolean) Only errors and warnings are displayed. All other output is
suppressed.
• --quiet (boolean) Operations performed by the specified command are not displayed.
Supported REST API Actions
Following, you can find REST API actions that you can use with the Snowball.
Topics
• Supported REST API Actions for Snowball (p. 71)
• Supported REST API Actions for Amazon S3 (p. 72)
Supported REST API Actions for Snowball
HEAD Snowball
Description
Currently, there's only one Snowball REST API operation, which can be used to return status information
for a specific device. This operation returns the status of a Snowball. This status includes information
that can be used by AWS Support for troubleshooting purposes.
You can't use this operation with the AWS SDKs or the AWS CLI. We recommend that you use curl or an
HTTP client. The request doesn't need to be signed for this operation.
Request
In the below example, the IP address for the Snowball is 192.0.2.0. Replace this value with the IP address
of your actual device.
curl -X HEAD http://192.0.2.0:8080
Response
<Status xsi:schemaLocation="http://s3.amazonaws.com/doc/2006-03-01/" xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance">
<snowballIp>127.0.0.1</snowballIp>
<snowballPort>8080</snowballPort>
<snowballId>device-id</snowballId>
<totalSpaceInBytes>499055067136</totalSpaceInBytes>
<freeSpaceInBytes>108367699968</freeSpaceInBytes>
<jobId>job-id</jobId>
<snowballServerVersion>1.0.1</snowballServerVersion>
<snowballServerBuild>DevBuild</snowballServerBuild>
<snowballClientVersion>Version 1.0</snowballClientVersion>
71