aws-sdk-datasync 1.31.0 → 1.35.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 84b0365089ed38f2efe9bdc70c63897a9c8a0ee0ebe19ad976ebcc5f24486ce8
4
- data.tar.gz: a55fb1baf57d783490606f94b25ab6c81ccf6e72340574a9ffc105234ae2a74f
3
+ metadata.gz: 52bb9433850f9f998989a9e482c46e314dc4a0906459c85166533e80bbcf0961
4
+ data.tar.gz: 38d900eb7fff4c58a0a615f2421fa019fb7d9e9132517e0d740f8a7c39b58815
5
5
  SHA512:
6
- metadata.gz: fb18148ca66f67b8c91ae46e65507906d23247c42707854d608db90cd88e665854480185403f12f5b3878c46c3b2412a93ee608092291cd3863a84f1fcb2fbd6
7
- data.tar.gz: b8be0d5359613cfd1f80663ae9b6727c23bd4bd1e53a0c79d9b9d828555221ec0a30004bf4bcbd52b76a35bd65f2d54a94b18b29ee76dfa7d3e3de468f7672d6
6
+ metadata.gz: b5219a8bf2d78110b2c35809696bc37da55ad7e1c4c3d9f2a3f12b8e734065375f23e1818f94164ff13e712a1350036bb3c2d4136192b5804a2f4027a037f4d9
7
+ data.tar.gz: 66866314a79aafce49696d41869dcef5a43c9f86a7855fedac06cfd516e2273d133925881bafbf62fced99b21726a7f48c4917f17da60a03b195972ef25023e8
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.35.0 (2021-08-25)
5
+ ------------------
6
+
7
+ * Feature - Added include filters to CreateTask and UpdateTask, and added exclude filters to StartTaskExecution, giving customers more granular control over how DataSync transfers files, folders, and objects.
8
+
9
+ 1.34.0 (2021-07-30)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.33.0 (2021-07-28)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.32.0 (2021-05-28)
20
+ ------------------
21
+
22
+ * Feature - Added SecurityDescriptorCopyFlags option that allows for control of which components of SMB security descriptors are copied from source to destination objects.
23
+
4
24
  1.31.0 (2021-03-10)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.31.0
1
+ 1.35.0
@@ -346,8 +346,8 @@ module Aws::DataSync
346
346
  # you allow the task execution to complete, file content on the
347
347
  # destination is complete and consistent. This applies to other
348
348
  # unexpected failures that interrupt a task execution. In all of these
349
- # cases, AWS DataSync successfully complete the transfer when you start
350
- # the next task execution.
349
+ # cases, DataSync successfully complete the transfer when you start the
350
+ # next task execution.
351
351
  #
352
352
  # @option params [required, String] :task_execution_arn
353
353
  # The Amazon Resource Name (ARN) of the task execution to cancel.
@@ -369,12 +369,13 @@ module Aws::DataSync
369
369
  req.send_request(options)
370
370
  end
371
371
 
372
- # Activates an AWS DataSync agent that you have deployed on your host.
373
- # The activation process associates your agent with your account. In the
374
- # activation process, you specify information such as the AWS Region
375
- # that you want to activate the agent in. You activate the agent in the
376
- # AWS Region where your target locations (in Amazon S3 or Amazon EFS)
377
- # reside. Your tasks are created in this AWS Region.
372
+ # Activates an DataSync agent that you have deployed on your host. The
373
+ # activation process associates your agent with your account. In the
374
+ # activation process, you specify information such as the Amazon Web
375
+ # Services Region that you want to activate the agent in. You activate
376
+ # the agent in the Amazon Web Services Region where your target
377
+ # locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created
378
+ # in this Amazon Web Services Region.
378
379
  #
379
380
  # You can activate the agent in a VPC (virtual private cloud) or provide
380
381
  # the agent access to a VPC endpoint so you can run tasks without going
@@ -385,13 +386,14 @@ module Aws::DataSync
385
386
  # task to run. If you use multiple agents for a source location, the
386
387
  # status of all the agents must be AVAILABLE for the task to run.
387
388
  #
