5.0.0 • Published 7 years ago
@datafire/amazonaws_snowball v5.0.0
@datafire/amazonaws_snowball
Client library for Amazon Import/Export Snowball
Installation and Usage
npm install --save @datafire/amazonaws_snowball
let amazonaws_snowball = require('@datafire/amazonaws_snowball').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_snowball.CancelCluster({
"ClusterId": ""
}).then(data => {
console.log(data);
});
Description
AWS Snowball is a petabyte-scale data transport solution that uses secure appliances to transfer large amounts of data between your on-premises data centers and Amazon Simple Storage Service (Amazon S3). The Snowball commands described here provide access to the same functionality that is available in the AWS Snowball Management Console, which enables you to create and manage jobs for Snowball. To transfer data locally with a Snowball appliance, you'll need to use the Snowball client or the Amazon S3 API adapter for Snowball. For more information, see the User Guide.
Actions
CancelCluster
amazonaws_snowball.CancelCluster({
"ClusterId": ""
}, context)
Input
- input
object
- ClusterId required ClusterId
Output
- output CancelClusterResult
CancelJob
amazonaws_snowball.CancelJob({
"JobId": ""
}, context)
Input
- input
object
- JobId required JobId
Output
- output CancelJobResult
CreateAddress
amazonaws_snowball.CreateAddress({
"Address": {}
}, context)
Input
- input
object
- Address required Address
Output
- output CreateAddressResult
CreateCluster
amazonaws_snowball.CreateCluster({
"JobType": "",
"Resources": {},
"AddressId": "",
"RoleARN": "",
"ShippingOption": ""
}, context)
Input
- input
object
- AddressId required AddressId
- Description String
- ForwardingAddressId AddressId
- JobType required JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources required JobResource
- RoleARN required RoleARN
- ShippingOption required ShippingOption
- SnowballType SnowballType
Output
- output CreateClusterResult
CreateJob
amazonaws_snowball.CreateJob({}, context)
Input
- input
object
- AddressId AddressId
- ClusterId ClusterId
- Description String
- ForwardingAddressId AddressId
- JobType JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
- SnowballCapacityPreference SnowballCapacity
- SnowballType SnowballType
Output
- output CreateJobResult
DescribeAddress
amazonaws_snowball.DescribeAddress({
"AddressId": ""
}, context)
Input
- input
object
- AddressId required AddressId
Output
- output DescribeAddressResult
DescribeAddresses
amazonaws_snowball.DescribeAddresses({}, context)
Input
Output
- output DescribeAddressesResult
DescribeCluster
amazonaws_snowball.DescribeCluster({
"ClusterId": ""
}, context)
Input
- input
object
- ClusterId required ClusterId
Output
- output DescribeClusterResult
DescribeJob
amazonaws_snowball.DescribeJob({
"JobId": ""
}, context)
Input
- input
object
- JobId required JobId
Output
- output DescribeJobResult
GetJobManifest
amazonaws_snowball.GetJobManifest({
"JobId": ""
}, context)
Input
- input
object
- JobId required JobId
Output
- output GetJobManifestResult
GetJobUnlockCode
amazonaws_snowball.GetJobUnlockCode({
"JobId": ""
}, context)
Input
- input
object
- JobId required JobId
Output
- output GetJobUnlockCodeResult
GetSnowballUsage
amazonaws_snowball.GetSnowballUsage({}, context)
Input
- input
object
Output
- output GetSnowballUsageResult
ListClusterJobs
amazonaws_snowball.ListClusterJobs({
"ClusterId": ""
}, context)
Input
Output
- output ListClusterJobsResult
ListClusters
amazonaws_snowball.ListClusters({}, context)
Input
Output
- output ListClustersResult
ListJobs
amazonaws_snowball.ListJobs({}, context)
Input
Output
- output ListJobsResult
UpdateCluster
amazonaws_snowball.UpdateCluster({
"ClusterId": ""
}, context)
Input
- input
object
- AddressId AddressId
- ClusterId required ClusterId
- Description String
- ForwardingAddressId AddressId
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
Output
- output UpdateClusterResult
UpdateJob
amazonaws_snowball.UpdateJob({
"JobId": ""
}, context)
Input
- input
object
- AddressId AddressId
- Description String
- ForwardingAddressId AddressId
- JobId required JobId
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
- SnowballCapacityPreference SnowballCapacity
Output
- output UpdateJobResult
Definitions
Address
- Address
object
: The address that you want the Snowball or Snowballs associated with a specific job to be shipped to. Addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. Although no individual elements of the Address are required, if the address is invalid or unsupported, then an exception is thrown.
AddressId
- AddressId
string
AddressList
- AddressList
array
- items Address
Boolean
- Boolean
boolean
CancelClusterRequest
- CancelClusterRequest
object
- ClusterId required ClusterId
CancelClusterResult
- CancelClusterResult
object
CancelJobRequest
- CancelJobRequest
object
- JobId required JobId
CancelJobResult
- CancelJobResult
object
ClusterId
- ClusterId
string
ClusterLimitExceededException
- ClusterLimitExceededException
object
: Job creation failed. Currently, clusters support five nodes. If you have less than five nodes for your cluster and you have more nodes to create for this cluster, try again and create jobs until your cluster has exactly five notes.- Message String
ClusterListEntry
- ClusterListEntry
object
: Contains a cluster's state, a cluster's ID, and other important information.- ClusterId String
- ClusterState ClusterState
- CreationDate Timestamp
- Description String
ClusterListEntryList
- ClusterListEntryList
array
- items ClusterListEntry
ClusterMetadata
- ClusterMetadata
object
: Contains metadata about a specific cluster.- AddressId AddressId
- ClusterId String
- ClusterState ClusterState
- CreationDate Timestamp
- Description String
- ForwardingAddressId AddressId
- JobType JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
- SnowballType SnowballType
ClusterState
- ClusterState
string
(values: AwaitingQuorum, Pending, InUse, Complete, Cancelled)
CreateAddressRequest
- CreateAddressRequest
object
- Address required Address
CreateAddressResult
- CreateAddressResult
object
- AddressId String
CreateClusterRequest
- CreateClusterRequest
object
- AddressId required AddressId
- Description String
- ForwardingAddressId AddressId
- JobType required JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources required JobResource
- RoleARN required RoleARN
- ShippingOption required ShippingOption
- SnowballType SnowballType
CreateClusterResult
- CreateClusterResult
object
- ClusterId ClusterId
CreateJobRequest
- CreateJobRequest
object
- AddressId AddressId
- ClusterId ClusterId
- Description String
- ForwardingAddressId AddressId
- JobType JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
- SnowballCapacityPreference SnowballCapacity
- SnowballType SnowballType
CreateJobResult
- CreateJobResult
object
- JobId JobId
DataTransfer
- DataTransfer
object
: Defines the real-time status of a Snowball's data transfer while the appliance is at AWS. This data is only available while a job has a JobState value of InProgress, for both import and export jobs.
DescribeAddressRequest
- DescribeAddressRequest
object
- AddressId required AddressId
DescribeAddressResult
- DescribeAddressResult
object
- Address Address
DescribeAddressesRequest
DescribeAddressesResult
- DescribeAddressesResult
object
- Addresses AddressList
- NextToken String
DescribeClusterRequest
- DescribeClusterRequest
object
- ClusterId required ClusterId
DescribeClusterResult
- DescribeClusterResult
object
- ClusterMetadata ClusterMetadata
DescribeJobRequest
- DescribeJobRequest
object
- JobId required JobId
DescribeJobResult
- DescribeJobResult
object
- JobMetadata JobMetadata
- SubJobMetadata JobMetadataList
EventTriggerDefinition
- EventTriggerDefinition
object
: The container for the EventTriggerDefinition$EventResourceARN.- EventResourceARN ResourceARN
EventTriggerDefinitionList
- EventTriggerDefinitionList
array
- items EventTriggerDefinition
GetJobManifestRequest
- GetJobManifestRequest
object
- JobId required JobId
GetJobManifestResult
- GetJobManifestResult
object
- ManifestURI String
GetJobUnlockCodeRequest
- GetJobUnlockCodeRequest
object
- JobId required JobId
GetJobUnlockCodeResult
- GetJobUnlockCodeResult
object
- UnlockCode String
GetSnowballUsageRequest
- GetSnowballUsageRequest
object
GetSnowballUsageResult
Integer
- Integer
integer
InvalidAddressException
- InvalidAddressException
object
: The address provided was invalid. Check the address with your region's carrier, and try again.- Message String
InvalidInputCombinationException
- InvalidInputCombinationException
object
: Job or cluster creation failed. One ore more inputs were invalid. Confirm that the CreateClusterRequest$SnowballType value supports your CreateJobRequest$JobType, and try again.- Message String
InvalidJobStateException
- InvalidJobStateException
object
: The action can't be performed because the job's current state doesn't allow that action to be performed.- Message String
InvalidNextTokenException
- InvalidNextTokenException
object
: The NextToken string was altered unexpectedly, and the operation has stopped. Run the operation without changing the NextToken string, and try again.- Message String
InvalidResourceException
- InvalidResourceException
object
: The specified resource can't be found. Check the information you provided in your last request, and try again.- Message String
JobId
- JobId
string
JobListEntry
- JobListEntry
object
: Each JobListEntry object contains a job's state, a job's ID, and a value that indicates whether the job is a job part, in the case of an export job.
JobListEntryList
- JobListEntryList
array
- items JobListEntry
JobLogs
- JobLogs
object
: Contains job logs. Whenever Snowball is used to import data into or export data out of Amazon S3, you'll have the option of downloading a PDF job report. Job logs are returned as a part of the response syntax of the DescribeJob action in the JobMetadata data type. The job logs can be accessed for up to 60 minutes after this request has been made. To access any of the job logs after 60 minutes have passed, you'll have to make another call to the DescribeJob action. For import jobs, the PDF job report becomes available at the end of the import process. For export jobs, your job report typically becomes available while the Snowball for your job part is being delivered to you. The job report provides you insight into the state of your Amazon S3 data transfer. The report includes details about your job or job part for your records. For deeper visibility into the status of your transferred objects, you can look at the two associated logs: a success log and a failure log. The logs are saved in comma-separated value (CSV) format, and the name of each log includes the ID of the job or job part that the log describes.
JobMetadata
- JobMetadata
object
: Contains information about a specific job including shipping information, job status, and other important metadata. This information is returned as a part of the response syntax of the DescribeJob action.- AddressId AddressId
- ClusterId String
- CreationDate Timestamp
- DataTransferProgress DataTransfer
- Description String
- ForwardingAddressId AddressId
- JobId String
- JobLogInfo JobLogs
- JobState JobState
- JobType JobType
- KmsKeyARN KmsKeyARN
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingDetails ShippingDetails
- SnowballCapacityPreference SnowballCapacity
- SnowballType SnowballType
JobMetadataList
- JobMetadataList
array
- items JobMetadata
JobResource
- JobResource
object
: Contains an array of S3Resource objects. Each S3Resource object represents an Amazon S3 bucket that your transferred data will be exported from or imported into.- LambdaResources LambdaResourceList
- S3Resources S3ResourceList
JobState
- JobState
string
(values: New, PreparingAppliance, PreparingShipment, InTransitToCustomer, WithCustomer, InTransitToAWS, WithAWS, InProgress, Complete, Cancelled, Listing, Pending)
JobStateList
- JobStateList
array
- items JobState
JobType
- JobType
string
(values: IMPORT, EXPORT, LOCAL_USE)
KMSRequestFailedException
- KMSRequestFailedException
object
: The provided AWS Key Management Service key lacks the permissions to perform the specified CreateJob or UpdateJob action.- Message String
KeyRange
- KeyRange
object
: Contains a key range. For export jobs, a S3Resource object can have an optional KeyRange value. The length of the range is defined at job creation, and has either an inclusive BeginMarker, an inclusive EndMarker, or both. Ranges are UTF-8 binary sorted.
KmsKeyARN
- KmsKeyARN
string
LambdaResource
- LambdaResource
object
: Identifies- EventTriggers EventTriggerDefinitionList
- LambdaArn ResourceARN
LambdaResourceList
- LambdaResourceList
array
- items LambdaResource
ListClusterJobsRequest
ListClusterJobsResult
- ListClusterJobsResult
object
- JobListEntries JobListEntryList
- NextToken String
ListClustersRequest
ListClustersResult
- ListClustersResult
object
- ClusterListEntries ClusterListEntryList
- NextToken String
ListJobsRequest
ListJobsResult
- ListJobsResult
object
- JobListEntries JobListEntryList
- NextToken String
ListLimit
- ListLimit
integer
Long
- Long
integer
Notification
- Notification
object
: The Amazon Simple Notification Service (Amazon SNS) notification settings associated with a specific job. The Notification object is returned as a part of the response syntax of the DescribeJob action in the JobMetadata data type. When the notification settings are defined during job creation, you can choose to notify based on a specific set of job states using the JobStatesToNotify array of strings, or you can specify that you want to have Amazon SNS notifications sent out for all job states with NotifyAll set to true.- JobStatesToNotify JobStateList
- NotifyAll Boolean
- SnsTopicARN SnsTopicARN
ResourceARN
- ResourceARN
string
RoleARN
- RoleARN
string
S3Resource
- S3Resource
object
: Each S3Resource object represents an Amazon S3 bucket that your transferred data will be exported from or imported into. For export jobs, this object can have an optional KeyRange value. The length of the range is defined at job creation, and has either an inclusive BeginMarker, an inclusive EndMarker, or both. Ranges are UTF-8 binary sorted.- BucketArn ResourceARN
- KeyRange KeyRange
S3ResourceList
- S3ResourceList
array
- items S3Resource
Shipment
- Shipment
object
: The Status and TrackingNumber information for an inbound or outbound shipment.
ShippingDetails
- ShippingDetails
object
: A job's shipping information, including inbound and outbound tracking numbers and shipping speed options.- InboundShipment Shipment
- OutboundShipment Shipment
- ShippingOption ShippingOption
ShippingOption
- ShippingOption
string
(values: SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD)
SnowballCapacity
- SnowballCapacity
string
(values: T50, T80, T100, NoPreference)
SnowballType
- SnowballType
string
(values: STANDARD, EDGE)
SnsTopicARN
- SnsTopicARN
string
String
- String
string
Timestamp
- Timestamp
string
UnsupportedAddressException
- UnsupportedAddressException
object
: The address is either outside the serviceable area for your region, or an error occurred. Check the address with your region's carrier and try again. If the issue persists, contact AWS Support.- Message String
UpdateClusterRequest
- UpdateClusterRequest
object
- AddressId AddressId
- ClusterId required ClusterId
- Description String
- ForwardingAddressId AddressId
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
UpdateClusterResult
- UpdateClusterResult
object
UpdateJobRequest
- UpdateJobRequest
object
- AddressId AddressId
- Description String
- ForwardingAddressId AddressId
- JobId required JobId
- Notification Notification
- Resources JobResource
- RoleARN RoleARN
- ShippingOption ShippingOption
- SnowballCapacityPreference SnowballCapacity
UpdateJobResult
- UpdateJobResult
object