aws-sdk-datasync 1.63.0 → 1.65.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: 47476be9fe777713cef4cad10751a5312eeb8f190d6a891725b2cdd3de389e73
4
- data.tar.gz: b6e169c01a64492b9de1195331b622d4fcf81f7a6a4d83ae4a1d01ecbcb9e355
3
+ metadata.gz: 6f9f352fa22503339a8961f2b68bde03a8843a13fe70c4b256ca106a8f8bb1d0
4
+ data.tar.gz: a43bb69777e189bccb2ef2acfb0dbad028eb943c78178637554e1f44d0be2114
5
5
  SHA512:
6
- metadata.gz: b18e962f3747cbf94befe830cf6d088556880455e3bc81e790275e33c103b52d1ea07385382aa7062d34fd504be5b9fc766f5c4e0fc7ffe8285f105e5e547140
7
- data.tar.gz: e75ffea5c597baef2c3330e290caf49c794b7dec1815d700bdb5f97aae875542275ae728fb152a317b42470bba3c59585a4fa7d617713bd8e5b61d2846fe2c9e
6
+ metadata.gz: 928cbf6fe41e7079cd258a776890226a572f7542dbe9b46ede9e1a47ce17b0e493bcb33e800fb5dadb4f6603f157b47d4f4b9af819a297afbbdeac403ce8e838
7
+ data.tar.gz: a3f02df725fce3d709ba9dbfe86923d79151a92ede7186c10c5ebf75a8c345dfc05f9353271c691f014a370407c0e2d3c38f742bf0ae4e895be9d8ba1e3a3271
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.65.0 (2023-08-30)
5
+ ------------------
6
+
7
+ * Feature - AWS DataSync introduces Task Reports, a new feature that provides detailed reports of data transfer operations for each task execution.
8
+
9
+ 1.64.0 (2023-08-04)
10
+ ------------------
11
+
12
+ * Feature - Display cloud storage used capacity at a cluster level.
13
+
4
14
  1.63.0 (2023-07-25)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.63.0
1
+ 1.65.0
@@ -1256,67 +1256,53 @@ module Aws::DataSync
1256
1256
  req.send_request(options)
1257
1257
  end
1258
1258
 
1259
- # Creates an endpoint for an Network File System (NFS) file server that
1259
+ # Creates an endpoint for a Network File System (NFS) file server that
1260
1260
  # DataSync can use for a data transfer.
1261
1261
  #
1262
- # @option params [required, String] :subdirectory
1263
- # Specifies the subdirectory in the NFS file server that DataSync
1264
- # transfers to or from. The NFS path should be a path that's exported
1265
- # by the NFS server, or a subdirectory of that path. The path should be
1266
- # such that it can be mounted by other NFS clients in your network.
1267
- #
1268
- # To see all the paths exported by your NFS server, run "`showmount -e
1269
- # nfs-server-name`" from an NFS client that has access to your server.
1270
- # You can specify any directory that appears in the results, and any
1271
- # subdirectory of that directory. Ensure that the NFS export is
1272
- # accessible without Kerberos authentication.
1273
- #
1274
- # To transfer all the data in the folder you specified, DataSync needs
1275
- # to have permissions to read all the data. To ensure this, either
1276
- # configure the NFS export with `no_root_squash,` or ensure that the
1277
- # permissions for all of the files that you want DataSync allow read
1278
- # access for all users. Doing either enables the agent to read the
1279
- # files. For the agent to access directories, you must additionally
1280
- # enable all execute access.
1262
+ # For more information, see [Configuring transfers to or from an NFS
1263
+ # file server][1].
1281
1264
  #
1282
- # If you are copying data to or from your Snowcone device, see [NFS
1283
- # Server on Snowcone][1] for more information.
1265
+ # <note markdown="1"> If you're copying data to or from an Snowcone device, you can also
1266
+ # use `CreateLocationNfs` to create your transfer location. For more
1267
+ # information, see [Configuring transfers with Snowcone][2].
1284
1268
  #
1269
+ # </note>
1285
1270
  #
1286
1271
  #
1287
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
1288
1272
  #
1289
- # @option params [required, String] :server_hostname
1290
- # Specifies the IP address or domain name of your NFS file server. An
1291
- # agent that is installed on-premises uses this hostname to mount the
1292
- # NFS server in a network.
1273
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
1274
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/nfs-on-snowcone.html
1293
1275
  #