388
- # Agents are automatically updated by AWS on a regular basis, using a
389
- # mechanism that ensures minimal interruption to your tasks.
389
+ # Agents are automatically updated by Amazon Web Services on a regular
390
+ # basis, using a mechanism that ensures minimal interruption to your
391
+ # tasks.
390
392
  #
391
393
  # @option params [required, String] :activation_key
392
394
  # Your agent activation key. You can get the activation key either by
393
395
  # sending an HTTP GET request with redirects that enable you to get the
394
- # agent IP address (port 80). Alternatively, you can get it from the AWS
396
+ # agent IP address (port 80). Alternatively, you can get it from the
395
397
  # DataSync console.
396
398
  #
397
399
  # The redirect URL returned in the response provides you the activation
@@ -400,8 +402,8 @@ module Aws::DataSync
400
402
  # are merely defaults. The arguments you pass to this API call determine
401
403
  # the actual configuration of your agent.
402
404
  #
403
- # For more information, see Activating an Agent in the *AWS DataSync
404
- # User Guide.*
405
+ # For more information, see Activating an Agent in the *DataSync User
406
+ # Guide.*
405
407
  #
406
408
  # @option params [String] :agent_name
407
409
  # The name you configured for your agent. This value is a text reference
@@ -443,7 +445,11 @@ module Aws::DataSync
443
445
  #
444
446
  # @option params [Array<String>] :security_group_arns
445
447
  # The ARNs of the security groups used to protect your data transfer
446
- # task subnets. See CreateAgentRequest$SubnetArns.
448
+ # task subnets. See [SecurityGroupArns][1].
449
+ #
450
+ #
451
+ #
452
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Ec2Config.html#DataSync-Type-Ec2Config-SecurityGroupArns
447
453
  #
448
454
  # @return [Types::CreateAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
449
455
  #
@@ -483,7 +489,7 @@ module Aws::DataSync
483
489
  # @option params [String] :subdirectory
484
490
  # A subdirectory in the location’s path. This subdirectory in the EFS
485
491
  # file system is used to read data from the EFS source location or write
486
- # data to the EFS destination. By default, AWS DataSync uses the root
492
+ # data to the EFS destination. By default, DataSync uses the root
487
493
  # directory.
488
494
  #
489
495
  # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
@@ -584,6 +590,10 @@ module Aws::DataSync
584
590
  # The user who has the permissions to access files and folders in the
585
591
  # FSx for Windows File Server file system.
586
592
  #
593
+ # For information about choosing a user name that ensures sufficient
594
+ # permissions to files, folders, and metadata, see
595
+ # [user](create-fsx-location.html#FSxWuser).
596
+ #
587
597
  # @option params [String] :domain
588
598
  # The name of the Windows domain that the FSx for Windows File Server
589
599
  # belongs to.
@@ -650,8 +660,8 @@ module Aws::DataSync
650
660
  # files. For the agent to access directories, you must additionally
651
661
  # enable all execute access.
652
662
  #
653
- # If you are copying data to or from your AWS Snowcone device, see [NFS
654
- # Server on AWS Snowcone][1] for more information.
663
+ # If you are copying data to or from your Snowcone device, see [NFS
664
+ # Server on Snowcone][1] for more information.
655
665
  #
656
666
  # For information about NFS export configuration, see 18.7. The
657
667
  # /etc/exports Configuration File in the Red Hat Enterprise Linux
@@ -666,8 +676,8 @@ module Aws::DataSync
666
676
  # Name Service (DNS) name of the NFS server. An agent that is installed
667
677
  # on-premises uses this host name to mount the NFS server in a network.
668
678
  #
669
- # If you are copying data to or from your AWS Snowcone device, see [NFS
670
- # Server on AWS Snowcone][1] for more information.
679
+ # If you are copying data to or from your Snowcone device, see [NFS
680
+ # Server on Snowcone][1] for more information.
671
681
  #
672
682
  # <note markdown="1"> This name must either be DNS-compliant or must be an IP version 4
673
683
  # (IPv4) address.
@@ -682,8 +692,8 @@ module Aws::DataSync
682
692
  # Contains a list of Amazon Resource Names (ARNs) of agents that are
