aws-sdk-datasync 1.3.0 → 1.4.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-datasync.rb +1 -1
- data/lib/aws-sdk-datasync/client.rb +184 -83
- data/lib/aws-sdk-datasync/client_api.rb +55 -4
- data/lib/aws-sdk-datasync/types.rb +230 -125
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 903dd03c5d930b344059469b7d6c575d9a1d6dae
|
4
|
+
data.tar.gz: 63f2c6e7747ed753aacd87169802ca753b44d37e
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8b74046124c6a220edef298609dfc0b8875672217015c2bc8eba66db8b99d4e3a7cae05c1e46878d156c4a77b850a8f53d31e3fbc583f739aa5b705c605fe3d6
|
7
|
+
data.tar.gz: 74dd72443d36304f146a572abc483bced5ce37eb404ce55df826316dbfdd66abc2ccb0dfc0c77736c3e86832a606819d5948b139ac236db379c6b7056de9aafd
|
data/lib/aws-sdk-datasync.rb
CHANGED
@@ -209,6 +209,49 @@ module Aws::DataSync
|
|
209
209
|
# When `true`, request parameters are validated before
|
210
210
|
# sending the request.
|
211
211
|
#
|
212
|
+
# @option options [URI::HTTP,String] :http_proxy A proxy to send
|
213
|
+
# requests through. Formatted like 'http://proxy.com:123'.
|
214
|
+
#
|
215
|
+
# @option options [Float] :http_open_timeout (15) The number of
|
216
|
+
# seconds to wait when opening a HTTP session before rasing a
|
217
|
+
# `Timeout::Error`.
|
218
|
+
#
|
219
|
+
# @option options [Integer] :http_read_timeout (60) The default
|
220
|
+
# number of seconds to wait for response data. This value can
|
221
|
+
# safely be set
|
222
|
+
# per-request on the session yeidled by {#session_for}.
|
223
|
+
#
|
224
|
+
# @option options [Float] :http_idle_timeout (5) The number of
|
225
|
+
# seconds a connection is allowed to sit idble before it is
|
226
|
+
# considered stale. Stale connections are closed and removed
|
227
|
+
# from the pool before making a request.
|
228
|
+
#
|
229
|
+
# @option options [Float] :http_continue_timeout (1) The number of
|
230
|
+
# seconds to wait for a 100-continue response before sending the
|
231
|
+
# request body. This option has no effect unless the request has
|
232
|
+
# "Expect" header set to "100-continue". Defaults to `nil` which
|
233
|
+
# disables this behaviour. This value can safely be set per
|
234
|
+
# request on the session yeidled by {#session_for}.
|
235
|
+
#
|
236
|
+
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
237
|
+
# HTTP debug output will be sent to the `:logger`.
|
238
|
+
#
|
239
|
+
# @option options [Boolean] :ssl_verify_peer (true) When `true`,
|
240
|
+
# SSL peer certificates are verified when establishing a
|
241
|
+
# connection.
|
242
|
+
#
|
243
|
+
# @option options [String] :ssl_ca_bundle Full path to the SSL
|
244
|
+
# certificate authority bundle file that should be used when
|
245
|
+
# verifying peer certificates. If you do not pass
|
246
|
+
# `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
|
247
|
+
# will be used if available.
|
248
|
+
#
|
249
|
+
# @option options [String] :ssl_ca_directory Full path of the
|
250
|
+
# directory that contains the unbundled SSL certificate
|
251
|
+
# authority files for verifying peer certificates. If you do
|
252
|
+
# not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
|
253
|
+
# system default will be used if available.
|
254
|
+
#
|
212
255
|
def initialize(*args)
|
213
256
|
super
|
214
257
|
end
|
@@ -257,19 +300,15 @@ module Aws::DataSync
|
|
257
300
|
# You can use an agent for more than one location. If a task uses
|
258
301
|
# multiple agents, all of them need to have status AVAILABLE for the
|
259
302
|
# task to run. If you use multiple agents for a source location, the
|
260
|
-
# status of all the agents must be AVAILABLE for the task to run.
|
261
|
-
#
|
262
|
-
#
|
303
|
+
# status of all the agents must be AVAILABLE for the task to run.
|
304
|
+
#
|
305
|
+
# For more information, see
|
306
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/working-with-agents.html#activating-agent"
|
307
|
+
# (Activating an Agent) in the *AWS DataSync User Guide.*
|
263
308
|
#
|
264
309
|
# Agents are automatically updated by AWS on a regular basis, using a
|
265
310
|
# mechanism that ensures minimal interruption to your tasks.
|
266
311
|
#
|
267
|
-
#
|
268
|
-
#
|
269
|
-
#
|
270
|
-
#
|
271
|
-
# [1]: https://docs.aws.amazon.com/sync-service/latest/userguide/working-with-sync-agents.html#activating-sync-agent
|
272
|
-
#
|
273
312
|
# @option params [required, String] :activation_key
|
274
313
|
# Your agent activation key. You can get the activation key either by
|
275
314
|
# sending an HTTP GET request with redirects that enable you to get the
|
@@ -280,20 +319,19 @@ module Aws::DataSync
|
|
280
319
|
# key for your agent in the query string parameter `activationKey`. It
|
281
320
|
# might also include other activation-related parameters; however, these
|
282
321
|
# are merely defaults. The arguments you pass to this API call determine
|
283
|
-
# the actual configuration of your agent.
|
284
|
-
# [Activating a Sync Agent][1] in the *AWS DataSync User Guide.*
|
285
|
-
#
|
286
|
-
#
|
322
|
+
# the actual configuration of your agent.
|
287
323
|
#
|
288
|
-
#
|
324
|
+
# For more information, see
|
325
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/working-with-agents.html#activating-agent"
|
326
|
+
# (Activating a Agent) in the *AWS DataSync User Guide.*
|
289
327
|
#
|
290
328
|
# @option params [String] :agent_name
|
291
329
|
# The name you configured for your agent. This value is a text reference
|
292
330
|
# that is used to identify the agent in the console.
|
293
331
|
#
|
294
332
|
# @option params [Array<Types::TagListEntry>] :tags
|
295
|
-
# The key-value pair that represents the tag you want to associate
|
296
|
-
# the agent. The value can be an empty string. This value helps you
|
333
|
+
# The key-value pair that represents the tag that you want to associate
|
334
|
+
# with the agent. The value can be an empty string. This value helps you
|
297
335
|
# manage, filter, and search for your agents.
|
298
336
|
#
|
299
337
|
# <note markdown="1"> Valid characters for key and value are letters, spaces, and numbers
|
@@ -313,7 +351,7 @@ module Aws::DataSync
|
|
313
351
|
# agent_name: "TagValue",
|
314
352
|
# tags: [
|
315
353
|
# {
|
316
|
-
# key: "TagKey",
|
354
|
+
# key: "TagKey", # required
|
317
355
|
# value: "TagValue",
|
318
356
|
# },
|
319
357
|
# ],
|
@@ -334,7 +372,7 @@ module Aws::DataSync
|
|
334
372
|
|
335
373
|
# Creates an endpoint for an Amazon EFS file system.
|
336
374
|
#
|
337
|
-
# @option params [
|
375
|
+
# @option params [String] :subdirectory
|
338
376
|
# A subdirectory in the location’s path. This subdirectory in the EFS
|
339
377
|
# file system is used to read data from the EFS source location or write
|
340
378
|
# data to the EFS destination. By default, AWS DataSync uses the root
|
@@ -345,6 +383,27 @@ module Aws::DataSync
|
|
345
383
|
#
|
346
384
|
# @option params [required, Types::Ec2Config] :ec2_config
|
347
385
|
# The subnet and security group that the Amazon EFS file system uses.
|
386
|
+
# The security group that you provide needs to be able to communicate
|
387
|
+
# with the security group on the mount target in the subnet specified.
|
388
|
+
#
|
389
|
+
# The exact relationship between security group M (of the mount target)
|
390
|
+
# and security group S (which you provide for DataSync to use at this
|
391
|
+
# stage) is as follows:
|
392
|
+
#
|
393
|
+
# * Security group M (which you associate with the mount target) must
|
394
|
+
# allow inbound access for the Transmission Control Protocol (TCP) on
|
395
|
+
# the NFS port (2049) from security group S. You can enable inbound
|
396
|
+
# connections either by IP address (CIDR range) or security group.
|
397
|
+
#
|
398
|
+
# * Security group S (provided to DataSync to access EFS) should have a
|
399
|
+
# rule that enables outbound connections to the NFS port on one of the
|
400
|
+
# file system’s mount targets. You can enable outbound connections
|
401
|
+
# either by IP address (CIDR range) or security group.
|
402
|
+
#
|
403
|
+
# For information about security groups and mount targets, see
|
404
|
+
# "https://docs.aws.amazon.com/efs/latest/ug/security-considerations.html#network-access"
|
405
|
+
# (Security Groups for Amazon EC2 Instances and Mount Targets) in the
|
406
|
+
# *Amazon EFS User Guide*.
|
348
407
|
#
|
349
408
|
# @option params [Array<Types::TagListEntry>] :tags
|
350
409
|
# The key-value pair that represents a tag that you want to add to the
|
@@ -359,7 +418,7 @@ module Aws::DataSync
|
|
359
418
|
# @example Request syntax with placeholder values
|
360
419
|
#
|
361
420
|
# resp = client.create_location_efs({
|
362
|
-
# subdirectory: "Subdirectory",
|
421
|
+
# subdirectory: "Subdirectory",
|
363
422
|
# efs_filesystem_arn: "EfsFilesystemArn", # required
|
364
423
|
# ec2_config: { # required
|
365
424
|
# subnet_arn: "Ec2SubnetArn", # required
|
@@ -367,7 +426,7 @@ module Aws::DataSync
|
|
367
426
|
# },
|
368
427
|
# tags: [
|
369
428
|
# {
|
370
|
-
# key: "TagKey",
|
429
|
+
# key: "TagKey", # required
|
371
430
|
# value: "TagValue",
|
372
431
|
# },
|
373
432
|
# ],
|
@@ -404,16 +463,14 @@ module Aws::DataSync
|
|
404
463
|
# To transfer all the data in the folder you specified, DataSync needs
|
405
464
|
# to have permissions to read all the data. To ensure this, either
|
406
465
|
# configure the NFS export with `no_root_squash,` or ensure that the
|
407
|
-
# permissions for all of the files that you want
|
408
|
-
# for all users. Doing either enables the agent to read the
|
409
|
-
# the agent to access directories, you must additionally
|
410
|
-
# execute access.
|
411
|
-
# [18.7. The /etc/exports Configuration File][1] in the Centos
|
412
|
-
# documentation.
|
413
|
-
#
|
466
|
+
# permissions for all of the files that you want DataSync allow read
|
467
|
+
# access for all users. Doing either enables the agent to read the
|
468
|
+
# files. For the agent to access directories, you must additionally
|
469
|
+
# enable all execute access.
|
414
470
|
#
|
415
|
-
#
|
416
|
-
#
|
471
|
+
# For information about NFS export configuration, see
|
472
|
+
# "http://web.mit.edu/rhel-doc/5/RHEL-5-manual/Deployment\_Guide-en-US/s1-nfs-server-config-exports.html"
|
473
|
+
# (18.7. The /etc/exports Configuration File).
|
417
474
|
#
|
418
475
|
# @option params [required, String] :server_hostname
|
419
476
|
# The name of the NFS server. This value is the IP address or Domain
|
@@ -429,6 +486,9 @@ module Aws::DataSync
|
|
429
486
|
# Contains a list of Amazon Resource Names (ARNs) of agents that are
|
430
487
|
# used to connect to an NFS server.
|
431
488
|
#
|
489
|
+
# @option params [Types::NfsMountOptions] :mount_options
|
490
|
+
# The NFS mount options that DataSync can use to mount your NFS share.
|
491
|
+
#
|
432
492
|
# @option params [Array<Types::TagListEntry>] :tags
|
433
493
|
# The key-value pair that represents the tag that you want to add to the
|
434
494
|
# location. The value can be an empty string. We recommend using tags to
|
@@ -441,14 +501,17 @@ module Aws::DataSync
|
|
441
501
|
# @example Request syntax with placeholder values
|
442
502
|
#
|
443
503
|
# resp = client.create_location_nfs({
|
444
|
-
# subdirectory: "
|
504
|
+
# subdirectory: "NonEmptySubdirectory", # required
|
445
505
|
# server_hostname: "ServerHostname", # required
|
446
506
|
# on_prem_config: { # required
|
447
507
|
# agent_arns: ["AgentArn"], # required
|
448
508
|
# },
|
509
|
+
# mount_options: {
|
510
|
+
# version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
|
511
|
+
# },
|
449
512
|
# tags: [
|
450
513
|
# {
|
451
|
-
# key: "TagKey",
|
514
|
+
# key: "TagKey", # required
|
452
515
|
# value: "TagValue",
|
453
516
|
# },
|
454
517
|
# ],
|
@@ -474,14 +537,14 @@ module Aws::DataSync
|
|
474
537
|
# permissions. You can set up the required permissions by creating an
|
475
538
|
# IAM policy that grants the required permissions and attaching the
|
476
539
|
# policy to the role. An example of such a policy is shown in the
|
477
|
-
# examples section.
|
478
|
-
# Location Settings][1] in the *AWS DataSync User Guide*.
|
540
|
+
# examples section.
|
479
541
|
#
|
542
|
+
# For more information, see
|
543
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location"
|
544
|
+
# (Configuring Amazon S3 Location Settings) in the *AWS DataSync User
|
545
|
+
# Guide*.
|
480
546
|
#
|
481
|
-
#
|
482
|
-
# [1]: https://docs.aws.amazon.com/sync-service/latest/userguide/configuring-s3-locations.html
|
483
|
-
#
|
484
|
-
# @option params [required, String] :subdirectory
|
547
|
+
# @option params [String] :subdirectory
|
485
548
|
# A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
|
486
549
|
# is used to read data from the S3 source location or write data to the
|
487
550
|
# S3 destination.
|
@@ -491,13 +554,11 @@ module Aws::DataSync
|
|
491
554
|
#
|
492
555
|
# @option params [required, Types::S3Config] :s3_config
|
493
556
|
# The Amazon Resource Name (ARN) of the AWS Identity and Access
|
494
|
-
# Management (IAM) role that is used to access an Amazon S3 bucket.
|
495
|
-
# detailed information about using such a role, see [Components and
|
496
|
-
# Terminology][1] in the *AWS DataSync User Guide*.
|
557
|
+
# Management (IAM) role that is used to access an Amazon S3 bucket.
|
497
558
|
#
|
498
|
-
#
|
499
|
-
#
|
500
|
-
#
|
559
|
+
# For detailed information about using such a role, see
|
560
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location"
|
561
|
+
# (Creating a Location for Amazon S3) in the *AWS DataSync User Guide*.
|
501
562
|
#
|
502
563
|
# @option params [Array<Types::TagListEntry>] :tags
|
503
564
|
# The key-value pair that represents the tag that you want to add to the
|
@@ -511,14 +572,14 @@ module Aws::DataSync
|
|
511
572
|
# @example Request syntax with placeholder values
|
512
573
|
#
|
513
574
|
# resp = client.create_location_s3({
|
514
|
-
# subdirectory: "Subdirectory",
|
575
|
+
# subdirectory: "Subdirectory",
|
515
576
|
# s3_bucket_arn: "S3BucketArn", # required
|
516
577
|
# s3_config: { # required
|
517
578
|
# bucket_access_role_arn: "IamRoleArn", # required
|
518
579
|
# },
|
519
580
|
# tags: [
|
520
581
|
# {
|
521
|
-
# key: "TagKey",
|
582
|
+
# key: "TagKey", # required
|
522
583
|
# value: "TagValue",
|
523
584
|
# },
|
524
585
|
# ],
|
@@ -538,26 +599,23 @@ module Aws::DataSync
|
|
538
599
|
end
|
539
600
|
|
540
601
|
# Creates a task. A task is a set of two locations (source and
|
541
|
-
# destination) and a set of
|
542
|
-
#
|
543
|
-
#
|
544
|
-
#
|
545
|
-
#
|
546
|
-
#
|
547
|
-
#
|
548
|
-
#
|
549
|
-
#
|
550
|
-
# destination location to mount. Instead, AWS DataSync mounts a
|
551
|
-
# destination before every task execution and then unmounts it after
|
552
|
-
# every task execution.
|
602
|
+
# destination) and a set of Options that you use to control the behavior
|
603
|
+
# of a task. If you don't specify Options when you create a task, AWS
|
604
|
+
# DataSync populates them with service defaults.
|
605
|
+
#
|
606
|
+
# When you create a task, it first enters the CREATING state. During
|
607
|
+
# CREATING AWS DataSync attempts to mount the on-premises Network File
|
608
|
+
# System (NFS) location. The task transitions to the AVAILABLE state
|
609
|
+
# without waiting for the AWS location to become mounted. If required,
|
610
|
+
# AWS DataSync mounts the AWS location before each task execution.
|
553
611
|
#
|
554
612
|
# If an agent that is associated with a source (NFS) location goes
|
555
613
|
# offline, the task transitions to the UNAVAILABLE status. If the status
|
556
614
|
# of the task remains in the CREATING status for more than a few
|
557
615
|
# minutes, it means that your agent might be having trouble mounting the
|
558
|
-
# source NFS file system. Check the task's
|
559
|
-
#
|
560
|
-
#
|
616
|
+
# source NFS file system. Check the task's ErrorCode and ErrorDetail.
|
617
|
+
# Mount issues are often caused by either a misconfigured firewall or a
|
618
|
+
# mistyped NFS server host name.
|
561
619
|
#
|
562
620
|
# @option params [required, String] :source_location_arn
|
563
621
|
# The Amazon Resource Name (ARN) of the source location for the task.
|
@@ -567,17 +625,16 @@ module Aws::DataSync
|
|
567
625
|
#
|
568
626
|
# @option params [String] :cloud_watch_log_group_arn
|
569
627
|
# The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
|
570
|
-
# is used to monitor and log events in the task.
|
571
|
-
# these groups, see [Working with Log Groups and Log Streams][1] in the
|
572
|
-
# <i>Amazon CloudWatch User Guide. </i>
|
573
|
-
#
|
574
|
-
# For more information about how to useCloudWatchLogs with DataSync, see
|
575
|
-
# [Monitoring Your Task][2].
|
576
|
-
#
|
628
|
+
# is used to monitor and log events in the task.
|
577
629
|
#
|
630
|
+
# For more information on these groups, see
|
631
|
+
# "https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html"
|
632
|
+
# (Working with Log Groups and Log Streams) in the *Amazon CloudWatch
|
633
|
+
# User Guide*.
|
578
634
|
#
|
579
|
-
#
|
580
|
-
#
|
635
|
+
# For more information about how to useCloudWatchLogs with DataSync, see
|
636
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html"
|
637
|
+
# (Monitoring Your Task)
|
581
638
|
#
|
582
639
|
# @option params [String] :name
|
583
640
|
# The name of a task. This value is a text reference that is used to
|
@@ -594,6 +651,11 @@ module Aws::DataSync
|
|
594
651
|
# specifying the `OverrideOptions` before starting a the task execution.
|
595
652
|
# For more information, see the operation.
|
596
653
|
#
|
654
|
+
# @option params [Array<Types::FilterRule>] :excludes
|
655
|
+
# A filter that determines which files to exclude from a task based on
|
656
|
+
# the specified pattern. Transfers all files in the task’s subdirectory,
|
657
|
+
# except files that match the filter that is set.
|
658
|
+
#
|
597
659
|
# @option params [Array<Types::TagListEntry>] :tags
|
598
660
|
# The key-value pair that represents the tag that you want to add to the
|
599
661
|
# resource. The value can be an empty string.
|
@@ -620,9 +682,15 @@ module Aws::DataSync
|
|
620
682
|
# posix_permissions: "NONE", # accepts NONE, BEST_EFFORT, PRESERVE
|
621
683
|
# bytes_per_second: 1,
|
622
684
|
# },
|
685
|
+
# excludes: [
|
686
|
+
# {
|
687
|
+
# filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
|
688
|
+
# value: "FilterValue",
|
689
|
+
# },
|
690
|
+
# ],
|
623
691
|
# tags: [
|
624
692
|
# {
|
625
|
-
# key: "TagKey",
|
693
|
+
# key: "TagKey", # required
|
626
694
|
# value: "TagValue",
|
627
695
|
# },
|
628
696
|
# ],
|
@@ -647,11 +715,6 @@ module Aws::DataSync
|
|
647
715
|
# delete the agent virtual machine (VM) from your on-premises
|
648
716
|
# environment.
|
649
717
|
#
|
650
|
-
# <note markdown="1"> After you delete an agent, you can't reactivate it and you longer pay
|
651
|
-
# software charges for it.
|
652
|
-
#
|
653
|
-
# </note>
|
654
|
-
#
|
655
718
|
# @option params [required, String] :agent_arn
|
656
719
|
# The Amazon Resource Name (ARN) of the agent to delete. Use the
|
657
720
|
# `ListAgents` operation to return a list of agents for your account and
|
@@ -804,6 +867,7 @@ module Aws::DataSync
|
|
804
867
|
# * {Types::DescribeLocationNfsResponse#location_arn #location_arn} => String
|
805
868
|
# * {Types::DescribeLocationNfsResponse#location_uri #location_uri} => String
|
806
869
|
# * {Types::DescribeLocationNfsResponse#on_prem_config #on_prem_config} => Types::OnPremConfig
|
870
|
+
# * {Types::DescribeLocationNfsResponse#mount_options #mount_options} => Types::NfsMountOptions
|
807
871
|
# * {Types::DescribeLocationNfsResponse#creation_time #creation_time} => Time
|
808
872
|
#
|
809
873
|
# @example Request syntax with placeholder values
|
@@ -818,6 +882,7 @@ module Aws::DataSync
|
|
818
882
|
# resp.location_uri #=> String
|
819
883
|
# resp.on_prem_config.agent_arns #=> Array
|
820
884
|
# resp.on_prem_config.agent_arns[0] #=> String
|
885
|
+
# resp.mount_options.version #=> String, one of "AUTOMATIC", "NFS3", "NFS4_0", "NFS4_1"
|
821
886
|
# resp.creation_time #=> Time
|
822
887
|
#
|
823
888
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationNfs AWS API Documentation
|
@@ -880,6 +945,7 @@ module Aws::DataSync
|
|
880
945
|
# * {Types::DescribeTaskResponse#destination_location_arn #destination_location_arn} => String
|
881
946
|
# * {Types::DescribeTaskResponse#cloud_watch_log_group_arn #cloud_watch_log_group_arn} => String
|
882
947
|
# * {Types::DescribeTaskResponse#options #options} => Types::Options
|
948
|
+
# * {Types::DescribeTaskResponse#excludes #excludes} => Array<Types::FilterRule>
|
883
949
|
# * {Types::DescribeTaskResponse#error_code #error_code} => String
|
884
950
|
# * {Types::DescribeTaskResponse#error_detail #error_detail} => String
|
885
951
|
# * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
|
@@ -908,6 +974,9 @@ module Aws::DataSync
|
|
908
974
|
# resp.options.preserve_devices #=> String, one of "NONE", "PRESERVE"
|
909
975
|
# resp.options.posix_permissions #=> String, one of "NONE", "BEST_EFFORT", "PRESERVE"
|
910
976
|
# resp.options.bytes_per_second #=> Integer
|
977
|
+
# resp.excludes #=> Array
|
978
|
+
# resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
|
979
|
+
# resp.excludes[0].value #=> String
|
911
980
|
# resp.error_code #=> String
|
912
981
|
# resp.error_detail #=> String
|
913
982
|
# resp.creation_time #=> Time
|
@@ -931,6 +1000,8 @@ module Aws::DataSync
|
|
931
1000
|
# * {Types::DescribeTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
|
932
1001
|
# * {Types::DescribeTaskExecutionResponse#status #status} => String
|
933
1002
|
# * {Types::DescribeTaskExecutionResponse#options #options} => Types::Options
|
1003
|
+
# * {Types::DescribeTaskExecutionResponse#excludes #excludes} => Array<Types::FilterRule>
|
1004
|
+
# * {Types::DescribeTaskExecutionResponse#includes #includes} => Array<Types::FilterRule>
|
934
1005
|
# * {Types::DescribeTaskExecutionResponse#start_time #start_time} => Time
|
935
1006
|
# * {Types::DescribeTaskExecutionResponse#estimated_files_to_transfer #estimated_files_to_transfer} => Integer
|
936
1007
|
# * {Types::DescribeTaskExecutionResponse#estimated_bytes_to_transfer #estimated_bytes_to_transfer} => Integer
|
@@ -958,6 +1029,12 @@ module Aws::DataSync
|
|
958
1029
|
# resp.options.preserve_devices #=> String, one of "NONE", "PRESERVE"
|
959
1030
|
# resp.options.posix_permissions #=> String, one of "NONE", "BEST_EFFORT", "PRESERVE"
|
960
1031
|
# resp.options.bytes_per_second #=> Integer
|
1032
|
+
# resp.excludes #=> Array
|
1033
|
+
# resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
|
1034
|
+
# resp.excludes[0].value #=> String
|
1035
|
+
# resp.includes #=> Array
|
1036
|
+
# resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
|
1037
|
+
# resp.includes[0].value #=> String
|
961
1038
|
# resp.start_time #=> Time
|
962
1039
|
# resp.estimated_files_to_transfer #=> Integer
|
963
1040
|
# resp.estimated_bytes_to_transfer #=> Integer
|
@@ -1201,12 +1278,9 @@ module Aws::DataSync
|
|
1201
1278
|
# `TaskExecution` has the following transition phases: INITIALIZING \|
|
1202
1279
|
# PREPARING \| TRANSFERRING \| VERIFYING \| SUCCESS/FAILURE.
|
1203
1280
|
#
|
1204
|
-
# For detailed information, see *Task Execution* in
|
1205
|
-
#
|
1206
|
-
#
|
1207
|
-
#
|
1208
|
-
#
|
1209
|
-
# [1]: https://docs.aws.amazon.com/sync-service/latest/userguide/how-awssync-works.html#terminology
|
1281
|
+
# For detailed information, see *Task Execution* in
|
1282
|
+
# "https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-works.html#terminology"
|
1283
|
+
# (Components and Terminology) in the *AWS DataSync User Guide*.
|
1210
1284
|
#
|
1211
1285
|
# @option params [required, String] :task_arn
|
1212
1286
|
# The Amazon Resource Name (ARN) of the task to start.
|
@@ -1223,6 +1297,11 @@ module Aws::DataSync
|
|
1223
1297
|
# You can override the defaults options on each task execution by
|
1224
1298
|
# specifying an overriding `Options` value to StartTaskExecution.
|
1225
1299
|
#
|
1300
|
+
# @option params [Array<Types::FilterRule>] :includes
|
1301
|
+
# A filter that determines which files to include in the transfer during
|
1302
|
+
# a task execution based on the specified pattern in the filter. When
|
1303
|
+
# multiple include filters are set, they are interpreted as an OR.
|
1304
|
+
#
|
1226
1305
|
# @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1227
1306
|
#
|
1228
1307
|
# * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
|
@@ -1242,6 +1321,12 @@ module Aws::DataSync
|
|
1242
1321
|
# posix_permissions: "NONE", # accepts NONE, BEST_EFFORT, PRESERVE
|
1243
1322
|
# bytes_per_second: 1,
|
1244
1323
|
# },
|
1324
|
+
# includes: [
|
1325
|
+
# {
|
1326
|
+
# filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
|
1327
|
+
# value: "FilterValue",
|
1328
|
+
# },
|
1329
|
+
# ],
|
1245
1330
|
# })
|
1246
1331
|
#
|
1247
1332
|
# @example Response structure
|
@@ -1273,7 +1358,7 @@ module Aws::DataSync
|
|
1273
1358
|
# resource_arn: "TaggableResourceArn", # required
|
1274
1359
|
# tags: [ # required
|
1275
1360
|
# {
|
1276
|
-
# key: "TagKey",
|
1361
|
+
# key: "TagKey", # required
|
1277
1362
|
# value: "TagValue",
|
1278
1363
|
# },
|
1279
1364
|
# ],
|
@@ -1358,9 +1443,18 @@ module Aws::DataSync
|
|
1358
1443
|
# You can override the defaults options on each task execution by
|
1359
1444
|
# specifying an overriding `Options` value to StartTaskExecution.
|
1360
1445
|
#
|
1446
|
+
# @option params [Array<Types::FilterRule>] :excludes
|
1447
|
+
# A filter that determines which files to exclude from a task based on
|
1448
|
+
# the specified pattern in the filter. Transfers all files in the task’s
|
1449
|
+
# subdirectory, except files that match the filter that is set.
|
1450
|
+
#
|
1361
1451
|
# @option params [String] :name
|
1362
1452
|
# The name of the task to update.
|
1363
1453
|
#
|
1454
|
+
# @option params [String] :cloud_watch_log_group_arn
|
1455
|
+
# The Amazon Resource Name (ARN) of the resource name of the CloudWatch
|
1456
|
+
# LogGroup.
|
1457
|
+
#
|
1364
1458
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1365
1459
|
#
|
1366
1460
|
# @example Request syntax with placeholder values
|
@@ -1378,7 +1472,14 @@ module Aws::DataSync
|
|
1378
1472
|
# posix_permissions: "NONE", # accepts NONE, BEST_EFFORT, PRESERVE
|
1379
1473
|
# bytes_per_second: 1,
|
1380
1474
|
# },
|
1475
|
+
# excludes: [
|
1476
|
+
# {
|
1477
|
+
# filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
|
1478
|
+
# value: "FilterValue",
|
1479
|
+
# },
|
1480
|
+
# ],
|
1381
1481
|
# name: "TagValue",
|
1482
|
+
# cloud_watch_log_group_arn: "LogGroupArn",
|
1382
1483
|
# })
|
1383
1484
|
#
|
1384
1485
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
|
@@ -1403,7 +1504,7 @@ module Aws::DataSync
|
|
1403
1504
|
params: params,
|
1404
1505
|
config: config)
|
1405
1506
|
context[:gem_name] = 'aws-sdk-datasync'
|
1406
|
-
context[:gem_version] = '1.
|
1507
|
+
context[:gem_version] = '1.4.0'
|
1407
1508
|
Seahorse::Client::Request.new(handlers, context)
|
1408
1509
|
end
|
1409
1510
|
|