Smaws_Client_Snowball.Types
type nonrec wireless_connection = {
is_wifi_enabled : boolean_ option;
Enables the Wi-Fi adapter on an Snowcone device.
*)}
Configures the wireless connection on an Snowcone device.
type nonrec update_long_term_pricing_request = {
is_long_term_pricing_auto_renew : java_boolean option;
If set to true
, specifies that the current long-term pricing type for the device should be automatically renewed before the long-term pricing contract expires.
replacement_job : job_id option;
Specifies that a device that is ordered with long-term pricing should be replaced with a new device.
*)long_term_pricing_id : long_term_pricing_id;
The ID of the long-term pricing type for the device.
*)}
The specified resource can't be found. Check the information you provided in your last request, and try again.
type nonrec update_job_shipment_state_request = {
shipment_state : shipment_state;
The state of a device when it is being shipped.
Set to RECEIVED
when the device arrives at your location.
Set to RETURNED
when you have returned the device to Amazon Web Services.
job_id : job_id;
The job ID of the job whose shipment date you want to update, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
The action can't be performed because the job's current state doesn't allow that action to be performed.
type nonrec job_state_list = job_state list
type nonrec notification = {
device_pickup_sns_topic_ar_n : sns_topic_ar_n option;
Used to send SNS notifications for the person picking up the device (identified during job creation).
*)notify_all : boolean_ option;
Any change in job state will trigger a notification for this job.
*)job_states_to_notify : job_state_list option;
The list of job states that will trigger a notification for this job.
*)sns_topic_ar_n : sns_topic_ar_n option;
The new SNS TopicArn
that you want to associate with this job. You can create Amazon Resource Names (ARNs) for topics by using the CreateTopic Amazon SNS API action.
You can subscribe email addresses to an Amazon SNS topic through the Amazon Web Services Management Console, or by using the Subscribe Amazon Simple Notification Service (Amazon SNS) API action.
*)}
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.
type nonrec key_range = {
end_marker : string_ option;
The key that ends an optional key range for an export job. Ranges are inclusive and UTF-8 binary sorted.
*)begin_marker : string_ option;
The key that starts an optional key range for an export job. Ranges are inclusive and UTF-8 binary sorted.
*)}
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.
type nonrec target_on_device_service = {
transfer_option : transfer_option option;
Specifies whether the data is being imported or exported. You can import or export the data, or use it locally on the device.
*)service_name : device_service_name option;
Specifies the name of the service on the Snow Family device that your transferred data will be exported from or imported into.
*)}
An object that represents the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family supports Amazon S3 and NFS (Network File System).
type nonrec target_on_device_service_list = target_on_device_service list
type nonrec s3_resource = {
target_on_device_services : target_on_device_service_list option;
Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family supports Amazon S3 and NFS (Network File System).
*)key_range : key_range option;
For export jobs, you can provide an optional KeyRange
within a specific Amazon S3 bucket. 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.
bucket_arn : resource_ar_n option;
The Amazon Resource Name (ARN) of an Amazon S3 bucket.
*)}
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.
type nonrec s3_resource_list = s3_resource list
type nonrec event_trigger_definition = {
event_resource_ar_n : resource_ar_n option;
The Amazon Resource Name (ARN) for any local Amazon S3 resource that is an Lambda function's event trigger associated with this job.
*)}
The container for the EventTriggerDefinition$EventResourceARN
.
type nonrec event_trigger_definition_list = event_trigger_definition list
type nonrec lambda_resource = {
event_triggers : event_trigger_definition_list option;
The array of ARNs for S3Resource
objects to trigger the LambdaResource
objects associated with this job.
lambda_arn : resource_ar_n option;
An Amazon Resource Name (ARN) that represents an Lambda function to be triggered by PUT object actions on the associated local Amazon S3 resource.
*)}
Identifies
type nonrec lambda_resource_list = lambda_resource list
type nonrec ec2_ami_resource = {
snowball_ami_id : string_ option;
The ID of the AMI on the Snow device.
*)ami_id : ami_id;
The ID of the AMI in Amazon EC2.
*)}
A JSON-formatted object that contains the IDs for an Amazon Machine Image (AMI), including the Amazon EC2-compatible AMI ID and the Snow device AMI ID. Each AMI has these two IDs to simplify identifying the AMI in both the Amazon Web Services Cloud and on the device.
type nonrec ec2_ami_resource_list = ec2_ami_resource list
type nonrec job_resource = {
ec2_ami_resources : ec2_ami_resource_list option;
The Amazon Machine Images (AMIs) associated with this job.
*)lambda_resources : lambda_resource_list option;
The Python-language Lambda functions for this job.
*)s3_resources : s3_resource_list option;
An array of S3Resource
objects.
}
Contains an array of Amazon Web Services resource objects. Each object represents an Amazon S3 bucket, an Lambda function, or an Amazon Machine Image (AMI) based on Amazon EC2 that is associated with a particular job.
type nonrec nfs_on_device_service_configuration = {
storage_unit : storage_unit option;
The scale unit of the NFS storage on the device.
Valid values: TB.
*)storage_limit : storage_limit option;
The maximum NFS storage for one Snow Family device.
*)}
An object that represents the metadata and configuration settings for the NFS (Network File System) service on an Amazon Web Services Snow Family device.
type nonrec tgw_on_device_service_configuration = {
storage_unit : storage_unit option;
The scale unit of the virtual tapes on the device.
*)storage_limit : storage_limit option;
The maximum number of virtual tapes to store on one Snow Family device. Due to physical resource limitations, this value must be set to 80 for Snowball Edge.
*)}
An object that represents the metadata and configuration settings for the Storage Gateway service Tape Gateway type on an Amazon Web Services Snow Family device.
type nonrec eks_on_device_service_configuration = {
eks_anywhere_version : string_ option;
The optional version of EKS Anywhere on the Snow Family device.
*)kubernetes_version : string_ option;
The Kubernetes version for EKS Anywhere on the Snow Family device.
*)}
An object representing the metadata and configuration settings of EKS Anywhere on the Snow Family device.
type nonrec s3_on_device_service_configuration = {
fault_tolerance : node_fault_tolerance option;
>Fault tolerance level of the cluster. This indicates the number of nodes that can go down without degrading the performance of the cluster. This additional input helps when the specified StorageLimit
matches more than one Amazon S3 compatible storage on Snow family devices service configuration.
service_size : service_size option;
Applicable when creating a cluster. Specifies how many nodes are needed for Amazon S3 compatible storage on Snow family devices. If specified, the other input can be omitted.
*)storage_unit : storage_unit option;
Storage unit. Currently the only supported unit is TB.
*)storage_limit : s3_storage_limit option;
If the specified storage limit value matches storage limit of one of the defined configurations, that configuration will be used. If the specified storage limit value does not match any defined configuration, the request will fail. If more than one configuration has the same storage limit as specified, the other input need to be provided.
*)}
Amazon S3 compatible storage on Snow family devices configuration items.
type nonrec on_device_service_configuration = {
s3_on_device_service : s3_on_device_service_configuration option;
Configuration for Amazon S3 compatible storage on Snow family devices.
*)eks_on_device_service : eks_on_device_service_configuration option;
The configuration of EKS Anywhere on the Snow Family device.
*)tgw_on_device_service : tgw_on_device_service_configuration option;
Represents the Storage Gateway service Tape Gateway type on a Snow Family device.
*)nfs_on_device_service : nfs_on_device_service_configuration option;
Represents the NFS (Network File System) service on a Snow Family device.
*)}
An object that represents the metadata and configuration settings for services on an Amazon Web Services Snow Family device.
type nonrec pickup_details = {
device_pickup_id : device_pickup_id option;
The unique ID for a device that will be picked up.
*)identification_issuing_org : string_ option;
Organization that issued the credential identifying the person picking up the device.
*)identification_expiration_date : timestamp option;
Expiration date of the credential identifying the person picking up the device.
*)identification_number : string_ option;
The number on the credential identifying the person picking up the device.
*)email : email option;
The email address of the person picking up the device.
*)phone_number : phone_number option;
The phone number of the person picking up the device.
*)name : string_ option;
The name of the person picking up the device.
*)}
Information identifying the person picking up the device.
type nonrec update_job_request = {
pickup_details : pickup_details option;
forwarding_address_id : address_id option;
The updated ID for the forwarding address for a job. This field is not supported in most regions.
*)snowball_capacity_preference : snowball_capacity option;
The updated SnowballCapacityPreference
of this job's JobMetadata
object. The 50 TB Snowballs are only available in the US regions.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)description : string_ option;
The updated description of this job's JobMetadata
object.
shipping_option : shipping_option option;
The updated shipping option value of this job's ShippingDetails
object.
address_id : address_id option;
The ID of the updated Address
object.
on_device_service_configuration : on_device_service_configuration option;
Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family supports Amazon S3 and NFS (Network File System) and the Amazon Web Services Storage Gateway service Tape Gateway type.
*)resources : job_resource option;
The updated JobResource
object, or the updated JobResource
object.
notification : notification option;
The new or updated Notification
object.
role_ar_n : role_ar_n option;
The new role Amazon Resource Name (ARN) that you want to associate with this job. To create a role ARN, use the CreateRoleIdentity and Access Management (IAM) API action.
*)job_id : job_id;
The job ID of the job that you want to update, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
The provided Key Management Service key lacks the permissions to perform the specified CreateJob
or UpdateJob
action.
Job or cluster creation failed. One or more inputs were invalid. Confirm that the CreateClusterRequest$SnowballType
value supports your CreateJobRequest$JobType
, and try again.
Your user lacks the necessary Amazon EC2 permissions to perform the attempted action.
Job creation failed. Currently, clusters support five nodes. If you have fewer 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 nodes.
type nonrec update_cluster_request = {
forwarding_address_id : address_id option;
The updated ID for the forwarding address for a cluster. This field is not supported in most regions.
*)notification : notification option;
The new or updated Notification
object.
shipping_option : shipping_option option;
The updated shipping option value of this cluster's ShippingDetails
object.
address_id : address_id option;
The ID of the updated Address
object.
on_device_service_configuration : on_device_service_configuration option;
Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family device clusters support Amazon S3 and NFS (Network File System).
*)resources : job_resource option;
The updated arrays of JobResource
objects that can include updated S3Resource
objects or LambdaResource
objects.
description : string_ option;
The updated description of this cluster.
*)role_ar_n : role_ar_n option;
The new role Amazon Resource Name (ARN) that you want to associate with this cluster. To create a role ARN, use the CreateRole API action in Identity and Access Management (IAM).
*)cluster_id : cluster_id;
The cluster ID of the cluster that you want to update, for example CID123e4567-e89b-12d3-a456-426655440000
.
}
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 Amazon Web Services Support.
type nonrec ind_tax_documents = {
gsti_n : gsti_n option;
The Goods and Services Tax (GST) documents required in Amazon Web Services Region in India.
*)}
The tax documents required in Amazon Web Services Region in India.
The tax documents required in your Amazon Web Services Region.
type nonrec snowcone_device_configuration = {
wireless_connection : wireless_connection option;
Configures the wireless connection for the Snowcone device.
*)}
Specifies the device configuration for an Snowcone job.
type nonrec shipment = {
tracking_number : string_ option;
The tracking number for this job. Using this tracking number with your region's carrier's website, you can track a Snow device as the carrier transports it.
For India, the carrier is Amazon Logistics. For all other regions, UPS is the carrier.
*)status : string_ option;
Status information for a shipment.
*)}
The Status
and TrackingNumber
information for an inbound or outbound shipment.
type nonrec shipping_details = {
outbound_shipment : shipment option;
The Status
and TrackingNumber
values for a Snow device being delivered to the address that you specified for a particular job.
inbound_shipment : shipment option;
The Status
and TrackingNumber
values for a Snow device being returned to Amazon Web Services for a particular job.
shipping_option : shipping_option option;
The shipping speed for a particular job. This speed doesn't dictate how soon you'll get the Snow device from the job's creation date. This speed represents how quickly it moves to its destination while in transit. Regional shipping speeds are as follows:
}
A job's shipping information, including inbound and outbound tracking numbers and shipping speed options.
type nonrec service_version = {
version : string_ option;
The version number of the requested service.
*)}
The version of the requested service.
type nonrec service_version_list = service_version list
You get this exception if you call CreateReturnShippingLabel
and a valid return shipping label already exists. In this case, use DescribeReturnShippingLabel
to get the URL.
type nonrec long_term_pricing_associated_job_id_list = job_id list
type nonrec long_term_pricing_list_entry = {
job_ids : long_term_pricing_associated_job_id_list option;
The IDs of the jobs that are associated with a long-term pricing type.
*)snowball_type : snowball_type option;
The type of Snow Family devices associated with this long-term pricing job.
*)long_term_pricing_status : string_ option;
The status of the long-term pricing type.
*)is_long_term_pricing_auto_renew : java_boolean option;
If set to true
, specifies that the current long-term pricing type for the device should be automatically renewed before the long-term pricing contract expires.
replacement_job : job_id option;
A new device that replaces a device that is ordered with long-term pricing.
*)current_active_job : job_id option;
The current active jobs on the device the long-term pricing type.
*)long_term_pricing_type : long_term_pricing_type option;
The type of long-term pricing that was selected for the device.
*)long_term_pricing_start_date : timestamp option;
The start date of the long-term pricing contract.
*)long_term_pricing_end_date : timestamp option;
The end date the long-term pricing contract.
*)long_term_pricing_id : long_term_pricing_id option;
The ID of the long-term pricing type for the device.
*)}
Each LongTermPricingListEntry
object contains information about a long-term pricing type.
type nonrec long_term_pricing_id_list = long_term_pricing_id list
type nonrec long_term_pricing_entry_list = long_term_pricing_list_entry list
type nonrec dependent_service = {
service_version : service_version option;
The version of the dependent service.
*)service_name : service_name option;
The name of the dependent service.
*)}
The name and version of the service dependant on the requested service.
type nonrec dependent_service_list = dependent_service list
type nonrec list_service_versions_result = {
next_token : string_ option;
Because HTTP requests are stateless, this is the starting point of the next list of returned ListServiceVersionsResult
results.
dependent_services : dependent_service_list option;
A list of names and versions of dependant services of the service for which the system provided supported versions.
*)service_name : service_name;
The name of the service for which the system provided supported versions.
*)service_versions : service_version_list;
A list of supported versions.
*)}
type nonrec list_service_versions_request = {
next_token : string_ option;
Because HTTP requests are stateless, this is the starting point for the next list of returned ListServiceVersionsRequest
versions.
max_results : list_limit option;
The maximum number of ListServiceVersions
objects to return.
dependent_services : dependent_service_list option;
A list of names and versions of dependant services of the requested service.
*)service_name : service_name;
The name of the service for which you're requesting supported versions.
*)}
The NextToken
string was altered unexpectedly, and the operation has stopped. Run the operation without changing the NextToken
string, and try again.
type nonrec address = {
type_ : address_type option;
Differentiates between delivery address and pickup address in the customer account. Provided at job creation.
*)is_restricted : boolean_ option;
If the address you are creating is a primary address, then set this option to true. This field is not supported in most regions.
*)phone_number : string_ option;
The phone number associated with an address that a Snow device is to be delivered to.
*)postal_code : string_ option;
The postal code in an address that a Snow device is to be delivered to.
*)country : string_ option;
The country in an address that a Snow device is to be delivered to.
*)landmark : string_ option;
This field is no longer used and the value is ignored.
*)prefecture_or_district : string_ option;
This field is no longer used and the value is ignored.
*)state_or_province : string_ option;
The state or province in an address that a Snow device is to be delivered to.
*)city : string_ option;
The city in an address that a Snow device is to be delivered to.
*)street3 : string_ option;
The third line in a street address that a Snow device is to be delivered to.
*)street2 : string_ option;
The second line in a street address that a Snow device is to be delivered to.
*)street1 : string_ option;
The first line in a street address that a Snow device is to be delivered to.
*)company : string_ option;
The name of the company to receive a Snow device at an address.
*)name : string_ option;
The name of a person to receive a Snow device at an address.
*)address_id : address_id option;
The unique ID for an address.
*)}
The address that you want the Snow device(s) 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.
type nonrec address_list = address list
type nonrec list_pickup_locations_result = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of ListPickupLocationsResult
objects, you have the option of specifying NextToken
as the starting point for your returned list.
addresses : address_list option;
Information about the address of pickup locations.
*)}
type nonrec list_pickup_locations_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of ListPickupLocationsRequest
objects, you have the option of specifying NextToken
as the starting point for your returned list.
max_results : list_limit option;
The maximum number of locations to list per page.
*)}
type nonrec list_long_term_pricing_result = {
next_token : string_ option;
Because HTTP requests are stateless, this is the starting point for your next list of returned ListLongTermPricing
list.
long_term_pricing_entries : long_term_pricing_entry_list option;
Each LongTermPricingEntry
object contains a status, ID, and other information about the LongTermPricing
type.
}
type nonrec list_long_term_pricing_request = {
next_token : string_ option;
Because HTTP requests are stateless, this is the starting point for your next list of ListLongTermPricing
to return.
max_results : list_limit option;
The maximum number of ListLongTermPricing
objects to return.
}
type nonrec job_list_entry = {
description : string_ option;
The optional description of this specific job, for example Important Photos 2016-08-11
.
creation_date : timestamp option;
The creation date for this job.
*)snowball_type : snowball_type option;
The type of device used with this job.
*)job_type : job_type option;
The type of job.
*)is_master : boolean_ option;
A value that indicates that this job is a main job. A main job represents a successful request to create an export job. Main jobs aren't associated with any Snowballs. Instead, each main job will have at least one job part, and each job part is associated with a Snowball. It might take some time before the job parts associated with a particular main job are listed, because they are created after the main job is created.
*)job_state : job_state option;
The current state of this job.
*)job_id : string_ option;
The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
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.
type nonrec job_list_entry_list = job_list_entry list
type nonrec list_jobs_result = {
next_token : string_ option;
HTTP requests are stateless. If you use this automatically generated NextToken
value in your next ListJobs
call, your returned JobListEntry
objects will start from this point in the array.
job_list_entries : job_list_entry_list option;
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 export jobs.
}
type nonrec list_jobs_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of JobListEntry
objects, you have the option of specifying NextToken
as the starting point for your returned list.
max_results : list_limit option;
The number of JobListEntry
objects to return.
}
type nonrec compatible_image = {
name : string_ option;
The optional name of a compatible image.
*)ami_id : string_ option;
The unique identifier for an individual Snow device AMI.
*)}
A JSON-formatted object that describes a compatible Amazon Machine Image (AMI), including the ID and name for a Snow device AMI. This AMI is compatible with the device's physical hardware requirements, and it should be able to be run in an SBE1 instance on the device.
type nonrec compatible_image_list = compatible_image list
type nonrec list_compatible_images_result = {
next_token : string_ option;
Because HTTP requests are stateless, this is the starting point for your next list of returned images.
*)compatible_images : compatible_image_list option;
A JSON-formatted object that describes a compatible AMI, including the ID and name for a Snow device AMI.
*)}
type nonrec list_compatible_images_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of compatible images, you can specify a value for NextToken
as the starting point for your list of returned images.
max_results : list_limit option;
The maximum number of results for the list of compatible images. Currently, a Snowball Edge device can store 10 AMIs.
*)}
type nonrec cluster_list_entry = {
description : string_ option;
Defines an optional description of the cluster, for example Environmental Data Cluster-01
.
creation_date : timestamp option;
The creation date for this cluster.
*)cluster_state : cluster_state option;
The current state of this cluster. For information about the state of a specific node, see JobListEntry$JobState
.
cluster_id : string_ option;
The 39-character ID for the cluster that you want to list, for example CID123e4567-e89b-12d3-a456-426655440000
.
}
Contains a cluster's state, a cluster's ID, and other important information.
type nonrec cluster_list_entry_list = cluster_list_entry list
type nonrec list_clusters_result = {
next_token : string_ option;
HTTP requests are stateless. If you use the automatically generated NextToken
value in your next ClusterListEntry
call, your list of returned clusters will start from this point in the array.
cluster_list_entries : cluster_list_entry_list option;
Each ClusterListEntry
object contains a cluster's state, a cluster's ID, and other important status information.
}
type nonrec list_clusters_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of ClusterListEntry
objects, you have the option of specifying NextToken
as the starting point for your returned list.
max_results : list_limit option;
The number of ClusterListEntry
objects to return.
}
type nonrec list_cluster_jobs_result = {
next_token : string_ option;
HTTP requests are stateless. If you use the automatically generated NextToken
value in your next ListClusterJobsResult
call, your list of returned jobs will start from this point in the array.
job_list_entries : job_list_entry_list option;
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 export jobs.
}
type nonrec list_cluster_jobs_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of JobListEntry
objects, you have the option of specifying NextToken
as the starting point for your returned list.
max_results : list_limit option;
The number of JobListEntry
objects to return.
cluster_id : cluster_id;
The 39-character ID for the cluster that you want to list, for example CID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec data_transfer = {
total_objects : long option;
The total number of objects for a transfer between a Snow device and Amazon S3. This value is set to 0 (zero) until all the keys that will be transferred have been listed.
*)total_bytes : long option;
The total bytes of data for a transfer between a Snow device and Amazon S3. This value is set to 0 (zero) until all the keys that will be transferred have been listed.
*)objects_transferred : long option;
The number of objects transferred between a Snow device and Amazon S3.
*)bytes_transferred : long option;
The number of bytes transferred between a Snow device and Amazon S3.
*)}
Defines the real-time status of a Snow device's data transfer while the device is at Amazon Web Services. This data is only available while a job has a JobState
value of InProgress
, for both import and export jobs.
type nonrec job_logs = {
job_failure_log_ur_i : string_ option;
A link to an Amazon S3 presigned URL where the job failure log is located.
*)job_success_log_ur_i : string_ option;
A link to an Amazon S3 presigned URL where the job success log is located.
*)job_completion_report_ur_i : string_ option;
A link to an Amazon S3 presigned URL where the job completion report is located.
*)}
Contains job logs. Whenever a Snow device 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 Snow device 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.
type nonrec device_configuration = {
snowcone_device_configuration : snowcone_device_configuration option;
Returns information about the device configuration for an Snowcone job.
*)}
The container for SnowconeDeviceConfiguration
.
type nonrec job_metadata = {
snowball_id : string_ option;
Unique ID associated with a device.
*)pickup_details : pickup_details option;
Information identifying the person picking up the device.
*)impact_level : impact_level option;
The highest impact level of data that will be stored or processed on the device, provided at job creation.
*)on_device_service_configuration : on_device_service_configuration option;
Represents metadata and configuration settings for services on an Amazon Web Services Snow Family device.
*)long_term_pricing_id : long_term_pricing_id option;
The ID of the long-term pricing type for the device.
*)remote_management : remote_management option;
Allows you to securely operate and manage Snowcone devices remotely from outside of your internal network. When set to INSTALLED_AUTOSTART
, remote management will automatically be available when the device arrives at your location. Otherwise, you need to use the Snowball Client to manage the device.
device_configuration : device_configuration option;
tax_documents : tax_documents option;
The metadata associated with the tax documents required in your Amazon Web Services Region.
*)forwarding_address_id : address_id option;
The ID of the address that you want a job shipped to, after it will be shipped to its primary address. This field is not supported in most regions.
*)cluster_id : string_ option;
The 39-character ID for the cluster, for example CID123e4567-e89b-12d3-a456-426655440000
.
job_log_info : job_logs option;
Links to Amazon S3 presigned URLs for the job report and logs. 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 Snow device for your job part is being delivered to you.
*)data_transfer_progress : data_transfer option;
A value that defines the real-time status of a Snow device's data transfer while the device is at Amazon Web Services. This data is only available while a job has a JobState
value of InProgress
, for both import and export jobs.
notification : notification option;
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.
snowball_capacity_preference : snowball_capacity option;
The Snow device capacity preference for this job, specified at job creation. In US regions, you can choose between 50 TB and 80 TB Snowballs. All other regions use 80 TB capacity Snowballs.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)shipping_details : shipping_details option;
A job's shipping information, including inbound and outbound tracking numbers and shipping speed options.
*)address_id : address_id option;
The ID for the address that you want the Snow device shipped to.
*)role_ar_n : role_ar_n option;
The role ARN associated with this job. This ARN was created using the CreateRole API action in Identity and Access Management.
*)kms_key_ar_n : kms_key_ar_n option;
The Amazon Resource Name (ARN) for the Key Management Service (KMS) key associated with this job. This ARN was created using the CreateKey API action in KMS.
*)description : string_ option;
The description of the job, provided at job creation.
*)resources : job_resource option;
An array of S3Resource
objects. Each S3Resource
object represents an Amazon S3 bucket that your transferred data will be exported from or imported into.
creation_date : timestamp option;
The creation date for this job.
*)snowball_type : snowball_type option;
The type of device used with this job.
*)job_type : job_type option;
The type of job.
*)job_state : job_state option;
The current status of the jobs.
*)job_id : string_ option;
The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
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.
type nonrec job_metadata_list = job_metadata list
The address provided was invalid. Check the address with your region's carrier, and try again.
type nonrec get_software_updates_result = {
updates_ur_i : string_ option;
The Amazon S3 presigned URL for the update file associated with the specified JobId
value. The software update will be available for 2 days after this request is made. To access an update after the 2 days have passed, you'll have to make another call to GetSoftwareUpdates
.
}
type nonrec get_software_updates_request = {
job_id : job_id;
The ID for a job that you want to get the software update file for, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec get_job_unlock_code_result = {
unlock_code : string_ option;
The UnlockCode
value for the specified job. The UnlockCode
value can be accessed for up to 360 days after the job has been created.
}
type nonrec get_job_unlock_code_request = {
job_id : job_id;
The ID for the job that you want to get the UnlockCode
value for, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec get_job_manifest_result = {
manifest_ur_i : string_ option;
The Amazon S3 presigned URL for the manifest file associated with the specified JobId
value.
}
type nonrec get_job_manifest_request = {
job_id : job_id;
The ID for a job that you want to get the manifest file for, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec describe_return_shipping_label_result = {
return_shipping_label_ur_i : string_ option;
The pre-signed Amazon S3 URI used to download the return shipping label.
*)expiration_date : timestamp option;
The expiration date of the current return shipping label.
*)status : shipping_label_status option;
The status information of the task on a Snow device that is being returned to Amazon Web Services.
*)}
type nonrec describe_return_shipping_label_request = {
job_id : job_id;
The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec conflict_exception = {
message : string_ option;
conflict_resource : string_ option;
You get this resource when you call CreateReturnShippingLabel
more than once when other requests are not completed. .
}
You get this exception when you call CreateReturnShippingLabel
more than once when other requests are not completed.
type nonrec describe_job_result = {
sub_job_metadata : job_metadata_list option;
Information about a specific job part (in the case of an export job), including shipping information, job status, and other important metadata.
*)job_metadata : job_metadata option;
Information about a specific job, including shipping information, job status, and other important metadata.
*)}
type nonrec describe_job_request = {
job_id : job_id;
The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec cluster_metadata = {
on_device_service_configuration : on_device_service_configuration option;
Represents metadata and configuration settings for services on an Amazon Web Services Snow Family device.
*)tax_documents : tax_documents option;
The tax documents required in your Amazon Web Services Region.
*)forwarding_address_id : address_id option;
The ID of the address that you want a cluster shipped to, after it will be shipped to its primary address. This field is not supported in most regions.
*)notification : notification option;
The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.
*)shipping_option : shipping_option option;
The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows:
address_id : address_id option;
The automatically generated ID for a specific address.
*)resources : job_resource option;
The arrays of JobResource
objects that can include updated S3Resource
objects or LambdaResource
objects.
creation_date : timestamp option;
The creation date for this cluster.
*)snowball_type : snowball_type option;
The type of Snowcone device to use for this cluster.
For cluster jobs, Amazon Web Services Snow Family currently supports only the EDGE
device type.
job_type : job_type option;
The type of job for this cluster. Currently, the only job type supported for clusters is LOCAL_USE
.
cluster_state : cluster_state option;
The current status of the cluster.
*)role_ar_n : role_ar_n option;
The role ARN associated with this cluster. This ARN was created using the CreateRole API action in Identity and Access Management (IAM).
*)kms_key_ar_n : kms_key_ar_n option;
The KmsKeyARN
Amazon Resource Name (ARN) associated with this cluster. This ARN was created using the CreateKey API action in Key Management Service (KMS.
description : string_ option;
The optional description of the cluster.
*)cluster_id : string_ option;
The automatically generated ID for a cluster.
*)}
Contains metadata about a specific cluster.
type nonrec describe_cluster_result = {
cluster_metadata : cluster_metadata option;
Information about a specific cluster, including shipping information, cluster status, and other important metadata.
*)}
type nonrec describe_cluster_request = {
cluster_id : cluster_id;
The automatically generated ID for a cluster.
*)}
type nonrec describe_addresses_result = {
next_token : string_ option;
HTTP requests are stateless. If you use the automatically generated NextToken
value in your next DescribeAddresses
call, your list of returned addresses will start from this point in the array.
addresses : address_list option;
The Snow device shipping addresses that were created for this account.
*)}
type nonrec describe_addresses_request = {
next_token : string_ option;
HTTP requests are stateless. To identify what object comes "next" in the list of ADDRESS
objects, you have the option of specifying a value for NextToken
as the starting point for your list of returned addresses.
max_results : list_limit option;
The number of ADDRESS
objects to return.
}
type nonrec describe_address_result = {
address : address option;
The address that you want the Snow device(s) associated with a specific job to be shipped to.
*)}
type nonrec describe_address_request = {
address_id : address_id;
The automatically generated ID for a specific address.
*)}
type nonrec create_return_shipping_label_result = {
status : shipping_label_status option;
The status information of the task on a Snow device that is being returned to Amazon Web Services.
*)}
type nonrec create_return_shipping_label_request = {
shipping_option : shipping_option option;
The shipping speed for a particular job. This speed doesn't dictate how soon the device is returned to Amazon Web Services. This speed represents how quickly it moves to its destination while in transit. Regional shipping speeds are as follows:
*)job_id : job_id;
The ID for a job that you want to create the return shipping label for; for example, JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec create_long_term_pricing_result = {
long_term_pricing_id : long_term_pricing_id option;
The ID of the long-term pricing type for the device.
*)}
type nonrec create_long_term_pricing_request = {
snowball_type : snowball_type;
The type of Snow Family devices to use for the long-term pricing job.
*)is_long_term_pricing_auto_renew : java_boolean option;
Specifies whether the current long-term pricing type for the device should be renewed.
*)long_term_pricing_type : long_term_pricing_type;
The type of long-term pricing option you want for the device, either 1-year or 3-year long-term pricing.
*)}
type nonrec create_job_result = {
job_id : job_id option;
The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec create_job_request = {
pickup_details : pickup_details option;
Information identifying the person picking up the device.
*)impact_level : impact_level option;
The highest impact level of data that will be stored or processed on the device, provided at job creation.
*)long_term_pricing_id : long_term_pricing_id option;
The ID of the long-term pricing type for the device.
*)remote_management : remote_management option;
Allows you to securely operate and manage Snowcone devices remotely from outside of your internal network. When set to INSTALLED_AUTOSTART
, remote management will automatically be available when the device arrives at your location. Otherwise, you need to use the Snowball Edge client to manage the device. When set to NOT_INSTALLED
, remote management will not be available on the device.
device_configuration : device_configuration option;
Defines the device configuration for an Snowcone job.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)tax_documents : tax_documents option;
The tax documents required in your Amazon Web Services Region.
*)forwarding_address_id : address_id option;
The forwarding address ID for a job. This field is not supported in most Regions.
*)snowball_type : snowball_type option;
The type of Snow Family devices to use for this job.
For cluster jobs, Amazon Web Services Snow Family currently supports only the EDGE
device type.
The type of Amazon Web Services Snow device to use for this job. Currently, the only supported device type for cluster jobs is EDGE
.
For more information, see Snowball Edge Device Options in the Snowball Edge Developer Guide.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)cluster_id : cluster_id option;
The ID of a cluster. If you're creating a job for a node in a cluster, you need to provide only this clusterId
value. The other job attributes are inherited from the cluster.
notification : notification option;
Defines the Amazon Simple Notification Service (Amazon SNS) notification settings for this job.
*)shipping_option : shipping_option option;
The shipping speed for this job. This speed doesn't dictate how soon you'll get the Snow device, rather it represents how quickly the Snow device moves to its destination while in transit. Regional shipping speeds are as follows:
snowball_capacity_preference : snowball_capacity option;
If your job is being created in one of the US regions, you have the option of specifying what size Snow device you'd like for this job. In all other regions, Snowballs come with 80 TB in storage capacity.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)role_ar_n : role_ar_n option;
The RoleARN
that you want to associate with this job. RoleArn
s are created using the CreateRole Identity and Access Management (IAM) API action.
kms_key_ar_n : kms_key_ar_n option;
The KmsKeyARN
that you want to associate with this job. KmsKeyARN
s are created using the CreateKey Key Management Service (KMS) API action.
address_id : address_id option;
The ID for the address that you want the Snow device shipped to.
*)description : string_ option;
Defines an optional description of this specific job, for example Important Photos 2016-08-11
.
on_device_service_configuration : on_device_service_configuration option;
Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family supports Amazon S3 and NFS (Network File System) and the Amazon Web Services Storage Gateway service Tape Gateway type.
*)resources : job_resource option;
Defines the Amazon S3 buckets associated with this job.
With IMPORT
jobs, you specify the bucket or buckets that your transferred data will be imported into.
With EXPORT
jobs, you specify the bucket or buckets that your transferred data will be exported from. Optionally, you can also specify a KeyRange
value. If you choose to export a range, you define the length of the range by providing either an inclusive BeginMarker
value, an inclusive EndMarker
value, or both. Ranges are UTF-8 binary sorted.
job_type : job_type option;
Defines the type of job that you're creating.
*)}
type nonrec create_cluster_result = {
job_list_entries : job_list_entry_list option;
List of jobs created for this cluster. For syntax, see ListJobsResult$JobListEntries in this guide.
*)cluster_id : cluster_id option;
The automatically generated ID for a cluster.
*)}
type nonrec create_cluster_request = {
snowball_capacity_preference : snowball_capacity option;
If your job is being created in one of the US regions, you have the option of specifying what size Snow device you'd like for this job. In all other regions, Snowballs come with 80 TB in storage capacity.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)long_term_pricing_ids : long_term_pricing_id_list option;
Lists long-term pricing id that will be used to associate with jobs automatically created for the new cluster.
*)force_create_jobs : boolean_ option;
Force to create cluster when user attempts to overprovision or underprovision a cluster. A cluster is overprovisioned or underprovisioned if the initial size of the cluster is more (overprovisioned) or less (underprovisioned) than what needed to meet capacity requirement specified with OnDeviceServiceConfiguration
.
initial_cluster_size : initial_cluster_size option;
If provided, each job will be automatically created and associated with the new cluster. If not provided, will be treated as 0.
*)remote_management : remote_management option;
Allows you to securely operate and manage Snow devices in a cluster remotely from outside of your internal network. When set to INSTALLED_AUTOSTART
, remote management will automatically be available when the device arrives at your location. Otherwise, you need to use the Snowball Client to manage the device.
tax_documents : tax_documents option;
The tax documents required in your Amazon Web Services Region.
*)forwarding_address_id : address_id option;
The forwarding address ID for a cluster. This field is not supported in most regions.
*)notification : notification option;
The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.
*)shipping_option : shipping_option;
The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each Snowball Edge device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows:
snowball_type : snowball_type;
The type of Snow Family devices to use for this cluster.
For cluster jobs, Amazon Web Services Snow Family currently supports only the EDGE
device type.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)role_ar_n : role_ar_n option;
The RoleARN
that you want to associate with this cluster. RoleArn
values are created by using the CreateRole API action in Identity and Access Management (IAM).
kms_key_ar_n : kms_key_ar_n option;
The KmsKeyARN
value that you want to associate with this cluster. KmsKeyARN
values are created by using the CreateKey API action in Key Management Service (KMS).
address_id : address_id;
The ID for the address that you want the cluster shipped to.
*)description : string_ option;
An optional description of this specific cluster, for example Environmental Data Cluster-01
.
on_device_service_configuration : on_device_service_configuration option;
Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family device clusters support Amazon S3 and NFS (Network File System).
*)resources : job_resource option;
The resources associated with the cluster job. These resources include Amazon S3 buckets and optional Lambda functions written in the Python language.
*)job_type : job_type;
The type of job for this cluster. Currently, the only job type supported for clusters is LOCAL_USE
.
For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the Snowcone User Guide.
*)}
type nonrec create_address_result = {
address_id : string_ option;
The automatically generated ID for a specific address. You'll use this ID when you create a job to specify which address you want the Snow device for that job shipped to.
*)}
type nonrec create_address_request = {
address : address;
The address that you want the Snow device shipped to.
*)}
type nonrec cancel_job_request = {
job_id : job_id;
The 39-character job ID for the job that you want to cancel, for example JID123e4567-e89b-12d3-a456-426655440000
.
}
type nonrec cancel_cluster_request = {
cluster_id : cluster_id;
The 39-character ID for the cluster that you want to cancel, for example CID123e4567-e89b-12d3-a456-426655440000
.
}