683
693
  # used to connect to an NFS server.
684
694
  #
685
- # If you are copying data to or from your AWS Snowcone device, see [NFS
686
- # Server on AWS Snowcone][1] for more information.
695
+ # If you are copying data to or from your Snowcone device, see [NFS
696
+ # Server on Snowcone][1] for more information.
687
697
  #
688
698
  #
689
699
  #
@@ -734,8 +744,12 @@ module Aws::DataSync
734
744
  end
735
745
 
736
746
  # Creates an endpoint for a self-managed object storage bucket. For more
737
- # information about self-managed object storage locations, see
738
- # create-object-location.
747
+ # information about self-managed object storage locations, see [Creating
748
+ # a location for object storage][1].
749
+ #
750
+ #
751
+ #
752
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
739
753
  #
740
754
  # @option params [required, String] :server_hostname
741
755
  # The name of the self-managed object storage server. This value is the
@@ -820,9 +834,12 @@ module Aws::DataSync
820
834
 
821
835
  # Creates an endpoint for an Amazon S3 bucket.
822
836
  #
823
- # For more information, see
824
- # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
825
- # in the *AWS DataSync User Guide*.
837
+ # For more information, see [Create an Amazon S3 location][1] in the
838
+ # *DataSync User Guide*.
839
+ #
840
+ #
841
+ #
842
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
826
843
  #
827
844
  # @option params [String] :subdirectory
828
845
  # A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -830,35 +847,43 @@ module Aws::DataSync
830
847
  # S3 destination.
831
848
  #
832
849
  # @option params [required, String] :s3_bucket_arn
833
- # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
834
- # this must be an access point ARN.
850
+ # The ARN of the Amazon S3 bucket. If the bucket is on an Amazon Web
851
+ # Services Outpost, this must be an access point ARN.
835
852
  #
836
853
  # @option params [String] :s3_storage_class
837
854
  # The Amazon S3 storage class that you want to store your files in when
838
- # this location is used as a task destination. For buckets in AWS
839
- # Regions, the storage class defaults to Standard. For buckets on AWS
840
- # Outposts, the storage class defaults to AWS S3 Outposts.
855
+ # this location is used as a task destination. For buckets in Amazon Web
856
+ # Services Regions, the storage class defaults to Standard. For buckets
857
+ # on Outposts, the storage class defaults to Amazon Web Services S3
858
+ # Outposts.
841
859
  #
842
860
  # For more information about S3 storage classes, see [Amazon S3 Storage
843
861
  # Classes][1]. Some storage classes have behaviors that can affect your
844
- # S3 storage cost. For detailed information, see using-storage-classes.
862
+ # S3 storage cost. For detailed information, see [Considerations when
863
+ # working with S3 storage classes in DataSync][2].
845
864
  #
846
865
  #
847
866
  #
848
867
  # [1]: http://aws.amazon.com/s3/storage-classes/
868
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
849
869
  #
850
870
  # @option params [required, Types::S3Config] :s3_config
851
- # The Amazon Resource Name (ARN) of the AWS Identity and Access
852
- # Management (IAM) role that is used to access an Amazon S3 bucket.
871
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
872
+ # (IAM) role that is used to access an Amazon S3 bucket.
853
873
  #
854
874
  # For detailed information about using such a role, see Creating a
855
- # Location for Amazon S3 in the *AWS DataSync User Guide*.
875
+ # Location for Amazon S3 in the *DataSync User Guide*.
856
876
  #
857
877
  # @option params [Array<String>] :agent_arns
858
- # If you are using DataSync on an AWS Outpost, specify the Amazon
859
- # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
860
- # For more information about launching a DataSync agent on an AWS
861
- # Outpost, see outposts-agent.
878
+ # If you are using DataSync on an Amazon Web Services Outpost, specify
879
+ # the Amazon Resource Names (ARNs) of the DataSync agents deployed on
880
+ # your Outpost. For more information about launching a DataSync agent on
881
+ # an Amazon Web Services Outpost, see [Deploy your DataSync agent on
882
+ # Outposts][1].
883
+ #
884
+ #
885
+ #
886
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent
862
887
  #
