aws-sdk-snowball 1.0.0.rc1 → 1.0.0.rc2

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 4fa9b066cadf7b945d758c2f33edc9a26eb681a1
4
- data.tar.gz: 75026e44ccf64242b54b2279b4184dd2415b1256
3
+ metadata.gz: 1ef1d6308e89b2ff278920529638e830291302c3
4
+ data.tar.gz: d038a98c1c9498d11cbeec7c27bcd01107a15198
5
5
  SHA512:
6
- metadata.gz: cf41c1bd844032b68c9bf06515212dacc64bf7caef47b671a65fba80a65b044f23cd7ef9803dcfd42fcd22100912be725961b3ed1a2580b8982bee929b28ea1a
7
- data.tar.gz: 7985223d5035c3ab6f0bb09c42d83fab058026961eb3cbefacb7bd7f4198cfe33b1a131b619b17294e6b73b22a4cccecd32c5d5c6835f2adc304f4ae59e1126a
6
+ metadata.gz: cd47b466224e24f92845f6628ef12d33851253d2246d4df9cecdbf25db763a9215317d079f40a6187de01fa9109afcdbaa4580feed52ceae82d08e36c5a9bfbf
7
+ data.tar.gz: 8db5be0c3cc9d9a8d0f527b320db591de8282383f912dbe0d7576559c361ec37ce4d42353a1615fe09a2bc968334471480db8683ea8ed9a95d7c30398ce67f32
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-snowball/customizations'
42
42
  # @service
43
43
  module Aws::Snowball
44
44
 
45
- GEM_VERSION = '1.0.0.rc1'
45
+ GEM_VERSION = '1.0.0.rc2'
46
46
 
47
47
  end
@@ -139,12 +139,31 @@ module Aws
139
139
 
140
140
  # @!group API Operations
141
141
 
142
- # Cancels the specified job. Note that you can only cancel a job before
143
- # its `JobState` value changes to `PreparingAppliance`. Requesting the
142
+ # Cancels a cluster job. You can only cancel a cluster job while it's
143
+ # in the `AwaitingQuorum` status. You'll have at least an hour after
144
+ # creating a cluster job to cancel it.
145
+ # @option params [required, String] :cluster_id
146
+ # The 39-character ID for the cluster that you want to cancel, for
147
+ # example `CID123e4567-e89b-12d3-a456-426655440000`.
148
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
149
+ #
150
+ # @example Request syntax with placeholder values
151
+ # resp = client.cancel_cluster({
152
+ # cluster_id: "ClusterId", # required
153
+ # })
154
+ # @overload cancel_cluster(params = {})
155
+ # @param [Hash] params ({})
156
+ def cancel_cluster(params = {}, options = {})
157
+ req = build_request(:cancel_cluster, params)
158
+ req.send_request(options)
159
+ end
160
+
161
+ # Cancels the specified job. You can only cancel a job before its
162
+ # `JobState` value changes to `PreparingAppliance`. Requesting the
144
163
  # `ListJobs` or `DescribeJob` action will return a job's `JobState` as
145
164
  # part of the response element data returned.
146
165
  # @option params [required, String] :job_id
147
- # The 39 character job ID for the job that you want to cancel, for
166
+ # The 39-character job ID for the job that you want to cancel, for
148
167
  # example `JID123e4567-e89b-12d3-a456-426655440000`.
149
168
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
150
169
  #
@@ -198,13 +217,120 @@ module Aws
198
217
  req.send_request(options)
199
218
  end
200
219
 
201
- # Creates a job to import or export data between Amazon S3 and your
202
- # on-premises data center. Note that your AWS account must have the
203
- # right trust policies and permissions in place to create a job for
204
- # Snowball. For more information, see api-reference-policies.
220
+ # Creates an empty cluster. Each cluster supports five nodes. You use
221
+ # the CreateJob action separately to create the jobs for each of these
222
+ # nodes. The cluster does not ship until these five node jobs have been
223
+ # created.
205
224
  # @option params [required, String] :job_type
206
- # Defines the type of job that you're creating.
225
+ # The type of job for this cluster. Currently, the only job type
226
+ # supported for clusters is `LOCAL_USE`.
207
227
  # @option params [required, Types::JobResource] :resources