1294
- # If you are copying data to or from your Snowcone device, see [NFS
1295
- # Server on Snowcone][1] for more information.
1276
+ # @option params [required, String] :subdirectory
1277
+ # Specifies the export path in your NFS file server that you want
1278
+ # DataSync to mount.
1296
1279
  #
1297
- # <note markdown="1"> You must specify be an IP version 4 address or Domain Name System
1298
- # (DNS)-compliant name.
1280
+ # This path (or a subdirectory of the path) is where DataSync transfers
1281
+ # data to or from. For information on configuring an export for
1282
+ # DataSync, see [Accessing NFS file servers][1].
1299
1283
  #
1300
- # </note>
1301
1284
  #
1302
1285
  #
1286
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
1303
1287
  #
1304
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
1288
+ # @option params [required, String] :server_hostname
1289
+ # Specifies the Domain Name System (DNS) name or IP version 4 address of
1290
+ # the NFS file server that your DataSync agent connects to.
1305
1291
  #
1306
1292
  # @option params [required, Types::OnPremConfig] :on_prem_config
1307
- # Specifies the Amazon Resource Names (ARNs) of agents that DataSync
1308
- # uses to connect to your NFS file server.
1293
+ # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
1294
+ # want to connect to your NFS file server.
1309
1295
  #
1310
- # If you are copying data to or from your Snowcone device, see [NFS
1311
- # Server on Snowcone][1] for more information.
1296
+ # You can specify more than one agent. For more information, see [Using
1297
+ # multiple agents for transfers][1].
1312
1298
  #
1313
1299
  #
1314
1300
  #
1315
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
1301
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
1316
1302
  #
1317
1303
  # @option params [Types::NfsMountOptions] :mount_options
1318
- # Specifies the mount options that DataSync can use to mount your NFS
1319
- # share.
1304
+ # Specifies the options that DataSync can use to mount your NFS file
1305
+ # server.
1320
1306
  #
1321
1307
  # @option params [Array<Types::TagListEntry>] :tags
1322
1308
  # Specifies labels that help you categorize, filter, and search for your
@@ -1679,11 +1665,11 @@ module Aws::DataSync
1679
1665
  req.send_request(options)
1680
1666
  end
1681
1667
 
1682
- # Configures a task, which defines where and how DataSync transfers your
1683
- # data.
1668
+ # Configures a transfer task, which defines where and how DataSync moves
1669
+ # your data.
1684
1670
  #
1685
- # A task includes a source location, a destination location, and the
1686
- # preferences for how and when you want to transfer your data (such as
1671
+ # A task includes a source location, destination location, and the
1672
+ # options for how and when you want to transfer your data (such as
1687
1673
  # bandwidth limits, scheduling, among other options).
1688
1674
  #
1689
1675
  # If you're planning to transfer data to or from an Amazon S3 location,
@@ -1756,6 +1742,10 @@ module Aws::DataSync
1756
1742
  #
1757
1743
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
1758
1744
  #
1745
+ # @option params [Types::TaskReportConfig] :task_report_config
1746
+ # Specifies how you want to configure a task report, which provides
1747
+ # detailed information about for your DataSync transfer.
1748
+ #
1759
1749
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1760
1750
  #
1761
1751
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1805,6 +1795,32 @@ module Aws::DataSync
1805
1795
  # value: "FilterValue",
1806
1796
  # },
1807
1797
  # ],
1798
+ # task_report_config: {
1799
+ # destination: {
1800
+ # s3: {
1801
+ # subdirectory: "S3Subdirectory",
1802
+ # s3_bucket_arn: "S3BucketArn", # required
1803
+ # bucket_access_role_arn: "IamRoleArn", # required
1804
+ # },
1805
+ # },
1806
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
1807
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1808
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
1809
+ # overrides: {
1810
+ # transferred: {
1811
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1812
+ # },
1813
+ # verified: {
1814
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1815
+ # },
1816
+ # deleted: {
1817
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1818
+ # },
1819
+ # skipped: {
1820
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1821
+ # },
1822
+ # },
1823
+ # },
1808
1824
  # })
1809
1825
  #
1810
1826
  # @example Response structure