863
888
  # @option params [Array<Types::TagListEntry>] :tags
864
889
  # The key-value pair that represents the tag that you want to add to the
@@ -939,6 +964,10 @@ module Aws::DataSync
939
964
  # The user who can mount the share, has the permissions to access files
940
965
  # and folders in the SMB share.
941
966
  #
967
+ # For information about choosing a user name that ensures sufficient
968
+ # permissions to files, folders, and metadata, see
969
+ # [user](create-smb-location.html#SMBuser).
970
+ #
942
971
  # @option params [String] :domain
943
972
  # The name of the Windows domain that the SMB server belongs to.
944
973
  #
@@ -1003,18 +1032,21 @@ module Aws::DataSync
1003
1032
  # The configuration specifies options such as task scheduling, bandwidth
1004
1033
  # limits, etc. A task is the complete definition of a data transfer.
1005
1034
  #
1006
- # When you create a task that transfers data between AWS services in
1007
- # different AWS Regions, one of the two locations that you specify must
1008
- # reside in the Region where DataSync is being used. The other location
1009
- # must be specified in a different Region.
1035
+ # When you create a task that transfers data between Amazon Web Services
1036
+ # services in different Amazon Web Services Regions, one of the two
1037
+ # locations that you specify must reside in the Region where DataSync is
1038
+ # being used. The other location must be specified in a different
1039
+ # Region.
1010
1040
  #
1011
- # You can transfer data between commercial AWS Regions except for China,
1012
- # or between AWS GovCloud (US-East and US-West) Regions.
1041
+ # You can transfer data between commercial Amazon Web Services Regions
1042
+ # except for China, or between Amazon Web Services GovCloud (US)
1043
+ # Regions.
1013
1044
  #
1014
- # When you use DataSync to copy files or objects between AWS Regions,
1015
- # you pay for data transfer between Regions. This is billed as data
1016
- # transfer OUT from your source Region to your destination Region. For
1017
- # more information, see [Data Transfer pricing][1].
1045
+ # When you use DataSync to copy files or objects between Amazon Web
1046
+ # Services Regions, you pay for data transfer between Regions. This is
1047
+ # billed as data transfer OUT from your source Region to your
1048
+ # destination Region. For more information, see [Data Transfer
1049
+ # pricing][1].
1018
1050
  #
1019
1051
  #
1020
1052
  #
@@ -1024,7 +1056,8 @@ module Aws::DataSync
1024
1056
  # The Amazon Resource Name (ARN) of the source location for the task.
1025
1057
  #
1026
1058
  # @option params [required, String] :destination_location_arn
1027
- # The Amazon Resource Name (ARN) of an AWS storage resource's location.
1059
+ # The Amazon Resource Name (ARN) of an Amazon Web Services storage
1060
+ # resource's location.
1028
1061
  #
1029
1062
  # @option params [String] :cloud_watch_log_group_arn
1030
1063
  # The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
@@ -1043,7 +1076,11 @@ module Aws::DataSync
1043
1076
  #
1044
1077
  # For each individual task execution, you can override these options by
1045
1078
  # specifying the `OverrideOptions` before starting the task execution.
1046
- # For more information, see the operation.
1079
+ # For more information, see the [StartTaskExecution][1] operation.
1080
+ #
1081
+ #
1082
+ #
1083
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
1047
1084
  #
1048
1085
  # @option params [Array<Types::FilterRule>] :excludes
1049
1086
  # A list of filter rules that determines which files to exclude from a
@@ -1054,12 +1091,22 @@ module Aws::DataSync
1054
1091
  # @option params [Types::TaskSchedule] :schedule
1055
1092
  # Specifies a schedule used to periodically transfer files from a source
1056
1093
  # to a destination location. The schedule should be specified in UTC
1057
- # time. For more information, see task-scheduling.
1094
+ # time. For more information, see [Scheduling your task][1].
1095
+ #
1096
+ #
1097
+ #
1098
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
1058
1099
  #
1059
1100
  # @option params [Array<Types::TagListEntry>] :tags
1060
1101
  # The key-value pair that represents the tag that you want to add to the