228
+ # The resources associated with the cluster job. These resources include
229
+ # Amazon S3 buckets and optional AWS Lambda functions written in the
230
+ # Python language.
231
+ # @option params [String] :description
232
+ # An optional description of this specific cluster, for example
233
+ # `Environmental Data Cluster-01`.
234
+ # @option params [required, String] :address_id
235
+ # The ID for the address that you want the cluster shipped to.>
236
+ # @option params [String] :kms_key_arn
237
+ # The `KmsKeyARN` value that you want to associate with this cluster.
238
+ # `KmsKeyARN` values are created by using the [CreateKey][1] API action
239
+ # in AWS Key Management Service (AWS KMS).
240
+ #
241
+ #
242
+ #
243
+ # [1]: http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html
244
+ # @option params [required, String] :role_arn
245
+ # The `RoleARN` that you want to associate with this cluster. `RoleArn`
246
+ # values are created by using the [CreateRole][1] API action in AWS
247
+ # Identity and Access Management (IAM).
248
+ #
249
+ #
250
+ #
251
+ # [1]: http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html
252
+ # @option params [String] :snowball_type
253
+ # The type of AWS Snowball appliance to use for this cluster. Currently,
254
+ # the only supported appliance type for cluster jobs is `EDGE`.
255
+ # @option params [required, String] :shipping_option
256
+ # The shipping speed for each node in this cluster. This speed doesn't
257
+ # dictate how soon you'll get each Snowball Edge appliance, rather it
258
+ # represents how quickly each appliance moves to its destination while
259
+ # in transit. Regional shipping speeds are as follows:
260
+ #
261
+ # * In Australia, you have access to express shipping. Typically,
262
+ # appliances shipped express are delivered in about a day.
263
+ #
264
+ # * In the European Union (EU), you have access to express shipping.
265
+ # Typically, Snowball Edges shipped express are delivered in about a
266
+ # day. In addition, most countries in the EU have access to standard
267
+ # shipping, which typically takes less than a week, one way.
268
+ #
269
+ # * In India, Snowball Edges are delivered in one to seven days.
270
+ #
271
+ # * In the US, you have access to one-day shipping and two-day shipping.
272
+ # @option params [Types::Notification] :notification
273
+ # The Amazon Simple Notification Service (Amazon SNS) notification
274
+ # settings for this cluster.
275
+ # @return [Types::CreateClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
276
+ #
277
+ # * {Types::CreateClusterResult#cluster_id #ClusterId} => String
278
+ #
279
+ # @example Request syntax with placeholder values
280
+ # resp = client.create_cluster({
281
+ # job_type: "IMPORT", # required, accepts IMPORT, EXPORT, LOCAL_USE
282
+ # resources: { # required
283
+ # s3_resources: [
284
+ # {
285
+ # bucket_arn: "ResourceARN",
286
+ # key_range: {
287
+ # begin_marker: "String",
288
+ # end_marker: "String",
289
+ # },
290
+ # },
291
+ # ],
292
+ # lambda_resources: [
293
+ # {
294
+ # lambda_arn: "ResourceARN",
295
+ # event_triggers: [
296
+ # {
297
+ # event_resource_arn: "ResourceARN",
298
+ # },
299
+ # ],
300
+ # },
301
+ # ],
302
+ # },
303
+ # description: "String",
304
+ # address_id: "AddressId", # required
305
+ # kms_key_arn: "KmsKeyARN",
306
+ # role_arn: "RoleARN", # required
307
+ # snowball_type: "STANDARD", # accepts STANDARD, EDGE
308
+ # shipping_option: "SECOND_DAY", # required, accepts SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD
309
+ # notification: {
310
+ # sns_topic_arn: "SnsTopicARN",
311
+ # job_states_to_notify: ["New"], # accepts New, PreparingAppliance, PreparingShipment, InTransitToCustomer, WithCustomer, InTransitToAWS, WithAWS, InProgress, Complete, Cancelled, Listing, Pending
312
+ # notify_all: false,
313
+ # },
314
+ # })
315
+ #
316
+ # @example Response structure
317
+ # resp.cluster_id #=> String
318
+ # @overload create_cluster(params = {})
319
+ # @param [Hash] params ({})
320
+ def create_cluster(params = {}, options = {})
321
+ req = build_request(:create_cluster, params)
322
+ req.send_request(options)
323
+ end
324
+
325
+ # Creates a job to import or export data between Amazon S3 and your
326
+ # on-premises data center. Your AWS account must have the right trust
327
+ # policies and permissions in place to create a job for Snowball. If
328
+ # you're creating a job for a node in a cluster, you only need to
329
+ # provide the `clusterId` value; the other job attributes are inherited
330
+ # from the cluster. .
331
+ # @option params [String] :job_type
332
+ # Defines the type of job that you're creating.
333
+ # @option params [Types::JobResource] :resources
208
334
  # Defines the Amazon S3 buckets associated with this job.
