aws-sdk-datasync 1.90.0 → 1.92.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 +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-datasync/client.rb +157 -72
- data/lib/aws-sdk-datasync/client_api.rb +21 -0
- data/lib/aws-sdk-datasync/types.rb +568 -165
- data/lib/aws-sdk-datasync.rb +1 -1
- data/sig/client.rbs +7 -1
- data/sig/types.rbs +22 -0
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: d4d3df19224bada3e62cfd541fbca79e0ceea9a3092fcdf7c5cd62154bc5351b
|
4
|
+
data.tar.gz: 44c175fea85c78b93c93f992760c094f09b703c04912122a4440e2b69a556c10
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 48b6ba4f9d5f7a6b8fb5b4140395c1949282f7aaeb2f5169182eba438f9efaa6de9fcb840c2cc27e90f48deda90149a7c0a72e937cb8c4d3a66e3a0f9b491d8b
|
7
|
+
data.tar.gz: 285e3c24ab0d1b84b321edc4a967a5fb1dc02b3f3f2e0278be2d7469b6030476238a4d4c7ede3812868a14d4f40a90f46c46cd94e52d442cc0b621bf29aaa5ef
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.92.0 (2024-11-15)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Doc-only updates and enhancements related to creating DataSync tasks and describing task executions.
|
8
|
+
|
9
|
+
1.91.0 (2024-10-30)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - AWS DataSync now supports Enhanced mode tasks. This task mode supports transfer of virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. This mode currently supports transfers between Amazon S3 locations.
|
13
|
+
|
4
14
|
1.90.0 (2024-10-18)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.92.0
|
@@ -572,38 +572,28 @@ module Aws::DataSync
|
|
572
572
|
req.send_request(options)
|
573
573
|
end
|
574
574
|
|
575
|
-
# Activates an DataSync agent that you
|
575
|
+
# Activates an DataSync agent that you deploy in your storage
|
576
576
|
# environment. The activation process associates the agent with your
|
577
577
|
# Amazon Web Services account.
|
578
578
|
#
|
579
|
-
# If you haven't deployed an agent yet, see
|
580
|
-
#
|
579
|
+
# If you haven't deployed an agent yet, see [Do I need a DataSync
|
580
|
+
# agent?][1]
|
581
581
|
#
|
582
|
-
# * [Agent requirements][1]
|
583
582
|
#
|
584
|
-
# * [Create an agent][2]
|
585
583
|
#
|
586
|
-
#
|
587
|
-
# you don't need a DataSync agent.
|
588
|
-
#
|
589
|
-
# </note>
|
590
|
-
#
|
591
|
-
#
|
592
|
-
#
|
593
|
-
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/agent-requirements.html
|
594
|
-
# [2]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-agent.html
|
584
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html
|
595
585
|
#
|
596
586
|
# @option params [required, String] :activation_key
|
597
587
|
# Specifies your DataSync agent's activation key. If you don't have an
|
598
|
-
# activation key, see [
|
588
|
+
# activation key, see [Activating your agent][1].
|
599
589
|
#
|
600
590
|
#
|
601
591
|
#
|
602
592
|
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html
|
603
593
|
#
|
604
594
|
# @option params [String] :agent_name
|
605
|
-
# Specifies a name for your agent.
|
606
|
-
#
|
595
|
+
# Specifies a name for your agent. We recommend specifying a name that
|
596
|
+
# you can remember.
|
607
597
|
#
|
608
598
|
# @option params [Array<Types::TagListEntry>] :tags
|
609
599
|
# Specifies labels that help you categorize, filter, and search for your
|
@@ -611,32 +601,24 @@ module Aws::DataSync
|
|
611
601
|
# for your agent.
|
612
602
|
#
|
613
603
|
# @option params [String] :vpc_endpoint_id
|
614
|
-
# Specifies the ID of the VPC endpoint that you
|
615
|
-
#
|
616
|
-
# `vpce-01234d5aff67890e1`.
|
604
|
+
# Specifies the ID of the [VPC service endpoint][1] that you're using.
|
605
|
+
# For example, a VPC endpoint ID looks like `vpce-01234d5aff67890e1`.
|
617
606
|
#
|
618
|
-
# The VPC endpoint you use must include the DataSync service
|
619
|
-
# example, `com.amazonaws.us-east-2.datasync`).
|
607
|
+
# The VPC service endpoint you use must include the DataSync service
|
608
|
+
# name (for example, `com.amazonaws.us-east-2.datasync`).
|
620
609
|
#
|
621
|
-
# @option params [Array<String>] :subnet_arns
|
622
|
-
# Specifies the ARN of the subnet where you want to run your DataSync
|
623
|
-
# task when using a VPC endpoint. This is the subnet where DataSync
|
624
|
-
# creates and manages the [network interfaces][1] for your transfer. You
|
625
|
-
# can only specify one ARN.
|
626
610
|
#
|
627
611
|
#
|
612
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc
|
628
613
|
#
|
629
|
-
#
|
614
|
+
# @option params [Array<String>] :subnet_arns
|
615
|
+
# Specifies the ARN of the subnet where your VPC service endpoint is
|
616
|
+
# located. You can only specify one ARN.
|
630
617
|
#
|
631
618
|
# @option params [Array<String>] :security_group_arns
|
632
619
|
# Specifies the Amazon Resource Name (ARN) of the security group that
|
633
|
-
#
|
634
|
-
#
|
635
|
-
#
|
636
|
-
#
|
637
|
-
#
|
638
|
-
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
|
639
|
-
# [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc
|
620
|
+
# allows traffic between your agent and VPC service endpoint. You can
|
621
|
+
# only specify one ARN.
|
640
622
|
#
|
641
623
|
# @return [Types::CreateAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
642
624
|
#
|
@@ -790,20 +772,26 @@ module Aws::DataSync
|
|
790
772
|
# @option params [String] :subdirectory
|
791
773
|
# Specifies a mount path for your Amazon EFS file system. This is where
|
792
774
|
# DataSync reads or writes data (depending on if this is a source or
|
793
|
-
# destination location)
|
794
|
-
# but you can also include subdirectories.
|
775
|
+
# destination location) on your file system.
|
795
776
|
#
|
796
|
-
#
|
797
|
-
#
|
777
|
+
# By default, DataSync uses the root directory (or [access point][1] if
|
778
|
+
# you provide one by using `AccessPointArn`). You can also include
|
779
|
+
# subdirectories using forward slashes (for example, `/path/to/folder`).
|
798
780
|
#
|
799
|
-
#
|
781
|
+
#
|
782
|
+
#
|
783
|
+
# [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
|
800
784
|
#
|
801
785
|
# @option params [required, String] :efs_filesystem_arn
|
802
|
-
# Specifies the ARN for
|
786
|
+
# Specifies the ARN for your Amazon EFS file system.
|
803
787
|
#
|
804
788
|
# @option params [required, Types::Ec2Config] :ec2_config
|
805
|
-
# Specifies the subnet and security groups DataSync uses to
|
806
|
-
# Amazon EFS file system.
|
789
|
+
# Specifies the subnet and security groups DataSync uses to connect to
|
790
|
+
# one of your Amazon EFS file system's [mount targets][1].
|
791
|
+
#
|
792
|
+
#
|
793
|
+
#
|
794
|
+
# [1]: https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html
|
807
795
|
#
|
808
796
|
# @option params [Array<Types::TagListEntry>] :tags
|
809
797
|
# Specifies the key-value pair that represents a tag that you want to
|
@@ -813,15 +801,28 @@ module Aws::DataSync
|
|
813
801
|
#
|
814
802
|
# @option params [String] :access_point_arn
|
815
803
|
# Specifies the Amazon Resource Name (ARN) of the access point that
|
816
|
-
# DataSync uses to
|
804
|
+
# DataSync uses to mount your Amazon EFS file system.
|
805
|
+
#
|
806
|
+
# For more information, see [Accessing restricted file systems][1].
|
807
|
+
#
|
808
|
+
#
|
809
|
+
#
|
810
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam
|
817
811
|
#
|
818
812
|
# @option params [String] :file_system_access_role_arn
|
819
|
-
# Specifies an Identity and Access Management (IAM) role that
|
820
|
-
#
|
813
|
+
# Specifies an Identity and Access Management (IAM) role that allows
|
814
|
+
# DataSync to access your Amazon EFS file system.
|
815
|
+
#
|
816
|
+
# For information on creating this role, see [Creating a DataSync IAM
|
817
|
+
# role for file system access][1].
|
818
|
+
#
|
819
|
+
#
|
820
|
+
#
|
821
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role
|
821
822
|
#
|
822
823
|
# @option params [String] :in_transit_encryption
|
823
824
|
# Specifies whether you want DataSync to use Transport Layer Security
|
824
|
-
# (TLS) 1.2 encryption when it
|
825
|
+
# (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS
|
825
826
|
# file system.
|
826
827
|
#
|
827
828
|
# If you specify an access point using `AccessPointArn` or an IAM role
|
@@ -1132,8 +1133,13 @@ module Aws::DataSync
|
|
1132
1133
|
# Server file system.
|
1133
1134
|
#
|
1134
1135
|
# @option params [required, Array<String>] :security_group_arns
|
1135
|
-
# Specifies the ARNs of the security groups that provide
|
1136
|
-
# file system's preferred subnet.
|
1136
|
+
# Specifies the ARNs of the Amazon EC2 security groups that provide
|
1137
|
+
# access to your file system's preferred subnet.
|
1138
|
+
#
|
1139
|
+
# The security groups that you specify must be able to communicate with
|
1140
|
+
# your file system's security groups. For information about configuring
|
1141
|
+
# security groups for file system access, see the [ *Amazon FSx for
|
1142
|
+
# Windows File Server User Guide* ][1].
|
1137
1143
|
#
|
1138
1144
|
# <note markdown="1"> If you choose a security group that doesn't allow connections from
|
1139
1145
|
# within itself, do one of the following:
|
@@ -1146,6 +1152,10 @@ module Aws::DataSync
|
|
1146
1152
|
#
|
1147
1153
|
# </note>
|
1148
1154
|
#
|
1155
|
+
#
|
1156
|
+
#
|
1157
|
+
# [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html
|
1158
|
+
#
|
1149
1159
|
# @option params [Array<Types::TagListEntry>] :tags
|
1150
1160
|
# Specifies labels that help you categorize, filter, and search for your
|
1151
1161
|
# Amazon Web Services resources. We recommend creating at least a name
|
@@ -1299,8 +1309,8 @@ module Aws::DataSync
|
|
1299
1309
|
# </note>
|
1300
1310
|
#
|
1301
1311
|
# @option params [required, Array<String>] :agent_arns
|
1302
|
-
# The Amazon Resource Names (ARNs) of the agents that
|
1303
|
-
# connect to
|
1312
|
+
# The Amazon Resource Names (ARNs) of the DataSync agents that can
|
1313
|
+
# connect to your HDFS cluster.
|
1304
1314
|
#
|
1305
1315
|
# @option params [Array<Types::TagListEntry>] :tags
|
1306
1316
|
# The key-value pair that represents the tag that you want to add to the
|
@@ -1391,14 +1401,14 @@ module Aws::DataSync
|
|
1391
1401
|
#
|
1392
1402
|
# @option params [required, Types::OnPremConfig] :on_prem_config
|
1393
1403
|
# Specifies the Amazon Resource Name (ARN) of the DataSync agent that
|
1394
|
-
#
|
1404
|
+
# can connect to your NFS file server.
|
1395
1405
|
#
|
1396
1406
|
# You can specify more than one agent. For more information, see [Using
|
1397
|
-
# multiple agents
|
1407
|
+
# multiple DataSync agents][1].
|
1398
1408
|
#
|
1399
1409
|
#
|
1400
1410
|
#
|
1401
|
-
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents
|
1411
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents
|
1402
1412
|
#
|
1403
1413
|
# @option params [Types::NfsMountOptions] :mount_options
|
1404
1414
|
# Specifies the options that DataSync can use to mount your NFS file
|
@@ -1489,7 +1499,7 @@ module Aws::DataSync
|
|
1489
1499
|
#
|
1490
1500
|
# @option params [required, Array<String>] :agent_arns
|
1491
1501
|
# Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
|
1492
|
-
# can
|
1502
|
+
# can connect with your object storage system.
|
1493
1503
|
#
|
1494
1504
|
# @option params [Array<Types::TagListEntry>] :tags
|
1495
1505
|
# Specifies the key-value pair that represents a tag that you want to
|
@@ -1745,9 +1755,9 @@ module Aws::DataSync
|
|
1745
1755
|
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
|
1746
1756
|
#
|
1747
1757
|
# @option params [required, Array<String>] :agent_arns
|
1748
|
-
# Specifies the DataSync agent (or agents)
|
1749
|
-
#
|
1750
|
-
#
|
1758
|
+
# Specifies the DataSync agent (or agents) that can connect to your SMB
|
1759
|
+
# file server. You specify an agent by using its Amazon Resource Name
|
1760
|
+
# (ARN).
|
1751
1761
|
#
|
1752
1762
|
# @option params [Types::SmbMountOptions] :mount_options
|
1753
1763
|
# Specifies the version of the SMB protocol that DataSync uses to access
|
@@ -1820,6 +1830,10 @@ module Aws::DataSync
|
|
1820
1830
|
# Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
|
1821
1831
|
# group for monitoring your task.
|
1822
1832
|
#
|
1833
|
+
# For Enhanced mode tasks, you don't need to specify anything. DataSync
|
1834
|
+
# automatically sends logs to a CloudWatch log group named
|
1835
|
+
# `/aws/datasync`.
|
1836
|
+
#
|
1823
1837
|
# @option params [String] :name
|
1824
1838
|
# Specifies the name of your task.
|
1825
1839
|
#
|
@@ -1852,8 +1866,8 @@ module Aws::DataSync
|
|
1852
1866
|
# for your DataSync resources.
|
1853
1867
|
#
|
1854
1868
|
# @option params [Array<Types::FilterRule>] :includes
|
1855
|
-
# Specifies include filters define the files, objects, and folders
|
1856
|
-
# your source location that you want DataSync to transfer. For more
|
1869
|
+
# Specifies include filters that define the files, objects, and folders
|
1870
|
+
# in your source location that you want DataSync to transfer. For more
|
1857
1871
|
# information and examples, see [Specifying what DataSync transfers by
|
1858
1872
|
# using filters][1].
|
1859
1873
|
#
|
@@ -1891,6 +1905,35 @@ module Aws::DataSync
|
|
1891
1905
|
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
|
1892
1906
|
# [2]: https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess
|
1893
1907
|
#
|
1908
|
+
# @option params [String] :task_mode
|
1909
|
+
# Specifies one of the following task modes for your data transfer:
|
1910
|
+
#
|
1911
|
+
# * `ENHANCED` - Transfer virtually unlimited numbers of objects with
|
1912
|
+
# higher performance than Basic mode. Enhanced mode tasks optimize the
|
1913
|
+
# data transfer process by listing, preparing, transferring, and
|
1914
|
+
# verifying data in parallel. Enhanced mode is currently available for
|
1915
|
+
# transfers between Amazon S3 locations.
|
1916
|
+
#
|
1917
|
+
# <note markdown="1"> To create an Enhanced mode task, the IAM role that you use to call
|
1918
|
+
# the `CreateTask` operation must have the
|
1919
|
+
# `iam:CreateServiceLinkedRole` permission.
|
1920
|
+
#
|
1921
|
+
# </note>
|
1922
|
+
#
|
1923
|
+
# * `BASIC` (default) - Transfer files or objects between Amazon Web
|
1924
|
+
# Services storage and all other supported DataSync locations. Basic
|
1925
|
+
# mode tasks are subject to [quotas][1] on the number of files,
|
1926
|
+
# objects, and directories in a dataset. Basic mode sequentially
|
1927
|
+
# prepares, transfers, and verifies data, making it slower than
|
1928
|
+
# Enhanced mode for most workloads.
|
1929
|
+
#
|
1930
|
+
# For more information, see [Understanding task mode differences][2].
|
1931
|
+
#
|
1932
|
+
#
|
1933
|
+
#
|
1934
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html
|
1935
|
+
# [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
|
1936
|
+
#
|
1894
1937
|
# @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1895
1938
|
#
|
1896
1939
|
# * {Types::CreateTaskResponse#task_arn #task_arn} => String
|
@@ -1979,6 +2022,7 @@ module Aws::DataSync
|
|
1979
2022
|
# },
|
1980
2023
|
# },
|
1981
2024
|
# },
|
2025
|
+
# task_mode: "BASIC", # accepts BASIC, ENHANCED
|
1982
2026
|
# })
|
1983
2027
|
#
|
1984
2028
|
# @example Response structure
|
@@ -2960,6 +3004,7 @@ module Aws::DataSync
|
|
2960
3004
|
# * {Types::DescribeTaskResponse#manifest_config #manifest_config} => Types::ManifestConfig
|
2961
3005
|
# * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
|
2962
3006
|
# * {Types::DescribeTaskResponse#schedule_details #schedule_details} => Types::TaskScheduleDetails
|
3007
|
+
# * {Types::DescribeTaskResponse#task_mode #task_mode} => String
|
2963
3008
|
#
|
2964
3009
|
# @example Request syntax with placeholder values
|
2965
3010
|
#
|
@@ -3025,6 +3070,7 @@ module Aws::DataSync
|
|
3025
3070
|
# resp.schedule_details.status_update_time #=> Time
|
3026
3071
|
# resp.schedule_details.disabled_reason #=> String
|
3027
3072
|
# resp.schedule_details.disabled_by #=> String, one of "USER", "SERVICE"
|
3073
|
+
# resp.task_mode #=> String, one of "BASIC", "ENHANCED"
|
3028
3074
|
#
|
3029
3075
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
|
3030
3076
|
#
|
@@ -3036,8 +3082,20 @@ module Aws::DataSync
|
|
3036
3082
|
end
|
3037
3083
|
|
3038
3084
|
# Provides information about an execution of your DataSync task. You can
|
3039
|
-
# use this operation to help monitor the progress of an ongoing
|
3040
|
-
# or check the results of the transfer.
|
3085
|
+
# use this operation to help monitor the progress of an ongoing data
|
3086
|
+
# transfer or check the results of the transfer.
|
3087
|
+
#
|
3088
|
+
# <note markdown="1"> Some `DescribeTaskExecution` response elements are only relevant to a
|
3089
|
+
# specific task mode. For information, see [Understanding task mode
|
3090
|
+
# differences][1] and [Understanding data transfer performance
|
3091
|
+
# counters][2].
|
3092
|
+
#
|
3093
|
+
# </note>
|
3094
|
+
#
|
3095
|
+
#
|
3096
|
+
#
|
3097
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
|
3098
|
+
# [2]: https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html
|
3041
3099
|
#
|
3042
3100
|
# @option params [required, String] :task_execution_arn
|
3043
3101
|
# Specifies the Amazon Resource Name (ARN) of the task execution that
|
@@ -3065,6 +3123,10 @@ module Aws::DataSync
|
|
3065
3123
|
# * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
|
3066
3124
|
# * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
|
3067
3125
|
# * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
|
3126
|
+
# * {Types::DescribeTaskExecutionResponse#task_mode #task_mode} => String
|
3127
|
+
# * {Types::DescribeTaskExecutionResponse#files_prepared #files_prepared} => Integer
|
3128
|
+
# * {Types::DescribeTaskExecutionResponse#files_listed #files_listed} => Types::TaskExecutionFilesListedDetail
|
3129
|
+
# * {Types::DescribeTaskExecutionResponse#files_failed #files_failed} => Types::TaskExecutionFilesFailedDetail
|
3068
3130
|
#
|
3069
3131
|
# @example Request syntax with placeholder values
|
3070
3132
|
#
|
@@ -3136,6 +3198,14 @@ module Aws::DataSync
|
|
3136
3198
|
# resp.report_result.error_code #=> String
|
3137
3199
|
# resp.report_result.error_detail #=> String
|
3138
3200
|
# resp.estimated_files_to_delete #=> Integer
|
3201
|
+
# resp.task_mode #=> String, one of "BASIC", "ENHANCED"
|
3202
|
+
# resp.files_prepared #=> Integer
|
3203
|
+
# resp.files_listed.at_source #=> Integer
|
3204
|
+
# resp.files_listed.at_destination_for_delete #=> Integer
|
3205
|
+
# resp.files_failed.prepare #=> Integer
|
3206
|
+
# resp.files_failed.transfer #=> Integer
|
3207
|
+
# resp.files_failed.verify #=> Integer
|
3208
|
+
# resp.files_failed.delete #=> Integer
|
3139
3209
|
#
|
3140
3210
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
|
3141
3211
|
#
|
@@ -3474,6 +3544,7 @@ module Aws::DataSync
|
|
3474
3544
|
# resp.task_executions #=> Array
|
3475
3545
|
# resp.task_executions[0].task_execution_arn #=> String
|
3476
3546
|
# resp.task_executions[0].status #=> String, one of "QUEUED", "CANCELLING", "LAUNCHING", "PREPARING", "TRANSFERRING", "VERIFYING", "SUCCESS", "ERROR"
|
3547
|
+
# resp.task_executions[0].task_mode #=> String, one of "BASIC", "ENHANCED"
|
3477
3548
|
# resp.next_token #=> String
|
3478
3549
|
#
|
3479
3550
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTaskExecutions AWS API Documentation
|
@@ -3527,6 +3598,7 @@ module Aws::DataSync
|
|
3527
3598
|
# resp.tasks[0].task_arn #=> String
|
3528
3599
|
# resp.tasks[0].status #=> String, one of "AVAILABLE", "CREATING", "QUEUED", "RUNNING", "UNAVAILABLE"
|
3529
3600
|
# resp.tasks[0].name #=> String
|
3601
|
+
# resp.tasks[0].task_mode #=> String, one of "BASIC", "ENHANCED"
|
3530
3602
|
# resp.next_token #=> String
|
3531
3603
|
#
|
3532
3604
|
# @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasks AWS API Documentation
|
@@ -3631,8 +3703,8 @@ module Aws::DataSync
|
|
3631
3703
|
# Starts an DataSync transfer task. For each task, you can only run one
|
3632
3704
|
# task execution at a time.
|
3633
3705
|
#
|
3634
|
-
# There are several
|
3635
|
-
#
|
3706
|
+
# There are several steps to a task execution. For more information, see
|
3707
|
+
# [Task execution statuses][1].
|
3636
3708
|
#
|
3637
3709
|
# If you're planning to transfer data to or from an Amazon S3 location,
|
3638
3710
|
# review [how DataSync can affect your S3 request charges][2] and the
|
@@ -4100,7 +4172,8 @@ module Aws::DataSync
|
|
4100
4172
|
# encoding for you. Otherwise, provide the base64-encoded text.
|
4101
4173
|
#
|
4102
4174
|
# @option params [Array<String>] :agent_arns
|
4103
|
-
# The ARNs of the agents that
|
4175
|
+
# The Amazon Resource Names (ARNs) of the DataSync agents that can
|
4176
|
+
# connect to your HDFS cluster.
|
4104
4177
|
#
|
4105
4178
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4106
4179
|
#
|
@@ -4166,8 +4239,8 @@ module Aws::DataSync
|
|
4166
4239
|
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
|
4167
4240
|
#
|
4168
4241
|
# @option params [Types::OnPremConfig] :on_prem_config
|
4169
|
-
# The DataSync agents that
|
4170
|
-
#
|
4242
|
+
# The DataSync agents that can connect to your Network File System (NFS)
|
4243
|
+
# file server.
|
4171
4244
|
#
|
4172
4245
|
# @option params [Types::NfsMountOptions] :mount_options
|
4173
4246
|
# Specifies how DataSync can access a location using the NFS protocol.
|
@@ -4227,7 +4300,7 @@ module Aws::DataSync
|
|
4227
4300
|
#
|
4228
4301
|
# @option params [Array<String>] :agent_arns
|
4229
4302
|
# Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
|
4230
|
-
# can
|
4303
|
+
# can connect with your object storage system.
|
4231
4304
|
#
|
4232
4305
|
# @option params [String, StringIO, File] :server_certificate
|
4233
4306
|
# Specifies a certificate chain for DataSync to authenticate with your
|
@@ -4337,9 +4410,9 @@ module Aws::DataSync
|
|
4337
4410
|
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
|
4338
4411
|
#
|
4339
4412
|
# @option params [Array<String>] :agent_arns
|
4340
|
-
# Specifies the DataSync agent (or agents)
|
4341
|
-
#
|
4342
|
-
#
|
4413
|
+
# Specifies the DataSync agent (or agents) that can connect to your SMB
|
4414
|
+
# file server. You specify an agent by using its Amazon Resource Name
|
4415
|
+
# (ARN).
|
4343
4416
|
#
|
4344
4417
|
# @option params [Types::SmbMountOptions] :mount_options
|
4345
4418
|
# Specifies the version of the Server Message Block (SMB) protocol that
|
@@ -4473,6 +4546,18 @@ module Aws::DataSync
|
|
4473
4546
|
# Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
|
4474
4547
|
# group for monitoring your task.
|
4475
4548
|
#
|
4549
|
+
# For Enhanced mode tasks, you must use `/aws/datasync` as your log
|
4550
|
+
# group name. For example:
|
4551
|
+
#
|
4552
|
+
# `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`
|
4553
|
+
#
|
4554
|
+
# For more information, see [Monitoring data transfers with CloudWatch
|
4555
|
+
# Logs][1].
|
4556
|
+
#
|
4557
|
+
#
|
4558
|
+
#
|
4559
|
+
# [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html
|
4560
|
+
#
|
4476
4561
|
# @option params [Array<Types::FilterRule>] :includes
|
4477
4562
|
# Specifies include filters define the files, objects, and folders in
|
4478
4563
|
# your source location that you want DataSync to transfer. For more
|
@@ -4689,7 +4774,7 @@ module Aws::DataSync
|
|
4689
4774
|
tracer: tracer
|
4690
4775
|
)
|
4691
4776
|
context[:gem_name] = 'aws-sdk-datasync'
|
4692
|
-
context[:gem_version] = '1.
|
4777
|
+
context[:gem_version] = '1.92.0'
|
4693
4778
|
Seahorse::Client::Request.new(handlers, context)
|
4694
4779
|
end
|
4695
4780
|
|
@@ -303,6 +303,8 @@ module Aws::DataSync
|
|
303
303
|
TaggableResourceArn = Shapes::StringShape.new(name: 'TaggableResourceArn')
|
304
304
|
TaskArn = Shapes::StringShape.new(name: 'TaskArn')
|
305
305
|
TaskExecutionArn = Shapes::StringShape.new(name: 'TaskExecutionArn')
|
306
|
+
TaskExecutionFilesFailedDetail = Shapes::StructureShape.new(name: 'TaskExecutionFilesFailedDetail')
|
307
|
+
TaskExecutionFilesListedDetail = Shapes::StructureShape.new(name: 'TaskExecutionFilesListedDetail')
|
306
308
|
TaskExecutionList = Shapes::ListShape.new(name: 'TaskExecutionList')
|
307
309
|
TaskExecutionListEntry = Shapes::StructureShape.new(name: 'TaskExecutionListEntry')
|
308
310
|
TaskExecutionResultDetail = Shapes::StructureShape.new(name: 'TaskExecutionResultDetail')
|
@@ -312,6 +314,7 @@ module Aws::DataSync
|
|
312
314
|
TaskFilters = Shapes::ListShape.new(name: 'TaskFilters')
|
313
315
|
TaskList = Shapes::ListShape.new(name: 'TaskList')
|
314
316
|
TaskListEntry = Shapes::StructureShape.new(name: 'TaskListEntry')
|
317
|
+
TaskMode = Shapes::StringShape.new(name: 'TaskMode')
|
315
318
|
TaskQueueing = Shapes::StringShape.new(name: 'TaskQueueing')
|
316
319
|
TaskReportConfig = Shapes::StructureShape.new(name: 'TaskReportConfig')
|
317
320
|
TaskSchedule = Shapes::StructureShape.new(name: 'TaskSchedule')
|
@@ -541,6 +544,7 @@ module Aws::DataSync
|
|
541
544
|
CreateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
|
542
545
|
CreateTaskRequest.add_member(:manifest_config, Shapes::ShapeRef.new(shape: ManifestConfig, location_name: "ManifestConfig"))
|
543
546
|
CreateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
|
547
|
+
CreateTaskRequest.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
|
544
548
|
CreateTaskRequest.struct_class = Types::CreateTaskRequest
|
545
549
|
|
546
550
|
CreateTaskResponse.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
|
@@ -781,6 +785,10 @@ module Aws::DataSync
|
|
781
785
|
DescribeTaskExecutionResponse.add_member(:files_verified, Shapes::ShapeRef.new(shape: long, location_name: "FilesVerified"))
|
782
786
|
DescribeTaskExecutionResponse.add_member(:report_result, Shapes::ShapeRef.new(shape: ReportResult, location_name: "ReportResult"))
|
783
787
|
DescribeTaskExecutionResponse.add_member(:estimated_files_to_delete, Shapes::ShapeRef.new(shape: long, location_name: "EstimatedFilesToDelete"))
|
788
|
+
DescribeTaskExecutionResponse.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
|
789
|
+
DescribeTaskExecutionResponse.add_member(:files_prepared, Shapes::ShapeRef.new(shape: long, location_name: "FilesPrepared"))
|
790
|
+
DescribeTaskExecutionResponse.add_member(:files_listed, Shapes::ShapeRef.new(shape: TaskExecutionFilesListedDetail, location_name: "FilesListed"))
|
791
|
+
DescribeTaskExecutionResponse.add_member(:files_failed, Shapes::ShapeRef.new(shape: TaskExecutionFilesFailedDetail, location_name: "FilesFailed"))
|
784
792
|
DescribeTaskExecutionResponse.struct_class = Types::DescribeTaskExecutionResponse
|
785
793
|
|
786
794
|
DescribeTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
|
@@ -805,6 +813,7 @@ module Aws::DataSync
|
|
805
813
|
DescribeTaskResponse.add_member(:manifest_config, Shapes::ShapeRef.new(shape: ManifestConfig, location_name: "ManifestConfig"))
|
806
814
|
DescribeTaskResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
|
807
815
|
DescribeTaskResponse.add_member(:schedule_details, Shapes::ShapeRef.new(shape: TaskScheduleDetails, location_name: "ScheduleDetails"))
|
816
|
+
DescribeTaskResponse.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
|
808
817
|
DescribeTaskResponse.struct_class = Types::DescribeTaskResponse
|
809
818
|
|
810
819
|
DestinationNetworkInterfaceArns.member = Shapes::ShapeRef.new(shape: NetworkInterfaceArn)
|
@@ -1196,10 +1205,21 @@ module Aws::DataSync
|
|
1196
1205
|
|
1197
1206
|
TagResourceResponse.struct_class = Types::TagResourceResponse
|
1198
1207
|
|
1208
|
+
TaskExecutionFilesFailedDetail.add_member(:prepare, Shapes::ShapeRef.new(shape: long, location_name: "Prepare"))
|
1209
|
+
TaskExecutionFilesFailedDetail.add_member(:transfer, Shapes::ShapeRef.new(shape: long, location_name: "Transfer"))
|
1210
|
+
TaskExecutionFilesFailedDetail.add_member(:verify, Shapes::ShapeRef.new(shape: long, location_name: "Verify"))
|
1211
|
+
TaskExecutionFilesFailedDetail.add_member(:delete, Shapes::ShapeRef.new(shape: long, location_name: "Delete"))
|
1212
|
+
TaskExecutionFilesFailedDetail.struct_class = Types::TaskExecutionFilesFailedDetail
|
1213
|
+
|
1214
|
+
TaskExecutionFilesListedDetail.add_member(:at_source, Shapes::ShapeRef.new(shape: long, location_name: "AtSource"))
|
1215
|
+
TaskExecutionFilesListedDetail.add_member(:at_destination_for_delete, Shapes::ShapeRef.new(shape: long, location_name: "AtDestinationForDelete"))
|
1216
|
+
TaskExecutionFilesListedDetail.struct_class = Types::TaskExecutionFilesListedDetail
|
1217
|
+
|
1199
1218
|
TaskExecutionList.member = Shapes::ShapeRef.new(shape: TaskExecutionListEntry)
|
1200
1219
|
|
1201
1220
|
TaskExecutionListEntry.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, location_name: "TaskExecutionArn"))
|
1202
1221
|
TaskExecutionListEntry.add_member(:status, Shapes::ShapeRef.new(shape: TaskExecutionStatus, location_name: "Status"))
|
1222
|
+
TaskExecutionListEntry.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
|
1203
1223
|
TaskExecutionListEntry.struct_class = Types::TaskExecutionListEntry
|
1204
1224
|
|
1205
1225
|
TaskExecutionResultDetail.add_member(:prepare_duration, Shapes::ShapeRef.new(shape: Duration, location_name: "PrepareDuration"))
|
@@ -1225,6 +1245,7 @@ module Aws::DataSync
|
|
1225
1245
|
TaskListEntry.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
|
1226
1246
|
TaskListEntry.add_member(:status, Shapes::ShapeRef.new(shape: TaskStatus, location_name: "Status"))
|
1227
1247
|
TaskListEntry.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
|
1248
|
+
TaskListEntry.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
|
1228
1249
|
TaskListEntry.struct_class = Types::TaskListEntry
|
1229
1250
|
|
1230
1251
|
TaskReportConfig.add_member(:destination, Shapes::ShapeRef.new(shape: ReportDestination, location_name: "Destination"))
|