1061
1102
  # resource. The value can be an empty string.
1062
1103
  #
1104
+ # @option params [Array<Types::FilterRule>] :includes
1105
+ # A list of filter rules that determines which files to include when
1106
+ # running a task. The pattern should contain a single filter string that
1107
+ # consists of the patterns to include. The patterns are delimited by
1108
+ # "\|" (that is, a pipe). For example: `"/folder1|/folder2`"
1109
+ #
1063
1110
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1064
1111
  #
1065
1112
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1085,6 +1132,7 @@ module Aws::DataSync
1085
1132
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
1086
1133
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
1087
1134
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
1135
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
1088
1136
  # },
1089
1137
  # excludes: [
1090
1138
  # {
@@ -1101,6 +1149,12 @@ module Aws::DataSync
1101
1149
  # value: "TagValue",
1102
1150
  # },
1103
1151
  # ],
1152
+ # includes: [
1153
+ # {
1154
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
1155
+ # value: "FilterValue",
1156
+ # },
1157
+ # ],
1104
1158
  # })
1105
1159
  #
1106
1160
  # @example Response structure
@@ -1118,14 +1172,14 @@ module Aws::DataSync
1118
1172
 
1119
1173
  # Deletes an agent. To specify which agent to delete, use the Amazon
1120
1174
  # Resource Name (ARN) of the agent in your request. The operation
1121
- # disassociates the agent from your AWS account. However, it doesn't
1122
- # delete the agent virtual machine (VM) from your on-premises
1123
- # environment.
1175
+ # disassociates the agent from your Amazon Web Services account.
1176
+ # However, it doesn't delete the agent virtual machine (VM) from your
1177
+ # on-premises environment.
1124
1178
  #
1125
1179
  # @option params [required, String] :agent_arn
1126
1180
  # The Amazon Resource Name (ARN) of the agent to delete. Use the
1127
1181
  # `ListAgents` operation to return a list of agents for your account and
1128
- # AWS Region.
1182
+ # Amazon Web Services Region.
1129
1183
  #
1130
1184
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1131
1185
  #
@@ -1144,7 +1198,7 @@ module Aws::DataSync
1144
1198
  req.send_request(options)
1145
1199
  end
1146
1200
 
1147
- # Deletes the configuration of a location used by AWS DataSync.
1201
+ # Deletes the configuration of a location used by DataSync.
1148
1202
  #
1149
1203
  # @option params [required, String] :location_arn
1150
1204
  # The Amazon Resource Name (ARN) of the location to delete.
@@ -1353,7 +1407,11 @@ module Aws::DataSync
1353
1407
 
1354
1408
  # Returns metadata about a self-managed object storage server location.
1355
1409
  # For more information about self-managed object storage locations, see
1356
- # create-object-location.
1410
+ # [Creating a location for object storage][1].
1411
+ #
1412
+ #
1413
+ #
1414
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
1357
1415
  #
1358
1416
  # @option params [required, String] :location_arn
1359
1417
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1500,6 +1558,7 @@ module Aws::DataSync
1500
1558
  # * {Types::DescribeTaskResponse#error_code #error_code} => String
1501
1559
  # * {Types::DescribeTaskResponse#error_detail #error_detail} => String
1502
1560
  # * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
1561
+ # * {Types::DescribeTaskResponse#includes #includes} => Array&lt;Types::FilterRule&gt;
1503
1562
  #
1504
1563
  # @example Request syntax with placeholder values
1505
1564
  #
@@ -1533,6 +1592,7 @@ module Aws::DataSync
1533
1592
  # resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
1534
1593
  # resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
1535
1594
  # resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
1595
+ # resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
1536
1596
  # resp.excludes #=> Array
1537
1597
  # resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1538
1598
  # resp.excludes[0].value #=> String
@@ -1540,6 +1600,9 @@ module Aws::DataSync
1540
1600
  # resp.error_code #=> String
1541
1601
  # resp.error_detail #=> String
1542
1602
  # resp.creation_time #=> Time
1603
+ # resp.includes #=> Array
1604
+ # resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1605
+ # resp.includes[0].value #=> String
1543
1606
  #