209
335
  #
210
336
  # With `IMPORT` jobs, you specify the bucket or buckets that your
@@ -219,7 +345,7 @@ module Aws
219
345
  # @option params [String] :description
220
346
  # Defines an optional description of this specific job, for example
221
347
  # `Important Photos 2016-08-11`.
222
- # @option params [required, String] :address_id
348
+ # @option params [String] :address_id
223
349
  # The ID for the address that you want the Snowball shipped to.
224
350
  # @option params [String] :kms_key_arn
225
351
  # The `KmsKeyARN` that you want to associate with this job. `KmsKeyARN`s
@@ -229,7 +355,7 @@ module Aws
229
355
  #
230
356
  #
231
357
  # [1]: http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html
232
- # @option params [required, String] :role_arn
358
+ # @option params [String] :role_arn
233
359
  # The `RoleARN` that you want to associate with this job. `RoleArn`s are
234
360
  # created using the [CreateRole][1] AWS Identity and Access Management
235
361
  # (IAM) API action.
@@ -241,11 +367,11 @@ module Aws
241
367
  # If your job is being created in one of the US regions, you have the
242
368
  # option of specifying what size Snowball you'd like for this job. In
243
369
  # all other regions, Snowballs come with 80 TB in storage capacity.
244
- # @option params [required, String] :shipping_option
245
- # The shipping speed for this job. Note that this speed does not dictate
246
- # how soon you'll get the Snowball, rather it represents how quickly
247
- # the Snowball moves to its destination while in transit. Regional
248
- # shipping speeds are as follows:
370
+ # @option params [String] :shipping_option
371
+ # The shipping speed for this job. This speed doesn't dictate how soon
372
+ # you'll get the Snowball, rather it represents how quickly the
373
+ # Snowball moves to its destination while in transit. Regional shipping
374
+ # speeds are as follows:
249
375
  #
250
376
  # * In Australia, you have access to express shipping. Typically,
251
377
  # Snowballs shipped express are delivered in about a day.
@@ -261,14 +387,21 @@ module Aws
261
387
  # @option params [Types::Notification] :notification
262
388
  # Defines the Amazon Simple Notification Service (Amazon SNS)
263
389
  # notification settings for this job.
390
+ # @option params [String] :cluster_id
391
+ # The ID of a cluster. If you're creating a job for a node in a
392
+ # cluster, you need to provide only this `clusterId` value. The other
393
+ # job attributes are inherited from the cluster.
394
+ # @option params [String] :snowball_type
395
+ # The type of AWS Snowball appliance to use for this job. Currently, the
396
+ # only supported appliance type for cluster jobs is `EDGE`.
264
397
  # @return [Types::CreateJobResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
265
398
  #
266
399
  # * {Types::CreateJobResult#job_id #JobId} => String
267
400
  #
268
401
  # @example Request syntax with placeholder values
269
402
  # resp = client.create_job({
270
- # job_type: "IMPORT", # required, accepts IMPORT, EXPORT
271
- # resources: { # required
403
+ # job_type: "IMPORT", # accepts IMPORT, EXPORT, LOCAL_USE
404
+ # resources: {
272
405
  # s3_resources: [
273
406
  # {
274
407
  # bucket_arn: "ResourceARN",
@@ -278,18 +411,30 @@ module Aws
278
411
  # },
279
412
  # },
280
413
  # ],
414
+ # lambda_resources: [
415
+ # {
416
+ # lambda_arn: "ResourceARN",
417
+ # event_triggers: [
418
+ # {
419
+ # event_resource_arn: "ResourceARN",
420
+ # },
421
+ # ],
422
+ # },
423
+ # ],
281
424
  # },
282
425
  # description: "String",
283
- # address_id: "AddressId", # required
426
+ # address_id: "AddressId",
284
427
  # kms_key_arn: "KmsKeyARN",
