aws-sdk-datasync 1.89.0 → 1.91.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d528999d031a98263a0bb50d7c568372bbffdcf5fd0c6c12c818c9147f43ad42
4
- data.tar.gz: 7f8f14e1a4b0617dae58667c1836a3a5a6d867bdcbd6be6fa117fc6e895cb1fa
3
+ metadata.gz: 4f52da70388bbdf592a076569d8bac4f40894acd060e82e88403cf0182d71379
4
+ data.tar.gz: e0abaeb28e29d9c74cbc8514e911f17c5c80cc9bdf66ca866b06cc52b1324a23
5
5
  SHA512:
6
- metadata.gz: 85c97f61dbe55407325e98425b06addcc49940eed2416e00a4329a0794bb2fb7580cb675fbaddc99fd055f0d858d6db160afbb259f7e2b9282ba6d803e3d4831
7
- data.tar.gz: ca35918d1df48536e132b4ecd52ec42514dea0d60e2f30006448831f1fa1957040d76a239689b510ca2fd39ffa78ea8ea695acf528762a3a05ed4e5f953f1095
6
+ metadata.gz: 175c5310661e049abf14967f2b0ecd097336116d0fcafbcccbd3470d0e4feb2cf0ac204a9457f4d6219a809954c725e6f1fbfed480fe34b2e9c2435b88104a0d
7
+ data.tar.gz: c2ec87a21ed6890744e3a87da665b2ba26a502769477192e9ed95a91dd661cfae9b5f32ef9e10aea4877863aa6292893e3e10a8f74e1ca18ca0fd2416d05bea6
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.91.0 (2024-10-30)
5
+ ------------------
6
+
7
+ * 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.
8
+
9
+ 1.90.0 (2024-10-18)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.89.0 (2024-09-24)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.89.0
1
+ 1.91.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've deployed in your storage
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 the following topics to
580
- # learn more:
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
- # <note markdown="1"> If you're transferring between Amazon Web Services storage services,
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 [Activate your agent][1].
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. You can see this name in the DataSync
606
- # console.
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 want your agent to
615
- # connect to. For example, a VPC endpoint ID looks like
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 name (for
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
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
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
- # protects your task's [network interfaces][1] when [using a virtual
634
- # private cloud (VPC) endpoint][2]. You can only specify one ARN.
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). By default, DataSync uses the root directory,
794
- # but you can also include subdirectories.
775
+ # destination location) on your file system.
795
776
  #
796
- # <note markdown="1"> You must specify a value with forward slashes (for example,
797
- # `/path/to/folder`).
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
- # </note>
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 the Amazon EFS file system.
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 access your
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 access the Amazon EFS file system.
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 DataSync
820
- # assumes when mounting the Amazon EFS file system.
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 copies data to or from the Amazon EFS
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 access to your
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 are used to
1303
- # connect to the HDFS cluster.
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
- # want to connect to your NFS file server.
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 for transfers][1].
1407
+ # multiple DataSync agents][1].
1398
1408
  #
1399
1409
  #
1400
1410
  #
1401
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
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 securely connect with your location.
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) which you want to connect to
1749
- # your SMB file server. You specify an agent by using its Amazon
1750
- # Resource Name (ARN).
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 in
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,31 @@ 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
+ # enhanced metrics, more detailed logs, and higher performance than
1913
+ # Basic mode. Currently available for transfers between Amazon S3
1914
+ # locations.
1915
+ #
1916
+ # <note markdown="1"> To create an Enhanced mode task, the IAM role that you use to call
1917
+ # the `CreateTask` operation must have the
1918
+ # `iam:CreateServiceLinkedRole` permission.
1919
+ #
1920
+ # </note>
1921
+ #
1922
+ # * `BASIC` (default) - Transfer files or objects between Amazon Web
1923
+ # Services storage and on-premises, edge, or other cloud storage.
1924
+ # DataSync [quotas][1] apply.
1925
+ #
1926
+ # For more information, see [Understanding task mode differences][2].
1927
+ #
1928
+ #
1929
+ #
1930
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html
1931
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
1932
+ #
1894
1933
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1895
1934
  #
1896
1935
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1979,6 +2018,7 @@ module Aws::DataSync
1979
2018
  # },
1980
2019
  # },
1981
2020
  # },
2021
+ # task_mode: "BASIC", # accepts BASIC, ENHANCED
1982
2022
  # })
1983
2023
  #
1984
2024
  # @example Response structure
@@ -2960,6 +3000,7 @@ module Aws::DataSync
2960
3000
  # * {Types::DescribeTaskResponse#manifest_config #manifest_config} => Types::ManifestConfig
2961
3001
  # * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2962
3002
  # * {Types::DescribeTaskResponse#schedule_details #schedule_details} => Types::TaskScheduleDetails