1544
1607
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
1545
1608
  #
@@ -1593,6 +1656,7 @@ module Aws::DataSync
1593
1656
  # resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
1594
1657
  # resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
1595
1658
  # resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
1659
+ # resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
1596
1660
  # resp.excludes #=> Array
1597
1661
  # resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1598
1662
  # resp.excludes[0].value #=> String
@@ -1624,9 +1688,9 @@ module Aws::DataSync
1624
1688
  req.send_request(options)
1625
1689
  end
1626
1690
 
1627
- # Returns a list of agents owned by an AWS account in the AWS Region
1628
- # specified in the request. The returned list is ordered by agent Amazon
1629
- # Resource Name (ARN).
1691
+ # Returns a list of agents owned by an Amazon Web Services account in
1692
+ # the Amazon Web Services Region specified in the request. The returned
1693
+ # list is ordered by agent Amazon Resource Name (ARN).
1630
1694
  #
1631
1695
  # By default, this operation returns a maximum of 100 agents. This
1632
1696
  # operation supports pagination that enables you to optionally reduce
@@ -1880,22 +1944,26 @@ module Aws::DataSync
1880
1944
  # PREPARING \| TRANSFERRING \| VERIFYING \| SUCCESS/FAILURE.
1881
1945
  #
1882
1946
  # For detailed information, see the Task Execution section in the
1883
- # Components and Terminology topic in the *AWS DataSync User Guide*.
1947
+ # Components and Terminology topic in the *DataSync User Guide*.
1884
1948
  #
1885
1949
  # @option params [required, String] :task_arn
1886
1950
  # The Amazon Resource Name (ARN) of the task to start.
1887
1951
  #
1888
1952
  # @option params [Types::Options] :override_options
1889
1953
  # Represents the options that are available to control the behavior of a
1890
- # StartTaskExecution operation. Behavior includes preserving metadata
1891
- # such as user ID (UID), group ID (GID), and file permissions, and also
1892
- # overwriting files in the destination, data integrity verification, and
1893
- # so on.
1954
+ # [StartTaskExecution][1] operation. Behavior includes preserving
1955
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
1956
+ # and also overwriting files in the destination, data integrity
1957
+ # verification, and so on.
1894
1958
  #
1895
1959
  # A task has a set of default options associated with it. If you don't
1896
- # specify an option in StartTaskExecution, the default value is used.
1897
- # You can override the defaults options on each task execution by
1898
- # specifying an overriding `Options` value to StartTaskExecution.
1960
+ # specify an option in [StartTaskExecution][1], the default value is
1961
+ # used. You can override the defaults options on each task execution by
1962
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
1963
+ #
1964
+ #
1965
+ #
1966
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
1899
1967
  #
1900
1968
  # @option params [Array<Types::FilterRule>] :includes
1901
1969
  # A list of filter rules that determines which files to include when
@@ -1903,6 +1971,12 @@ module Aws::DataSync
1903
1971
  # consists of the patterns to include. The patterns are delimited by
1904
1972
  # "\|" (that is, a pipe). For example: `"/folder1|/folder2"`
1905
1973
  #
1974
+ # @option params [Array<Types::FilterRule>] :excludes
1975
+ # A list of filter rules that determines which files to exclude from a
1976
+ # task. The list should contain a single filter string that consists of
1977
+ # the patterns to exclude. The patterns are delimited by "\|" (that
1978
+ # is, a pipe), for example, `"/folder1|/folder2"`.
1979
+ #
1906
1980
  # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1907
1981
  #
1908
1982
  # * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
@@ -1925,6 +1999,7 @@ module Aws::DataSync
1925
1999
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
1926
2000
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
1927
2001
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2002
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
1928
2003
  # },
1929
2004
  # includes: [
1930
2005
  # {
@@ -1932,6 +2007,12 @@ module Aws::DataSync
1932
2007
  # value: "FilterValue",
1933
2008
  # },
1934
2009
  # ],
2010
+ # excludes: [
2011
+ # {
2012
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
2013
+ # value: "FilterValue",
2014
+ # },
2015
+ # ],
1935
2016
  # })
1936
2017
  #