285
- # role_arn: "RoleARN", # required
286
- # snowball_capacity_preference: "T50", # accepts T50, T80, NoPreference
287
- # shipping_option: "SECOND_DAY", # required, accepts SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD
428
+ # role_arn: "RoleARN",
429
+ # snowball_capacity_preference: "T50", # accepts T50, T80, T100, NoPreference
430
+ # shipping_option: "SECOND_DAY", # accepts SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD
288
431
  # notification: {
289
432
  # sns_topic_arn: "SnsTopicARN",
290
433
  # job_states_to_notify: ["New"], # accepts New, PreparingAppliance, PreparingShipment, InTransitToCustomer, WithCustomer, InTransitToAWS, WithAWS, InProgress, Complete, Cancelled, Listing, Pending
291
434
  # notify_all: false,
292
435
  # },
436
+ # cluster_id: "ClusterId",
437
+ # snowball_type: "STANDARD", # accepts STANDARD, EDGE
293
438
  # })
294
439
  #
295
440
  # @example Response structure
@@ -379,8 +524,51 @@ module Aws
379
524
  req.send_request(options)
380
525
  end
381
526
 
527
+ # Returns information about a specific cluster including shipping
528
+ # information, cluster status, and other important metadata.
529
+ # @option params [required, String] :cluster_id
530
+ # The automatically generated ID for a cluster.
531
+ # @return [Types::DescribeClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
532
+ #
533
+ # * {Types::DescribeClusterResult#cluster_metadata #ClusterMetadata} => Types::ClusterMetadata
534
+ #
535
+ # @example Request syntax with placeholder values
536
+ # resp = client.describe_cluster({
537
+ # cluster_id: "ClusterId", # required
538
+ # })
539
+ #
540
+ # @example Response structure
541
+ # resp.cluster_metadata.cluster_id #=> String
542
+ # resp.cluster_metadata.description #=> String
543
+ # resp.cluster_metadata.kms_key_arn #=> String
544
+ # resp.cluster_metadata.role_arn #=> String
545
+ # resp.cluster_metadata.cluster_state #=> String, one of "AwaitingQuorum", "Pending", "InUse", "Complete", "Cancelled"
546
+ # resp.cluster_metadata.job_type #=> String, one of "IMPORT", "EXPORT", "LOCAL_USE"
547
+ # resp.cluster_metadata.snowball_type #=> String, one of "STANDARD", "EDGE"
548
+ # resp.cluster_metadata.creation_date #=> Time
549
+ # resp.cluster_metadata.resources.s3_resources #=> Array
550
+ # resp.cluster_metadata.resources.s3_resources[0].bucket_arn #=> String
551
+ # resp.cluster_metadata.resources.s3_resources[0].key_range.begin_marker #=> String
552
+ # resp.cluster_metadata.resources.s3_resources[0].key_range.end_marker #=> String
553
+ # resp.cluster_metadata.resources.lambda_resources #=> Array
554
+ # resp.cluster_metadata.resources.lambda_resources[0].lambda_arn #=> String
555
+ # resp.cluster_metadata.resources.lambda_resources[0].event_triggers #=> Array
556
+ # resp.cluster_metadata.resources.lambda_resources[0].event_triggers[0].event_resource_arn #=> String
557
+ # resp.cluster_metadata.address_id #=> String
558
+ # resp.cluster_metadata.shipping_option #=> String, one of "SECOND_DAY", "NEXT_DAY", "EXPRESS", "STANDARD"
559
+ # resp.cluster_metadata.notification.sns_topic_arn #=> String
560
+ # resp.cluster_metadata.notification.job_states_to_notify #=> Array
561
+ # resp.cluster_metadata.notification.job_states_to_notify[0] #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
562
+ # resp.cluster_metadata.notification.notify_all #=> Boolean
563
+ # @overload describe_cluster(params = {})
564
+ # @param [Hash] params ({})
565
+ def describe_cluster(params = {}, options = {})
566
+ req = build_request(:describe_cluster, params)
567
+ req.send_request(options)
568
+ end
569
+
382
570
  # Returns information about a specific job including shipping
383
- # information, job status, and other important metadata.
571
+ # information, job status, and other important metadata. .
384
572
  # @option params [required, String] :job_id
385
573
  # The automatically generated ID for a job, for example
386
574
  # `JID123e4567-e89b-12d3-a456-426655440000`.
@@ -397,12 +585,17 @@ module Aws
397
585
  # @example Response structure
398
586
  # resp.job_metadata.job_id #=> String