3003
+ # * {Types::DescribeTaskResponse#task_mode #task_mode} => String
2963
3004
  #
2964
3005
  # @example Request syntax with placeholder values
2965
3006
  #
@@ -3025,6 +3066,7 @@ module Aws::DataSync
3025
3066
  # resp.schedule_details.status_update_time #=> Time
3026
3067
  # resp.schedule_details.disabled_reason #=> String
3027
3068
  # resp.schedule_details.disabled_by #=> String, one of "USER", "SERVICE"
3069
+ # resp.task_mode #=> String, one of "BASIC", "ENHANCED"
3028
3070
  #
3029
3071
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
3030
3072
  #
@@ -3036,8 +3078,20 @@ module Aws::DataSync
3036
3078
  end
3037
3079
 
3038
3080
  # Provides information about an execution of your DataSync task. You can
3039
- # use this operation to help monitor the progress of an ongoing transfer
3040
- # or check the results of the transfer.
3081
+ # use this operation to help monitor the progress of an ongoing data
3082
+ # transfer or check the results of the transfer.
3083
+ #
3084
+ # <note markdown="1"> Some `DescribeTaskExecution` response elements are only relevant to a
3085
+ # specific task mode. For information, see [Understanding task mode
3086
+ # differences][1] and [Understanding data transfer performance
3087
+ # metrics][2].
3088
+ #
3089
+ # </note>
3090
+ #
3091
+ #
3092
+ #
3093
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
3094
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-metrics.html
3041
3095
  #
3042
3096
  # @option params [required, String] :task_execution_arn
3043
3097
  # Specifies the Amazon Resource Name (ARN) of the task execution that
@@ -3065,6 +3119,10 @@ module Aws::DataSync
3065
3119
  # * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
3066
3120
  # * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
3067
3121
  # * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
3122
+ # * {Types::DescribeTaskExecutionResponse#task_mode #task_mode} => String
3123
+ # * {Types::DescribeTaskExecutionResponse#files_prepared #files_prepared} => Integer
3124
+ # * {Types::DescribeTaskExecutionResponse#files_listed #files_listed} => Types::TaskExecutionFilesListedDetail
3125
+ # * {Types::DescribeTaskExecutionResponse#files_failed #files_failed} => Types::TaskExecutionFilesFailedDetail
3068
3126
  #
3069
3127
  # @example Request syntax with placeholder values
3070
3128
  #
@@ -3136,6 +3194,14 @@ module Aws::DataSync
3136
3194
  # resp.report_result.error_code #=> String
3137
3195
  # resp.report_result.error_detail #=> String
3138
3196
  # resp.estimated_files_to_delete #=> Integer
3197
+ # resp.task_mode #=> String, one of "BASIC", "ENHANCED"
3198
+ # resp.files_prepared #=> Integer
3199
+ # resp.files_listed.at_source #=> Integer
3200
+ # resp.files_listed.at_destination_for_delete #=> Integer
3201
+ # resp.files_failed.prepare #=> Integer
3202
+ # resp.files_failed.transfer #=> Integer
3203
+ # resp.files_failed.verify #=> Integer
3204
+ # resp.files_failed.delete #=> Integer
3139
3205
  #
3140
3206
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
3141
3207
  #
@@ -3474,6 +3540,7 @@ module Aws::DataSync
3474
3540
  # resp.task_executions #=> Array
3475
3541
  # resp.task_executions[0].task_execution_arn #=> String
3476
3542
  # resp.task_executions[0].status #=> String, one of "QUEUED", "CANCELLING", "LAUNCHING", "PREPARING", "TRANSFERRING", "VERIFYING", "SUCCESS", "ERROR"
3543
+ # resp.task_executions[0].task_mode #=> String, one of "BASIC", "ENHANCED"
3477
3544
  # resp.next_token #=> String
3478
3545
  #
3479
3546
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTaskExecutions AWS API Documentation
@@ -3527,6 +3594,7 @@ module Aws::DataSync
3527
3594
  # resp.tasks[0].task_arn #=> String
3528
3595
  # resp.tasks[0].status #=> String, one of "AVAILABLE", "CREATING", "QUEUED", "RUNNING", "UNAVAILABLE"
3529
3596
  # resp.tasks[0].name #=> String
3597
+ # resp.tasks[0].task_mode #=> String, one of "BASIC", "ENHANCED"
3530
3598
  # resp.next_token #=> String
3531
3599
  #
3532
3600
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasks AWS API Documentation
@@ -3631,8 +3699,8 @@ module Aws::DataSync
3631
3699
  # Starts an DataSync transfer task. For each task, you can only run one
3632
3700
  # task execution at a time.
3633
3701
  #
