aws-sdk-datasync 1.3.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
|