399
587
  # resp.job_metadata.job_state #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
400
- # resp.job_metadata.job_type #=> String, one of "IMPORT", "EXPORT"
588
+ # resp.job_metadata.job_type #=> String, one of "IMPORT", "EXPORT", "LOCAL_USE"
589
+ # resp.job_metadata.snowball_type #=> String, one of "STANDARD", "EDGE"
401
590
  # resp.job_metadata.creation_date #=> Time
402
591
  # resp.job_metadata.resources.s3_resources #=> Array
403
592
  # resp.job_metadata.resources.s3_resources[0].bucket_arn #=> String
404
593
  # resp.job_metadata.resources.s3_resources[0].key_range.begin_marker #=> String
405
594
  # resp.job_metadata.resources.s3_resources[0].key_range.end_marker #=> String
595
+ # resp.job_metadata.resources.lambda_resources #=> Array
596
+ # resp.job_metadata.resources.lambda_resources[0].lambda_arn #=> String
597
+ # resp.job_metadata.resources.lambda_resources[0].event_triggers #=> Array
598
+ # resp.job_metadata.resources.lambda_resources[0].event_triggers[0].event_resource_arn #=> String
406
599
  # resp.job_metadata.description #=> String
407
600
  # resp.job_metadata.kms_key_arn #=> String
408
601
  # resp.job_metadata.role_arn #=> String
@@ -412,7 +605,7 @@ module Aws
412
605
  # resp.job_metadata.shipping_details.inbound_shipment.tracking_number #=> String
413
606
  # resp.job_metadata.shipping_details.outbound_shipment.status #=> String
414
607
  # resp.job_metadata.shipping_details.outbound_shipment.tracking_number #=> String
415
- # resp.job_metadata.snowball_capacity_preference #=> String, one of "T50", "T80", "NoPreference"
608
+ # resp.job_metadata.snowball_capacity_preference #=> String, one of "T50", "T80", "T100", "NoPreference"
416
609
  # resp.job_metadata.notification.sns_topic_arn #=> String
417
610
  # resp.job_metadata.notification.job_states_to_notify #=> Array
418
611
  # resp.job_metadata.notification.job_states_to_notify[0] #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
@@ -424,15 +617,21 @@ module Aws
424
617
  # resp.job_metadata.job_log_info.job_completion_report_uri #=> String
425
618
  # resp.job_metadata.job_log_info.job_success_log_uri #=> String
426
619
  # resp.job_metadata.job_log_info.job_failure_log_uri #=> String
620
+ # resp.job_metadata.cluster_id #=> String
427
621
  # resp.sub_job_metadata #=> Array
428
622
  # resp.sub_job_metadata[0].job_id #=> String
429
623
  # resp.sub_job_metadata[0].job_state #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
430
- # resp.sub_job_metadata[0].job_type #=> String, one of "IMPORT", "EXPORT"
624
+ # resp.sub_job_metadata[0].job_type #=> String, one of "IMPORT", "EXPORT", "LOCAL_USE"
625
+ # resp.sub_job_metadata[0].snowball_type #=> String, one of "STANDARD", "EDGE"
431
626
  # resp.sub_job_metadata[0].creation_date #=> Time
432
627
  # resp.sub_job_metadata[0].resources.s3_resources #=> Array
433
628
  # resp.sub_job_metadata[0].resources.s3_resources[0].bucket_arn #=> String
434
629
  # resp.sub_job_metadata[0].resources.s3_resources[0].key_range.begin_marker #=> String
435
630
  # resp.sub_job_metadata[0].resources.s3_resources[0].key_range.end_marker #=> String
631
+ # resp.sub_job_metadata[0].resources.lambda_resources #=> Array
632
+ # resp.sub_job_metadata[0].resources.lambda_resources[0].lambda_arn #=> String
633
+ # resp.sub_job_metadata[0].resources.lambda_resources[0].event_triggers #=> Array
634
+ # resp.sub_job_metadata[0].resources.lambda_resources[0].event_triggers[0].event_resource_arn #=> String
436
635
  # resp.sub_job_metadata[0].description #=> String
437
636
  # resp.sub_job_metadata[0].kms_key_arn #=> String
438
637
  # resp.sub_job_metadata[0].role_arn #=> String
@@ -442,7 +641,7 @@ module Aws
442
641
  # resp.sub_job_metadata[0].shipping_details.inbound_shipment.tracking_number #=> String
