aws-sdk-datasync 1.31.0 → 1.35.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-datasync/client.rb +213 -93
- data/lib/aws-sdk-datasync/client_api.rb +6 -0
- data/lib/aws-sdk-datasync/types.rb +390 -138
- data/lib/aws-sdk-datasync.rb +1 -1
- metadata +7 -8
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 52bb9433850f9f998989a9e482c46e314dc4a0906459c85166533e80bbcf0961
|
4
|
+
data.tar.gz: 38d900eb7fff4c58a0a615f2421fa019fb7d9e9132517e0d740f8a7c39b58815
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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,
|
350
|
-
#
|
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
|
373
|
-
#
|
374
|
-
# activation process, you specify information such as the
|
375
|
-
# that you want to activate the agent in. You activate
|
376
|
-
#
|
377
|
-
# reside. Your tasks are created
|
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
|
389
|
-
# mechanism that ensures minimal interruption to your
|
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
|
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 *
|
404
|
-
#
|
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
|
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,
|
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
|
654
|
-
# Server on
|
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
|
670
|
-
# Server on
|
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
|
686
|
-
# Server on
|
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
|
-
#
|
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
|
-
#
|
825
|
-
#
|
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
|
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
|
839
|
-
# Regions, the storage class defaults to Standard. For buckets
|
840
|
-
# Outposts, the storage class defaults to
|
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
|
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
|
852
|
-
#
|
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 *
|
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
|
859
|
-
# Resource Names (ARNs) of the DataSync agents deployed on
|
860
|
-
# For more information about launching a DataSync agent on
|
861
|
-
# Outpost, see
|
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
|
1007
|
-
# different
|
1008
|
-
# reside in the Region where DataSync is
|
1009
|
-
# must be specified in a different
|
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
|
1012
|
-
# or between
|
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
|
1015
|
-
# you pay for data transfer between Regions. This is
|
1016
|
-
# transfer OUT from your source Region to your
|
1017
|
-
# more information, see [Data Transfer
|
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
|
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
|
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
|
1122
|
-
# delete the agent virtual machine (VM) from your
|
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
|
-
#
|
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
|
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
|
-
#
|
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<Types::FilterRule>
|
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
|
1628
|
-
# specified in the request. The returned
|
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 *
|
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
|
1891
|
-
# such as user ID (UID), group ID (GID), and file permissions,
|
1892
|
-
# overwriting files in the destination, data integrity
|
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
|
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
|
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
|
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
|
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
|
2062
|
-
# Server on
|
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
|
-
#
|
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
|
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
|
2253
|
-
# such as user ID (UID), group ID (GID), and file permissions,
|
2254
|
-
# overwriting files in the destination, data integrity
|
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
|
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
|
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
|
2347
|
-
# such as user ID (UID), group ID (GID), and file permissions,
|
2348
|
-
# overwriting files in the destination, data integrity
|
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
|
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.
|
2521
|
+
context[:gem_version] = '1.35.0'
|
2402
2522
|
Seahorse::Client::Request.new(handlers, context)
|
2403
2523
|
end
|
2404
2524
|
|