1937
2018
  # @example Response structure
@@ -1947,7 +2028,7 @@ module Aws::DataSync
1947
2028
  req.send_request(options)
1948
2029
  end
1949
2030
 
1950
- # Applies a key-value pair to an AWS resource.
2031
+ # Applies a key-value pair to an Amazon Web Services resource.
1951
2032
  #
1952
2033
  # @option params [required, String] :resource_arn
1953
2034
  # The Amazon Resource Name (ARN) of the resource to apply the tag to.
@@ -1978,7 +2059,7 @@ module Aws::DataSync
1978
2059
  req.send_request(options)
1979
2060
  end
1980
2061
 
1981
- # Removes a tag from an AWS resource.
2062
+ # Removes a tag from an Amazon Web Services resource.
1982
2063
  #
1983
2064
  # @option params [required, String] :resource_arn
1984
2065
  # The Amazon Resource Name (ARN) of the resource to remove the tag from.
@@ -2032,7 +2113,11 @@ module Aws::DataSync
2032
2113
 
2033
2114
  # Updates some of the parameters of a previously created location for
2034
2115
  # Network File System (NFS) access. For information about creating an
2035
- # NFS location, see create-nfs-location.
2116
+ # NFS location, see [Creating a location for NFS][1].
2117
+ #
2118
+ #
2119
+ #
2120
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
2036
2121
  #
2037
2122
  # @option params [required, String] :location_arn
2038
2123
  # The Amazon Resource Name (ARN) of the NFS location to update.
@@ -2058,8 +2143,8 @@ module Aws::DataSync
2058
2143
  # the files. For the agent to access directories, you must additionally
2059
2144
  # enable all execute access.
2060
2145
  #
2061
- # If you are copying data to or from your AWS Snowcone device, see [NFS
2062
- # Server on AWS Snowcone][1] for more information.
2146
+ # If you are copying data to or from your Snowcone device, see [NFS
2147
+ # Server on Snowcone][1] for more information.
2063
2148
  #
2064
2149
  # For information about NFS export configuration, see 18.7. The
2065
2150
  # /etc/exports Configuration File in the Red Hat Enterprise Linux
@@ -2103,8 +2188,12 @@ module Aws::DataSync
2103
2188
 
2104
2189
  # Updates some of the parameters of a previously created location for
2105
2190
  # self-managed object storage server access. For information about
2106
- # creating a self-managed object storage location, see
2107
- # create-object-location.
2191
+ # creating a self-managed object storage location, see [Creating a
2192
+ # location for object storage][1].
2193
+ #
2194
+ #
2195
+ #
2196
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
2108
2197
  #
2109
2198
  # @option params [required, String] :location_arn
2110
2199
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -2165,7 +2254,11 @@ module Aws::DataSync
2165
2254
 
2166
2255
  # Updates some of the parameters of a previously created location for
2167
2256
  # Server Message Block (SMB) file system access. For information about
2168
- # creating an SMB location, see create-smb-location.
2257
+ # creating an SMB location, see [Creating a location for SMB][1].
2258
+ #
2259
+ #
2260
+ #
2261
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html
2169
2262
  #
2170
2263
  # @option params [required, String] :location_arn
2171
2264
  # The Amazon Resource Name (ARN) of the SMB location to update.
@@ -2249,15 +2342,19 @@ module Aws::DataSync
2249
2342
  #
2250
2343
  # @option params [Types::Options] :options
2251
2344
  # Represents the options that are available to control the behavior of a
2252
- # StartTaskExecution operation. Behavior includes preserving metadata
2253
- # such as user ID (UID), group ID (GID), and file permissions, and also
2254
- # overwriting files in the destination, data integrity verification, and
2255
- # so on.
2345
+ # [StartTaskExecution][1] operation. Behavior includes preserving
2346
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
2347
+ # and also overwriting files in the destination, data integrity
2348
+ # verification, and so on.
2256
2349
  #
2257
2350
  # A task has a set of default options associated with it. If you don't