443
642
  # resp.sub_job_metadata[0].shipping_details.outbound_shipment.status #=> String
444
643
  # resp.sub_job_metadata[0].shipping_details.outbound_shipment.tracking_number #=> String
445
- # resp.sub_job_metadata[0].snowball_capacity_preference #=> String, one of "T50", "T80", "NoPreference"
644
+ # resp.sub_job_metadata[0].snowball_capacity_preference #=> String, one of "T50", "T80", "T100", "NoPreference"
446
645
  # resp.sub_job_metadata[0].notification.sns_topic_arn #=> String
447
646
  # resp.sub_job_metadata[0].notification.job_states_to_notify #=> Array
448
647
  # resp.sub_job_metadata[0].notification.job_states_to_notify[0] #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
@@ -454,6 +653,7 @@ module Aws
454
653
  # resp.sub_job_metadata[0].job_log_info.job_completion_report_uri #=> String
455
654
  # resp.sub_job_metadata[0].job_log_info.job_success_log_uri #=> String
456
655
  # resp.sub_job_metadata[0].job_log_info.job_failure_log_uri #=> String
656
+ # resp.sub_job_metadata[0].cluster_id #=> String
457
657
  # @overload describe_job(params = {})
458
658
  # @param [Hash] params ({})
459
659
  def describe_job(params = {}, options = {})
@@ -478,8 +678,8 @@ module Aws
478
678
  # job. Saving these separately helps prevent unauthorized parties from
479
679
  # gaining access to the Snowball associated with that job.
480
680
  #
481
- # Note that the credentials of a given job, including its manifest file
482
- # and unlock code, expire 90 days after the job is created.
681
+ # The credentials of a given job, including its manifest file and unlock
682
+ # code, expire 90 days after the job is created.
483
683
  # @option params [required, String] :job_id
484
684
  # The ID for a job that you want to get the manifest file for, for
485
685
  # example `JID123e4567-e89b-12d3-a456-426655440000`.
@@ -538,9 +738,9 @@ module Aws
538
738
  # Returns information about the Snowball service limit for your account,
539
739
  # and also the number of Snowballs your account has in use.
540
740
  #
541
- # Note that the default service limit for the number of Snowballs that
542
- # you can have at one time is 1. If you want to increase your service
543
- # limit, contact AWS Support.
741
+ # The default service limit for the number of Snowballs that you can
742
+ # have at one time is 1. If you want to increase your service limit,
743
+ # contact AWS Support.
544
744
  # @return [Types::GetSnowballUsageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
545
745
  #
546
746
  # * {Types::GetSnowballUsageResult#snowball_limit #SnowballLimit} => Integer
@@ -559,6 +759,81 @@ module Aws
559
759
  req.send_request(options)
560
760
  end
561
761
 