@@ -1870,7 +1886,7 @@ module Aws::DataSync
1870
1886
  req.send_request(options)
1871
1887
  end
1872
1888
 
1873
- # Deletes an DataSync task.
1889
+ # Deletes an DataSync transfer task.
1874
1890
  #
1875
1891
  # @option params [required, String] :task_arn
1876
1892
  # Specifies the Amazon Resource Name (ARN) of the task that you want to
@@ -2300,10 +2316,12 @@ module Aws::DataSync
2300
2316
  req.send_request(options)
2301
2317
  end
2302
2318
 
2303
- # Returns metadata, such as the path information, about an NFS location.
2319
+ # Provides details about how an DataSync transfer location for a Network
2320
+ # File System (NFS) file server is configured.
2304
2321
  #
2305
2322
  # @option params [required, String] :location_arn
2306
- # The Amazon Resource Name (ARN) of the NFS location to describe.
2323
+ # Specifies the Amazon Resource Name (ARN) of the NFS location that you
2324
+ # want information about.
2307
2325
  #
2308
2326
  # @return [Types::DescribeLocationNfsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2309
2327
  #
@@ -2585,6 +2603,7 @@ module Aws::DataSync
2585
2603
  # resp.metrics[0].capacity.used #=> Integer
2586
2604
  # resp.metrics[0].capacity.provisioned #=> Integer
2587
2605
  # resp.metrics[0].capacity.logical_used #=> Integer
2606
+ # resp.metrics[0].capacity.cluster_cloud_storage_used #=> Integer
2588
2607
  # resp.metrics[0].resource_id #=> String
2589
2608
  # resp.metrics[0].resource_type #=> String, one of "SVM", "VOLUME", "CLUSTER"
2590
2609
  # resp.next_token #=> String
@@ -2735,6 +2754,7 @@ module Aws::DataSync
2735
2754
  # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].estimated_monthly_storage_cost #=> String
2736
2755
  # resp.resource_details.net_app_ontap_clusters[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
2737
2756
  # resp.resource_details.net_app_ontap_clusters[0].lun_count #=> Integer
2757
+ # resp.resource_details.net_app_ontap_clusters[0].cluster_cloud_storage_used #=> Integer
2738
2758
  # resp.next_token #=> String
2739
2759
  #
2740
2760
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResources AWS API Documentation
@@ -2769,6 +2789,7 @@ module Aws::DataSync
2769
2789
  # * {Types::DescribeTaskResponse#error_detail #error_detail} => String
2770
2790
  # * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
2771
2791
  # * {Types::DescribeTaskResponse#includes #includes} => Array&lt;Types::FilterRule&gt;
2792
+ # * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2772
2793
  #
2773
2794
  # @example Request syntax with placeholder values
2774
2795
  #
@@ -2814,6 +2835,16 @@ module Aws::DataSync
2814
2835
  # resp.includes #=> Array
2815
2836
  # resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
2816
2837
  # resp.includes[0].value #=> String
2838
+ # resp.task_report_config.destination.s3.subdirectory #=> String
2839
+ # resp.task_report_config.destination.s3.s3_bucket_arn #=> String
2840
+ # resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
2841
+ # resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
2842
+ # resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2843
+ # resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
2844
+ # resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2845
+ # resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2846
+ # resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2847
+ # resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2817
2848
  #
2818
2849
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
2819
2850
  #
@@ -2824,11 +2855,13 @@ module Aws::DataSync
2824
2855
  req.send_request(options)
2825
2856
  end
2826
2857
 
2827
- # Provides information about an DataSync transfer task that's running.
2858
+ # Provides information about an execution of your DataSync task. You can
2859
+ # use this operation to help monitor the progress of an ongoing transfer
2860
+ # or check the results of the transfer.
2828
2861
  #
2829
2862
  # @option params [required, String] :task_execution_arn
2830
- # Specifies the Amazon Resource Name (ARN) of the transfer task that's
2831
- # running.
2863
+ # Specifies the Amazon Resource Name (ARN) of the task execution that
2864
+ # you want information about.
2832
2865
  #
2833
2866
  # @return [Types::DescribeTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2834
2867
  #
@@ -2845,6 +2878,12 @@ module Aws::DataSync
2845
2878
  # * {Types::DescribeTaskExecutionResponse#bytes_transferred #bytes_transferred} => Integer