2258
- # specify an option in StartTaskExecution, the default value is used.
2259
- # You can override the defaults options on each task execution by
2260
- # specifying an overriding `Options` value to StartTaskExecution.
2351
+ # specify an option in [StartTaskExecution][1], the default value is
2352
+ # used. You can override the defaults options on each task execution by
2353
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
2354
+ #
2355
+ #
2356
+ #
2357
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
2261
2358
  #
2262
2359
  # @option params [Array<Types::FilterRule>] :excludes
2263
2360
  # A list of filter rules that determines which files to exclude from a
@@ -2270,7 +2367,12 @@ module Aws::DataSync
2270
2367
  # to a destination location. You can configure your task to execute
2271
2368
  # hourly, daily, weekly or on specific days of the week. You control
2272
2369
  # when in the day or hour you want the task to execute. The time you
2273
- # specify is UTC time. For more information, see task-scheduling.
2370
+ # specify is UTC time. For more information, see [Scheduling your
2371
+ # task][1].
2372
+ #
2373
+ #
2374
+ #
2375
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
2274
2376
  #
2275
2377
  # @option params [String] :name
2276
2378
  # The name of the task to update.
@@ -2279,6 +2381,12 @@ module Aws::DataSync
2279
2381
  # The Amazon Resource Name (ARN) of the resource name of the CloudWatch
2280
2382
  # LogGroup.
2281
2383
  #
2384
+ # @option params [Array<Types::FilterRule>] :includes
2385
+ # A list of filter rules that determines which files to include when
2386
+ # running a task. The pattern should contain a single filter string that
2387
+ # consists of the patterns to include. The patterns are delimited by
2388
+ # "\|" (that is, a pipe). For example: `"/folder1|/folder2`"
2389
+ #
2282
2390
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2283
2391
  #
2284
2392
  # @example Request syntax with placeholder values
@@ -2299,6 +2407,7 @@ module Aws::DataSync
2299
2407
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2300
2408
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2301
2409
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2410
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
2302
2411
  # },
2303
2412
  # excludes: [
2304
2413
  # {
@@ -2311,6 +2420,12 @@ module Aws::DataSync
2311
2420
  # },
2312
2421
  # name: "TagValue",
2313
2422
  # cloud_watch_log_group_arn: "LogGroupArn",
2423
+ # includes: [
2424
+ # {
2425
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
2426
+ # value: "FilterValue",
2427
+ # },
2428
+ # ],
2314
2429
  # })
2315
2430
  #
2316
2431
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -2343,15 +2458,19 @@ module Aws::DataSync
2343
2458
  #
2344
2459
  # @option params [required, Types::Options] :options
2345
2460
  # Represents the options that are available to control the behavior of a
2346
- # StartTaskExecution operation. Behavior includes preserving metadata
2347
- # such as user ID (UID), group ID (GID), and file permissions, and also
2348
- # overwriting files in the destination, data integrity verification, and
2349
- # so on.
2461
+ # [StartTaskExecution][1] operation. Behavior includes preserving
2462
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
2463
+ # and also overwriting files in the destination, data integrity
2464
+ # verification, and so on.
2350
2465
  #
2351
2466
  # A task has a set of default options associated with it. If you don't
2352
- # specify an option in StartTaskExecution, the default value is used.
2353
- # You can override the defaults options on each task execution by
2354
- # specifying an overriding `Options` value to StartTaskExecution.
2467
+ # specify an option in [StartTaskExecution][1], the default value is
2468
+ # used. You can override the defaults options on each task execution by
2469
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
2470
+ #
2471
+ #
2472
+ #
2473
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
2355
2474
  #
2356
2475
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2357
2476
  #
@@ -2373,6 +2492,7 @@ module Aws::DataSync
2373
2492
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2374
2493
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2375
2494
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2495
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
2376
2496
  # },
2377
2497
  # })
2378
2498
  #
@@ -2398,7 +2518,7 @@ module Aws::DataSync
2398
2518
  params: params,
2399
2519
  config: config)
2400
2520
  context[:gem_name] = 'aws-sdk-datasync'
2401
- context[:gem_version] = '1.31.0'
2521
+ context[:gem_version] = '1.35.0'
2402
2522
  Seahorse::Client::Request.new(handlers, context)
2403
2523
  end
2404
2524