762
+ # Returns an array of `JobListEntry` objects of the specified length.
763
+ # Each `JobListEntry` object is for a job in the specified cluster and
764
+ # contains a job's state, a job's ID, and other information.
765
+ # @option params [required, String] :cluster_id
766
+ # The 39-character ID for the cluster that you want to list, for example
767
+ # `CID123e4567-e89b-12d3-a456-426655440000`.
768
+ # @option params [Integer] :max_results
769
+ # The number of `JobListEntry` objects to return.
770
+ # @option params [String] :next_token
771
+ # HTTP requests are stateless. To identify what object comes "next" in
772
+ # the list of `JobListEntry` objects, you have the option of specifying
773
+ # `NextToken` as the starting point for your returned list.
774
+ # @return [Types::ListClusterJobsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
775
+ #
776
+ # * {Types::ListClusterJobsResult#job_list_entries #JobListEntries} => Array<Types::JobListEntry>
777
+ # * {Types::ListClusterJobsResult#next_token #NextToken} => String
778
+ #
779
+ # @example Request syntax with placeholder values
780
+ # resp = client.list_cluster_jobs({
781
+ # cluster_id: "ClusterId", # required
782
+ # max_results: 1,
783
+ # next_token: "String",
784
+ # })
785
+ #
786
+ # @example Response structure
787
+ # resp.job_list_entries #=> Array
788
+ # resp.job_list_entries[0].job_id #=> String
789
+ # resp.job_list_entries[0].job_state #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
790
+ # resp.job_list_entries[0].is_master #=> Boolean
791
+ # resp.job_list_entries[0].job_type #=> String, one of "IMPORT", "EXPORT", "LOCAL_USE"
792
+ # resp.job_list_entries[0].snowball_type #=> String, one of "STANDARD", "EDGE"
793
+ # resp.job_list_entries[0].creation_date #=> Time
794
+ # resp.job_list_entries[0].description #=> String
795
+ # resp.next_token #=> String
796
+ # @overload list_cluster_jobs(params = {})
797
+ # @param [Hash] params ({})
798
+ def list_cluster_jobs(params = {}, options = {})
799
+ req = build_request(:list_cluster_jobs, params)
800
+ req.send_request(options)
801
+ end
802
+
803
+ # Returns an array of `ClusterListEntry` objects of the specified
804
+ # length. Each `ClusterListEntry` object contains a cluster's state, a
805
+ # cluster's ID, and other important status information.
806
+ # @option params [Integer] :max_results
807
+ # The number of `ClusterListEntry` objects to return.
808
+ # @option params [String] :next_token
809
+ # HTTP requests are stateless. To identify what object comes "next" in
810
+ # the list of `ClusterListEntry` objects, you have the option of
811
+ # specifying `NextToken` as the starting point for your returned list.
812
+ # @return [Types::ListClustersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
813
+ #
814
+ # * {Types::ListClustersResult#cluster_list_entries #ClusterListEntries} => Array<Types::ClusterListEntry>
815
+ # * {Types::ListClustersResult#next_token #NextToken} => String
816
+ #
817
+ # @example Request syntax with placeholder values
818
+ # resp = client.list_clusters({
819
+ # max_results: 1,
820
+ # next_token: "String",
821
+ # })
822
+ #
823
+ # @example Response structure
824
+ # resp.cluster_list_entries #=> Array
825
+ # resp.cluster_list_entries[0].cluster_id #=> String
826
+ # resp.cluster_list_entries[0].cluster_state #=> String, one of "AwaitingQuorum", "Pending", "InUse", "Complete", "Cancelled"
827
+ # resp.cluster_list_entries[0].creation_date #=> Time
828
+ # resp.cluster_list_entries[0].description #=> String
829
+ # resp.next_token #=> String
830
+ # @overload list_clusters(params = {})
831
+ # @param [Hash] params ({})
832
+ def list_clusters(params = {}, options = {})
833
+ req = build_request(:list_clusters, params)
834
+ req.send_request(options)
835
+ end
836
+
562
837
  # Returns an array of `JobListEntry` objects of the specified length.
563
838
  # Each `JobListEntry` object contains a job's state, a job's ID, and a
564
839
  # value that indicates whether the job is a job part, in the case of
@@ -587,6 +862,10 @@ module Aws
587
862
  # resp.job_list_entries[0].job_id #=> String
588
863
  # resp.job_list_entries[0].job_state #=> String, one of "New", "PreparingAppliance", "PreparingShipment", "InTransitToCustomer", "WithCustomer", "InTransitToAWS", "WithAWS", "InProgress", "Complete", "Cancelled", "Listing", "Pending"
589
864
  # resp.job_list_entries[0].is_master #=> Boolean
865
+ # resp.job_list_entries[0].job_type #=> String, one of "IMPORT", "EXPORT", "LOCAL_USE"
866
+ # resp.job_list_entries[0].snowball_type #=> String, one of "STANDARD", "EDGE"
867
+ # resp.job_list_entries[0].creation_date #=> Time
868
+ # resp.job_list_entries[0].description #=> String
590
869
  # resp.next_token #=> String
591
870
  # @overload list_jobs(params = {})
592
871
  # @param [Hash] params ({})
@@ -595,6 +874,77 @@ module Aws
595
874
  req.send_request(options)
596
875
  end
597
876
 