2846
2879
  # * {Types::DescribeTaskExecutionResponse#result #result} => Types::TaskExecutionResultDetail
2847
2880
  # * {Types::DescribeTaskExecutionResponse#bytes_compressed #bytes_compressed} => Integer
2881
+ # * {Types::DescribeTaskExecutionResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2882
+ # * {Types::DescribeTaskExecutionResponse#files_deleted #files_deleted} => Integer
2883
+ # * {Types::DescribeTaskExecutionResponse#files_skipped #files_skipped} => Integer
2884
+ # * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
2885
+ # * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
2886
+ # * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
2848
2887
  #
2849
2888
  # @example Request syntax with placeholder values
2850
2889
  #
@@ -2893,6 +2932,23 @@ module Aws::DataSync
2893
2932
  # resp.result.error_code #=> String
2894
2933
  # resp.result.error_detail #=> String
2895
2934
  # resp.bytes_compressed #=> Integer
2935
+ # resp.task_report_config.destination.s3.subdirectory #=> String
2936
+ # resp.task_report_config.destination.s3.s3_bucket_arn #=> String
2937
+ # resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
2938
+ # resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
2939
+ # resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2940
+ # resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
2941
+ # resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2942
+ # resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2943
+ # resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2944
+ # resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2945
+ # resp.files_deleted #=> Integer
2946
+ # resp.files_skipped #=> Integer
2947
+ # resp.files_verified #=> Integer
2948
+ # resp.report_result.status #=> String, one of "PENDING", "SUCCESS", "ERROR"
2949
+ # resp.report_result.error_code #=> String
2950
+ # resp.report_result.error_detail #=> String
2951
+ # resp.estimated_files_to_delete #=> Integer
2896
2952
  #
2897
2953
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
2898
2954
  #
@@ -3391,8 +3447,8 @@ module Aws::DataSync
3391
3447
  req.send_request(options)
3392
3448
  end
3393
3449
 
3394
- # Starts an DataSync task. For each task, you can only run one task
3395
- # execution at a time.
3450
+ # Starts an DataSync transfer task. For each task, you can only run one
3451
+ # task execution at a time.
3396
3452
  #
3397
3453
  # There are several phases to a task execution. For more information,
3398
3454
  # see [Task execution statuses][1].
@@ -3412,13 +3468,13 @@ module Aws::DataSync
3412
3468
  # start.
3413
3469
  #
3414
3470
  # @option params [Types::Options] :override_options
3415
- # Configures your DataSync task settings. These options include how
3416
- # DataSync handles files, objects, and their associated metadata. You
3417
- # also can specify how DataSync verifies data integrity, set bandwidth
3418
- # limits for your task, among other options.
3471
+ # Indicates how your transfer task is configured. These options include
3472
+ # how DataSync handles files, objects, and their associated metadata
3473
+ # during your transfer. You also can specify how to verify data
3474
+ # integrity, set bandwidth limits for your task, among other options.
3419
3475
  #
3420
- # Each task setting has a default value. Unless you need to, you don't
3421
- # have to configure any of these `Options` before starting your task.
3476
+ # Each option has a default value. Unless you need to, you don't have
3477
+ # to configure any of these options before starting your task.
3422
3478
  #
3423
3479
  # @option params [Array<Types::FilterRule>] :includes
3424
3480
  # Specifies a list of filter rules that determines which files to
@@ -3440,6 +3496,10 @@ module Aws::DataSync
3440
3496
  # *Tags* are key-value pairs that help you manage, filter, and search
3441
3497
  # for your DataSync resources.
3442
3498
  #
3499
+ # @option params [Types::TaskReportConfig] :task_report_config
3500
+ # Specifies how you want to configure a task report, which provides
3501
+ # detailed information about for your DataSync transfer.
3502
+ #
3443
3503
  # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3444
3504
  #
3445
3505
  # * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
@@ -3483,6 +3543,32 @@ module Aws::DataSync
3483
3543
  # value: "TagValue",
3484
3544
  # },
3485
3545
  # ],
