aws-sdk-datasync 1.63.0 → 1.65.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml 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