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 +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
|
|