3546
+ # task_report_config: {
3547
+ # destination: {
3548
+ # s3: {
3549
+ # subdirectory: "S3Subdirectory",
3550
+ # s3_bucket_arn: "S3BucketArn", # required
3551
+ # bucket_access_role_arn: "IamRoleArn", # required
3552
+ # },
3553
+ # },
3554
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
3555
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3556
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
3557
+ # overrides: {
3558
+ # transferred: {
3559
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3560
+ # },
3561
+ # verified: {
3562
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3563
+ # },
3564
+ # deleted: {
3565
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3566
+ # },
3567
+ # skipped: {
3568
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3569
+ # },
3570
+ # },
3571
+ # },
3486
3572
  # })
3487
3573
  #
3488
3574
  # @example Response structure
@@ -3820,49 +3906,35 @@ module Aws::DataSync
3820
3906
  req.send_request(options)
3821
3907
  end
3822
3908
 
3823
- # Updates some of the parameters of a previously created location for
3824
- # Network File System (NFS) access. For information about creating an
3825
- # NFS location, see [Creating a location for NFS][1].
3909
+ # Modifies some configurations of the Network File System (NFS) transfer
3910
+ # location that you're using with DataSync.
3911
+ #
3912
+ # For more information, see [Configuring transfers to or from an NFS
3913
+ # file server][1].
3826
3914
  #
3827
3915
  #
3828
3916
  #
3829
3917
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
3830
3918
  #
3831
3919
  # @option params [required, String] :location_arn
3832
- # Specifies the Amazon Resource Name (ARN) of the NFS location that you
3833
- # want to update.
3920
+ # Specifies the Amazon Resource Name (ARN) of the NFS transfer location
3921
+ # that you want to update.
3834
3922
  #
3835
3923
  # @option params [String] :subdirectory
3836
- # Specifies the subdirectory in your NFS file system that DataSync uses
3837
- # to read from or write to during a transfer. The NFS path should be
3838
- # exported by the NFS server, or a subdirectory of that path. The path
3839
- # should be such that it can be mounted by other NFS clients in your
3840
- # network.
3841
- #
3842
- # To see all the paths exported by your NFS server, run "`showmount -e
3843
- # nfs-server-name`" from an NFS client that has access to your server.
3844
- # You can specify any directory that appears in the results, and any
3845
- # subdirectory of that directory. Ensure that the NFS export is
3846
- # accessible without Kerberos authentication.
3847
- #
3848
- # To transfer all the data in the folder that you specified, DataSync
3849
- # must have permissions to read all the data. To ensure this, either
3850
- # configure the NFS export with `no_root_squash`, or ensure that the
3851
- # files you want DataSync to access have permissions that allow read
3852
- # access for all users. Doing either option enables the agent to read
3853
- # the files. For the agent to access directories, you must additionally
3854
- # enable all execute access.
3924
+ # Specifies the export path in your NFS file server that you want
3925
+ # DataSync to mount.
3855
3926
  #
3856
- # If you are copying data to or from your Snowcone device, see [NFS
3857
- # Server on Snowcone][1] for more information.
3927
+ # This path (or a subdirectory of the path) is where DataSync transfers
3928
+ # data to or from. For information on configuring an export for
3929
+ # DataSync, see [Accessing NFS file servers][1].
3858
3930
  #
3859
3931
  #
3860
3932
  #
3861
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
3933
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
3862
3934
  #
3863
3935
  # @option params [Types::OnPremConfig] :on_prem_config
3864
- # A list of Amazon Resource Names (ARNs) of agents to use for a Network
3865
- # File System (NFS) location.
3936
+ # The DataSync agents that are connecting to a Network File System (NFS)
3937
+ # location.
3866
3938
  #
3867
3939
  # @option params [Types::NfsMountOptions] :mount_options
3868
3940
  # Specifies how DataSync can access a location using the NFS protocol.
@@ -4103,20 +4175,20 @@ module Aws::DataSync
4103
4175
  req.send_request(options)
4104
4176
  end
4105
4177
 
4106
- # Updates the metadata associated with a task.
4178
+ # Updates the configuration of a DataSync transfer task.
4107
4179
  #
4108
4180
  # @option params [required, String] :task_arn
4109
4181
  # The Amazon Resource Name (ARN) of the resource name of the task to
4110
4182
  # update.
4111
4183
  #
4112
4184
  # @option params [Types::Options] :options