3634
- # There are several phases to a task execution. For more information,
3635
- # see [Task execution statuses][1].
3702
+ # There are several steps to a task execution. For more information, see
3703
+ # [Task execution statuses][1].
3636
3704
  #
3637
3705
  # If you're planning to transfer data to or from an Amazon S3 location,
3638
3706
  # review [how DataSync can affect your S3 request charges][2] and the
@@ -4100,7 +4168,8 @@ module Aws::DataSync
4100
4168
  # encoding for you. Otherwise, provide the base64-encoded text.
4101
4169
  #
4102
4170
  # @option params [Array<String>] :agent_arns
4103
- # The ARNs of the agents that are used to connect to the HDFS cluster.
4171
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
4172
+ # connect to your HDFS cluster.
4104
4173
  #
4105
4174
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4106
4175
  #
@@ -4166,8 +4235,8 @@ module Aws::DataSync
4166
4235
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
4167
4236
  #
4168
4237
  # @option params [Types::OnPremConfig] :on_prem_config
4169
- # The DataSync agents that are connecting to a Network File System (NFS)
4170
- # location.
4238
+ # The DataSync agents that can connect to your Network File System (NFS)
4239
+ # file server.
4171
4240
  #
4172
4241
  # @option params [Types::NfsMountOptions] :mount_options
4173
4242
  # Specifies how DataSync can access a location using the NFS protocol.
@@ -4227,7 +4296,7 @@ module Aws::DataSync
4227
4296
  #
4228
4297
  # @option params [Array<String>] :agent_arns
4229
4298
  # Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
4230
- # can securely connect with your location.
4299
+ # can connect with your object storage system.
4231
4300
  #
4232
4301
  # @option params [String, StringIO, File] :server_certificate
4233
4302
  # Specifies a certificate chain for DataSync to authenticate with your
@@ -4337,9 +4406,9 @@ module Aws::DataSync
4337
4406
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
4338
4407
  #
4339
4408
  # @option params [Array<String>] :agent_arns
4340
- # Specifies the DataSync agent (or agents) which you want to connect to
4341
- # your SMB file server. You specify an agent by using its Amazon
4342
- # Resource Name (ARN).
4409
+ # Specifies the DataSync agent (or agents) that can connect to your SMB
4410
+ # file server. You specify an agent by using its Amazon Resource Name
4411
+ # (ARN).
4343
4412
  #
4344
4413
  # @option params [Types::SmbMountOptions] :mount_options
4345
4414
  # Specifies the version of the Server Message Block (SMB) protocol that
@@ -4473,6 +4542,18 @@ module Aws::DataSync
4473
4542
  # Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
4474
4543
  # group for monitoring your task.
4475
4544
  #
4545
+ # For Enhanced mode tasks, you must use `/aws/datasync` as your log
4546
+ # group name. For example:
4547
+ #
4548
+ # `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`
4549
+ #
4550
+ # For more information, see [Monitoring data transfers with CloudWatch
4551
+ # Logs][1].
4552
+ #
4553
+ #
4554
+ #
4555
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html
4556
+ #
4476
4557
  # @option params [Array<Types::FilterRule>] :includes
4477
4558
  # Specifies include filters define the files, objects, and folders in
4478
4559
  # your source location that you want DataSync to transfer. For more
@@ -4689,7 +4770,7 @@ module Aws::DataSync
4689
4770
  tracer: tracer
4690
4771
  )
4691
4772
  context[:gem_name] = 'aws-sdk-datasync'
4692
- context[:gem_version] = '1.89.0'
4773
+ context[:gem_version] = '1.91.0'
4693
4774
  Seahorse::Client::Request.new(handlers, context)
4694
4775
  end
4695
4776
 
@@ -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"))
@@ -52,15 +52,18 @@ module Aws::DataSync
52
52
  self[:region] = options[:region]
53
53
  self[:use_dual_stack] = options[:use_dual_stack]
54
54
  self[:use_dual_stack] = false if self[:use_dual_stack].nil?
55
- if self[:use_dual_stack].nil?
56
- raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
57
- end
58
55
  self[:use_fips] = options[:use_fips]
59
56
  self[:use_fips] = false if self[:use_fips].nil?
60
- if self[:use_fips].nil?
61
- raise ArgumentError, "Missing required EndpointParameter: :use_fips"
62
- end
63
57
  self[:endpoint] = options[:endpoint]
64
58
  end
59
+
60
+ def self.create(config, options={})
61
+ new({
62
+ region: config.region,
63
+ use_dual_stack: config.use_dualstack_endpoint,
64
+ use_fips: config.use_fips_endpoint,
65
+ endpoint: (config.endpoint.to_s unless config.regional_endpoint),
66
+ }.merge(options))
67
+ end
65
68
  end
66
69
  end