877
+ # While a cluster's `ClusterState` value is in the `AwaitingQuorum`
878
+ # state, you can update some of the information associated with a
879
+ # cluster. Once the cluster changes to a different job state, usually 60
880
+ # minutes after the cluster being created, this action is no longer
881
+ # available.
882
+ # @option params [required, String] :cluster_id
883
+ # The cluster ID of the cluster that you want to update, for example
884
+ # `CID123e4567-e89b-12d3-a456-426655440000`.
885
+ # @option params [String] :role_arn
886
+ # The new role Amazon Resource Name (ARN) that you want to associate
887
+ # with this cluster. To create a role ARN, use the [CreateRole][1] API
888
+ # action in AWS Identity and Access Management (IAM).
889
+ #
890
+ #
891
+ #
892
+ # [1]: http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html
893
+ # @option params [String] :description
894
+ # The updated description of this cluster.
895
+ # @option params [Types::JobResource] :resources
896
+ # The updated arrays of JobResource objects that can include updated
897
+ # S3Resource objects or LambdaResource objects.
898
+ # @option params [String] :address_id
899
+ # The ID of the updated Address object.
900
+ # @option params [String] :shipping_option
901
+ # The updated shipping option value of this cluster's ShippingDetails
902
+ # object.
903
+ # @option params [Types::Notification] :notification
904
+ # The new or updated Notification object.
905
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
906
+ #
907
+ # @example Request syntax with placeholder values
908
+ # resp = client.update_cluster({
909
+ # cluster_id: "ClusterId", # required
910
+ # role_arn: "RoleARN",
911
+ # description: "String",
912
+ # resources: {
913
+ # s3_resources: [
914
+ # {
915
+ # bucket_arn: "ResourceARN",
916
+ # key_range: {
917
+ # begin_marker: "String",
918
+ # end_marker: "String",
919
+ # },
920
+ # },
921
+ # ],
922
+ # lambda_resources: [
923
+ # {
924
+ # lambda_arn: "ResourceARN",
925
+ # event_triggers: [
926
+ # {
927
+ # event_resource_arn: "ResourceARN",
928
+ # },
929
+ # ],
930
+ # },
931
+ # ],
932
+ # },
933
+ # address_id: "AddressId",
934
+ # shipping_option: "SECOND_DAY", # accepts SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD
935
+ # notification: {
936
+ # sns_topic_arn: "SnsTopicARN",
937
+ # job_states_to_notify: ["New"], # accepts New, PreparingAppliance, PreparingShipment, InTransitToCustomer, WithCustomer, InTransitToAWS, WithAWS, InProgress, Complete, Cancelled, Listing, Pending
938
+ # notify_all: false,
939
+ # },
940
+ # })
941
+ # @overload update_cluster(params = {})
942
+ # @param [Hash] params ({})
943
+ def update_cluster(params = {}, options = {})
944
+ req = build_request(:update_cluster, params)
945
+ req.send_request(options)
946
+ end
947
+
598
948
  # While a job's `JobState` value is `New`, you can update some of the
599
949
  # information associated with a job. Once the job changes to a different
600
950
  # job state, usually within 60 minutes of the job being created, this
@@ -625,8 +975,7 @@ module Aws
625
975
  # The updated description of this job's JobMetadata object.
626
976
  # @option params [String] :snowball_capacity_preference
627
977
  # The updated `SnowballCapacityPreference` of this job's JobMetadata
628
- # object. Note that the 50 TB Snowballs are only available in the US
629
- # regions.
978
+ # object. The 50 TB Snowballs are only available in the US regions.
630
979
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
631
980
  #
632
981
  # @example Request syntax with placeholder values
@@ -648,11 +997,21 @@ module Aws
648
997
  # },
649
998
  # },
650
999
  # ],
1000
+ # lambda_resources: [
1001
+ # {
1002
+ # lambda_arn: "ResourceARN",
1003
+ # event_triggers: [
1004
+ # {
1005
+ # event_resource_arn: "ResourceARN",
1006
+ # },
1007
+ # ],
1008
+ # },
1009
+ # ],
651
1010
  # },
652
1011
  # address_id: "AddressId",
653
1012
  # shipping_option: "SECOND_DAY", # accepts SECOND_DAY, NEXT_DAY, EXPRESS, STANDARD
654
1013
  # description: "String",
655
- # snowball_capacity_preference: "T50", # accepts T50, T80, NoPreference
1014
+ # snowball_capacity_preference: "T50", # accepts T50, T80, T100, NoPreference
656
1015
  # })
657
1016
  # @overload update_job(params = {})
658
1017
  # @param [Hash] params ({})
@@ -674,7 +1033,7 @@ module Aws
674
1033
  params: params,
675
1034
  config: config)
676
1035
  context[:gem_name] = 'aws-sdk-snowball'
677
- context[:gem_version] = '1.0.0.rc1'
1036
+ context[:gem_version] = '1.0.0.rc2'
678
1037
  Seahorse::Client::Request.new(handlers, context)
679
1038
  end
680
1039