AWS Snowball - Page 74

AWS Snowball User Guide
Using the Amazon S3 Adapter for Snowball
Note
When requesting the status of a Snowball, you must add the authorization header. For more
information, see Signing AWS Requests with Signature Version 4.
An example of the XML document that this request returns follows.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Status xsi:schemaLocation="http://s3.amazonaws.com/doc/2006-03-01/" xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance">
 <snowballIp>192.0.2.0</snowballIp>
 <snowballPort>8080</snowballPort>
 <snowballId>012EXAMPLE01</snowballId>
 <totalSpaceInBytes>77223428091904</totalSpaceInBytes>
 <freeSpaceInBytes>77223428091904</freeSpaceInBytes>
 <jobId>JID850f06EXAMPLE-4EXA-MPLE-2EXAMPLEab00</jobId>
 <snowballServerVersion>1.0.1</snowballServerVersion>
 <snowballServerBuild>2016-08-22.5729552357</snowballServerBuild>
 <snowballAdapterVersion>Version 1.0</snowballAdapterVersion>
 <snowballRoundTripLatencyInMillis>1</snowballRoundTripLatencyInMillis>
</Status>
Unsupported Amazon S3 Features for Snowball
Using the Amazon S3 Adapter for Snowball, you can programmatically transfer data to and from a
Snowball with Amazon S3 API actions. However, not all Amazon S3 transfer features and API actions
are supported for use with a Snowball device. For more information on the supported features, see the
following:
• Using the Adapter with Amazon S3 Commands for the AWS CLI (p. 70)
• Supported REST API Actions (p. 71)
Any features or actions not explicitly listed in these topics are not supported. For example, the following
features and actions are not supported for use with Snowball:
• TransferManager – This utility transfers files from a local environment to Amazon S3 with the SDK for
Java. Consider using the supported API actions or AWS CLI commands with the adapter instead.
• GET Bucket (List Objects) Version 2 – This implementation of the GET action returns some or all (up to
1,000) of the objects in a bucket. Consider using the GET Bucket (List Objects) Version 1 action or the ls
AWS CLI command.
Options for the Amazon S3 Adapter for Snowball
Following, you can find information on Amazon S3 Adapter for Snowball options that help you configure
how the adapter communicates with a Snowball.
Note
Before transferring data into Amazon S3 using Snowball, make sure that the files and directories
that you're going to transfer are named according to the Object Key Naming Guidelines.
Option Description Usage and Example
-a
--aws-
profile-name
The AWS profile name that you want to use to
sign requests to the Snowball. By default, the
adapter uses the credentials specified in the home
directory/.aws/credentials file, under the
snowball-adapter -a
snowball-adapter -a
Lauren
68