4113
- # Configures your DataSync task settings. These options include how
4114
- # DataSync handles files, objects, and their associated metadata. You
4115
- # also can specify how DataSync verifies data integrity, set bandwidth
4116
- # limits for your task, among other options.
4185
+ # Indicates how your transfer task is configured. These options include
4186
+ # how DataSync handles files, objects, and their associated metadata
4187
+ # during your transfer. You also can specify how to verify data
4188
+ # integrity, set bandwidth limits for your task, among other options.
4117
4189
  #
4118
- # Each task setting has a default value. Unless you need to, you don't
4119
- # have to configure any of these `Options` before starting your task.
4190
+ # Each option has a default value. Unless you need to, you don't have
4191
+ # to configure any of these options before starting your task.
4120
4192
  #
4121
4193
  # @option params [Array<Types::FilterRule>] :excludes
4122
4194
  # Specifies a list of filter rules that exclude specific data during
@@ -4155,6 +4227,10 @@ module Aws::DataSync
4155
4227
  #
4156
4228
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
4157
4229
  #
4230
+ # @option params [Types::TaskReportConfig] :task_report_config
4231
+ # Specifies how you want to configure a task report, which provides
4232
+ # detailed information about for your DataSync transfer.
4233
+ #
4158
4234
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4159
4235
  #
4160
4236
  # @example Request syntax with placeholder values
@@ -4195,6 +4271,32 @@ module Aws::DataSync
4195
4271
  # value: "FilterValue",
4196
4272
  # },
4197
4273
  # ],
4274
+ # task_report_config: {
4275
+ # destination: {
4276
+ # s3: {
4277
+ # subdirectory: "S3Subdirectory",
4278
+ # s3_bucket_arn: "S3BucketArn", # required
4279
+ # bucket_access_role_arn: "IamRoleArn", # required
4280
+ # },
4281
+ # },
4282
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
4283
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4284
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
4285
+ # overrides: {
4286
+ # transferred: {
4287
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4288
+ # },
4289
+ # verified: {
4290
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4291
+ # },
4292
+ # deleted: {
4293
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4294
+ # },
4295
+ # skipped: {
4296
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4297
+ # },
4298
+ # },
4299
+ # },
4198
4300
  # })
4199
4301
  #
4200
4302
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -4206,11 +4308,11 @@ module Aws::DataSync
4206
4308
  req.send_request(options)
4207
4309
  end
4208
4310
 
4209
- # Modifies a running DataSync task.
4311
+ # Updates the configuration of a running DataSync task execution.
4210
4312
  #
4211
4313
  # <note markdown="1"> Currently, the only `Option` that you can modify with
4212
4314
  # `UpdateTaskExecution` is ` BytesPerSecond `, which throttles bandwidth
4213
- # for a running or queued task.
4315
+ # for a running or queued task execution.
4214
4316
  #
4215
4317
  # </note>
4216
4318
  #
@@ -4219,13 +4321,13 @@ module Aws::DataSync
4219
4321
  # you're updating.
4220
4322
  #
4221
4323
  # @option params [required, Types::Options] :options
4222
- # Configures your DataSync task settings. These options include how
4223
- # DataSync handles files, objects, and their associated metadata. You
4224
- # also can specify how DataSync verifies data integrity, set bandwidth
4225
- # limits for your task, among other options.
4324
+ # Indicates how your transfer task is configured. These options include
4325
+ # how DataSync handles files, objects, and their associated metadata
4326
+ # during your transfer. You also can specify how to verify data
4327
+ # integrity, set bandwidth limits for your task, among other options.
4226
4328
  #
4227
- # Each task setting has a default value. Unless you need to, you don't
4228
- # have to configure any of these `Options` before starting your task.
4329
+ # Each option has a default value. Unless you need to, you don't have
4330
+ # to configure any of these options before starting your task.
4229
4331
  #
4230
4332
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4231
4333
  #
@@ -4274,7 +4376,7 @@ module Aws::DataSync
4274
4376
  params: params,
4275
4377
  config: config)
4276
4378
  context[:gem_name] = 'aws-sdk-datasync'
4277
- context[:gem_version] = '1.63.0'
4379
+ context[:gem_version] = '1.65.0'
4278
4380
  Seahorse::Client::Request.new(handlers, context)
4279
4381
  end
4280
4382