aws-sdk-datasync 1.46.0 → 1.49.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.
@@ -199,63 +199,69 @@ module Aws::DataSync
199
199
  # value: "TagValue",
200
200
  # },
201
201
  # ],
202
+ # access_point_arn: "EfsAccessPointArn",
203
+ # file_system_access_role_arn: "IamRoleArn",
204
+ # in_transit_encryption: "NONE", # accepts NONE, TLS1_2
202
205
  # }
203
206
  #
204
207
  # @!attribute [rw] subdirectory
205
- # A subdirectory in the location’s path. This subdirectory in the EFS
206
- # file system is used to read data from the EFS source location or
207
- # write data to the EFS destination. By default, DataSync uses the
208
- # root directory.
208
+ # Specifies a mount path for your Amazon EFS file system. This is
209
+ # where DataSync reads or writes data (depending on if this is a
210
+ # source or destination location). By default, DataSync uses the root
211
+ # directory, but you can also include subdirectories.
209
212
  #
210
- # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
211
- # `/path/to/folder`.
213
+ # <note markdown="1"> You must specify a value with forward slashes (for example,
214
+ # `/path/to/folder`).
212
215
  #
213
216
  # </note>
214
217
  # @return [String]
215
218
  #
216
219
  # @!attribute [rw] efs_filesystem_arn
217
- # The Amazon Resource Name (ARN) for the Amazon EFS file system.
220
+ # Specifies the ARN for the Amazon EFS file system.
218
221
  # @return [String]
219
222
  #
220
223
  # @!attribute [rw] ec2_config
221
- # The subnet and security group that the Amazon EFS file system uses.
222
- # The security group that you provide needs to be able to communicate
223
- # with the security group on the mount target in the subnet specified.
224
- #
225
- # The exact relationship between security group M (of the mount
226
- # target) and security group S (which you provide for DataSync to use
227
- # at this stage) is as follows:
228
- #
229
- # * Security group M (which you associate with the mount target) must
230
- # allow inbound access for the Transmission Control Protocol (TCP)
231
- # on the NFS port (2049) from security group S. You can enable
232
- # inbound connections either by IP address (CIDR range) or security
233
- # group.
234
- #
235
- # * Security group S (provided to DataSync to access EFS) should have
236
- # a rule that enables outbound connections to the NFS port on one of
237
- # the file system’s mount targets. You can enable outbound
238
- # connections either by IP address (CIDR range) or security group.
239
- #
240
- # For information about security groups and mount targets, see
241
- # Security Groups for Amazon EC2 Instances and Mount Targets in the
242
- # *Amazon EFS User Guide.*
224
+ # Specifies the subnet and security groups DataSync uses to access
225
+ # your Amazon EFS file system.
243
226
  # @return [Types::Ec2Config]
244
227
  #
245
228
  # @!attribute [rw] tags
246
- # The key-value pair that represents a tag that you want to add to the
247
- # resource. The value can be an empty string. This value helps you
248
- # manage, filter, and search for your resources. We recommend that you
249
- # create a name tag for your location.
229
+ # Specifies the key-value pair that represents a tag that you want to
230
+ # add to the resource. The value can be an empty string. This value
231
+ # helps you manage, filter, and search for your resources. We
232
+ # recommend that you create a name tag for your location.
250
233
  # @return [Array<Types::TagListEntry>]
251
234
  #
235
+ # @!attribute [rw] access_point_arn
236
+ # Specifies the Amazon Resource Name (ARN) of the access point that
237
+ # DataSync uses to access the Amazon EFS file system.
238
+ # @return [String]
239
+ #
240
+ # @!attribute [rw] file_system_access_role_arn
241
+ # Specifies an Identity and Access Management (IAM) role that DataSync
242
+ # assumes when mounting the Amazon EFS file system.
243
+ # @return [String]
244
+ #
245
+ # @!attribute [rw] in_transit_encryption
246
+ # Specifies whether you want DataSync to use Transport Layer Security
247
+ # (TLS) 1.2 encryption when it copies data to or from the Amazon EFS
248
+ # file system.
249
+ #
250
+ # If you specify an access point using `AccessPointArn` or an IAM role
251
+ # using `FileSystemAccessRoleArn`, you must set this parameter to
252
+ # `TLS1_2`.
253
+ # @return [String]
254
+ #
252
255
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationEfsRequest AWS API Documentation
253
256
  #
254
257
  class CreateLocationEfsRequest < Struct.new(
255
258
  :subdirectory,
256
259
  :efs_filesystem_arn,
257
260
  :ec2_config,
258
- :tags)
261
+ :tags,
262
+ :access_point_arn,
263
+ :file_system_access_role_arn,
264
+ :in_transit_encryption)
259
265
  SENSITIVE = []
260
266
  include Aws::Structure
261
267
  end
@@ -264,7 +270,7 @@ module Aws::DataSync
264
270
  #
265
271
  # @!attribute [rw] location_arn
266
272
  # The Amazon Resource Name (ARN) of the Amazon EFS file system
267
- # location that is created.
273
+ # location that you create.
268
274
  # @return [String]
269
275
  #
270
276
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationEfsResponse AWS API Documentation
@@ -336,6 +342,107 @@ module Aws::DataSync
336
342
  include Aws::Structure
337
343
  end
338
344
 
345
+ # @note When making an API call, you may pass CreateLocationFsxOntapRequest
346
+ # data as a hash:
347
+ #
348
+ # {
349
+ # protocol: { # required
350
+ # nfs: {
351
+ # mount_options: {
352
+ # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
353
+ # },
354
+ # },
355
+ # smb: {
356
+ # domain: "SmbDomain",
357
+ # mount_options: {
358
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
359
+ # },
360
+ # password: "SmbPassword", # required
361
+ # user: "SmbUser", # required
362
+ # },
363
+ # },
364
+ # security_group_arns: ["Ec2SecurityGroupArn"], # required
365
+ # storage_virtual_machine_arn: "StorageVirtualMachineArn", # required
366
+ # subdirectory: "FsxOntapSubdirectory",
367
+ # tags: [
368
+ # {
369
+ # key: "TagKey", # required
370
+ # value: "TagValue",
371
+ # },
372
+ # ],
373
+ # }
374
+ #
375
+ # @!attribute [rw] protocol
376
+ # Specifies the data transfer protocol that DataSync uses to access
377
+ # your Amazon FSx file system.
378
+ # @return [Types::FsxProtocol]
379
+ #
380
+ # @!attribute [rw] security_group_arns
381
+ # Specifies the Amazon EC2 security groups that provide access to your
382
+ # file system's preferred subnet.
383
+ #
384
+ # The security groups must allow outbound traffic on the following
385
+ # ports (depending on the protocol you use):
386
+ #
387
+ # * **Network File System (NFS)**\: TCP ports 111, 635, and 2049
388
+ #
389
+ # * **Server Message Block (SMB)**\: TCP port 445
390
+ #
391
+ # Your file system's security groups must also allow inbound traffic
392
+ # on the same ports.
393
+ # @return [Array<String>]
394
+ #
395
+ # @!attribute [rw] storage_virtual_machine_arn
396
+ # Specifies the ARN of the storage virtual machine (SVM) on your file
397
+ # system where you're copying data to or from.
398
+ # @return [String]
399
+ #
400
+ # @!attribute [rw] subdirectory
401
+ # Specifies the junction path (also known as a mount point) in the SVM
402
+ # volume where you're copying data to or from (for example, `/vol1`).
403
+ #
404
+ # <note markdown="1"> Don't specify a junction path in the SVM's root volume. For more
405
+ # information, see [Managing FSx for ONTAP storage virtual
406
+ # machines][1] in the *Amazon FSx for NetApp ONTAP User Guide*.
407
+ #
408
+ # </note>
409
+ #
410
+ #
411
+ #
412
+ # [1]: https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html
413
+ # @return [String]
414
+ #
415
+ # @!attribute [rw] tags
416
+ # Specifies labels that help you categorize, filter, and search for
417
+ # your Amazon Web Services resources. We recommend creating at least a
418
+ # name tag for your location.
419
+ # @return [Array<Types::TagListEntry>]
420
+ #
421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxOntapRequest AWS API Documentation
422
+ #
423
+ class CreateLocationFsxOntapRequest < Struct.new(
424
+ :protocol,
425
+ :security_group_arns,
426
+ :storage_virtual_machine_arn,
427
+ :subdirectory,
428
+ :tags)
429
+ SENSITIVE = []
430
+ include Aws::Structure
431
+ end
432
+
433
+ # @!attribute [rw] location_arn
434
+ # Specifies the ARN of the FSx for ONTAP file system location that you
435
+ # create.
436
+ # @return [String]
437
+ #
438
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxOntapResponse AWS API Documentation
439
+ #
440
+ class CreateLocationFsxOntapResponse < Struct.new(
441
+ :location_arn)
442
+ SENSITIVE = []
443
+ include Aws::Structure
444
+ end
445
+
339
446
  # @note When making an API call, you may pass CreateLocationFsxOpenZfsRequest
340
447
  # data as a hash:
341
448
  #
@@ -347,6 +454,14 @@ module Aws::DataSync
347
454
  # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
348
455
  # },
349
456
  # },
457
+ # smb: {
458
+ # domain: "SmbDomain",
459
+ # mount_options: {
460
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
461
+ # },
462
+ # password: "SmbPassword", # required
463
+ # user: "SmbUser", # required
464
+ # },
350
465
  # },
351
466
  # security_group_arns: ["Ec2SecurityGroupArn"], # required
352
467
  # subdirectory: "FsxOpenZfsSubdirectory",
@@ -428,32 +543,41 @@ module Aws::DataSync
428
543
  # }
429
544
  #
430
545
  # @!attribute [rw] subdirectory
431
- # A subdirectory in the location's path. This subdirectory in the
432
- # Amazon FSx for Windows File Server file system is used to read data
433
- # from the Amazon FSx for Windows File Server source location or write
434
- # data to the FSx for Windows File Server destination.
546
+ # Specifies a mount path for your file system using forward slashes.
547
+ # This is where DataSync reads or writes data (depending on if this is
548
+ # a source or destination location).
435
549
  # @return [String]
436
550
  #
437
551
  # @!attribute [rw] fsx_filesystem_arn
438
- # The Amazon Resource Name (ARN) for the FSx for Windows File Server
439
- # file system.
552
+ # Specifies the Amazon Resource Name (ARN) for the FSx for Windows
553
+ # File Server file system.
440
554
  # @return [String]
441
555
  #
442
556
  # @!attribute [rw] security_group_arns
443
- # The ARNs of the security groups that are used to configure the FSx
444
- # for Windows File Server file system.
557
+ # Specifies the ARNs of the security groups that provide access to
558
+ # your file system's preferred subnet.
559
+ #
560
+ # <note markdown="1"> If you choose a security group that doesn't allow connections from
561
+ # within itself, do one of the following:
562
+ #
563
+ # * Configure the security group to allow it to communicate within
564
+ # itself.
565
+ #
566
+ # * Choose a different security group that can communicate with the
567
+ # mount target's security group.
568
+ #
569
+ # </note>
445
570
  # @return [Array<String>]
446
571
  #
447
572
  # @!attribute [rw] tags
448
- # The key-value pair that represents a tag that you want to add to the
449
- # resource. The value can be an empty string. This value helps you
450
- # manage, filter, and search for your resources. We recommend that you
451
- # create a name tag for your location.
573
+ # Specifies labels that help you categorize, filter, and search for
574
+ # your Amazon Web Services resources. We recommend creating at least a
575
+ # name tag for your location.
452
576
  # @return [Array<Types::TagListEntry>]
453
577
  #
454
578
  # @!attribute [rw] user
455
- # The user who has the permissions to access files and folders in the
456
- # FSx for Windows File Server file system.
579
+ # Specifies the user who has the permissions to access files and
580
+ # folders in the file system.
457
581
  #
458
582
  # For information about choosing a user name that ensures sufficient
459
583
  # permissions to files, folders, and metadata, see
@@ -461,13 +585,13 @@ module Aws::DataSync
461
585
  # @return [String]
462
586
  #
463
587
  # @!attribute [rw] domain
464
- # The name of the Windows domain that the FSx for Windows File Server
465
- # belongs to.
588
+ # Specifies the name of the Windows domain that the FSx for Windows
589
+ # File Server belongs to.
466
590
  # @return [String]
467
591
  #
468
592
  # @!attribute [rw] password
469
- # The password of the user who has the permissions to access files and
470
- # folders in the FSx for Windows File Server file system.
593
+ # Specifies the password of the user who has the permissions to access
594
+ # files and folders in the file system.
471
595
  # @return [String]
472
596
  #
473
597
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxWindowsRequest AWS API Documentation
@@ -485,8 +609,8 @@ module Aws::DataSync
485
609
  end
486
610
 
487
611
  # @!attribute [rw] location_arn
488
- # The Amazon Resource Name (ARN) of the FSx for Windows File Server
489
- # file system location you created.
612
+ # The ARN of the FSx for Windows File Server file system location you
613
+ # created.
490
614
  # @return [String]
491
615
  #
492
616
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxWindowsResponse AWS API Documentation
@@ -806,59 +930,53 @@ module Aws::DataSync
806
930
  # }
807
931
  #
808
932
  # @!attribute [rw] server_hostname
809
- # The name of the self-managed object storage server. This value is
810
- # the IP address or Domain Name Service (DNS) name of the object
811
- # storage server. An agent uses this hostname to mount the object
933
+ # Specifies the domain name or IP address of the object storage
934
+ # server. A DataSync agent uses this hostname to mount the object
812
935
  # storage server in a network.
813
936
  # @return [String]
814
937
  #
815
938
  # @!attribute [rw] server_port
816
- # The port that your self-managed object storage server accepts
817
- # inbound network traffic on. The server port is set by default to TCP
818
- # 80 (HTTP) or TCP 443 (HTTPS). You can specify a custom port if your
819
- # self-managed object storage server requires one.
939
+ # Specifies the port that your object storage server accepts inbound
940
+ # network traffic on (for example, port 443).
820
941
  # @return [Integer]
821
942
  #
822
943
  # @!attribute [rw] server_protocol
823
- # The protocol that the object storage server uses to communicate.
824
- # Valid values are HTTP or HTTPS.
944
+ # Specifies the protocol that your object storage server uses to
945
+ # communicate.
825
946
  # @return [String]
826
947
  #
827
948
  # @!attribute [rw] subdirectory
828
- # The subdirectory in the self-managed object storage server that is
829
- # used to read data from.
949
+ # Specifies the object prefix for your object storage server. If this
950
+ # is a source location, DataSync only copies objects with this prefix.
951
+ # If this is a destination location, DataSync writes all objects with
952
+ # this prefix.
830
953
  # @return [String]
831
954
  #
832
955
  # @!attribute [rw] bucket_name
833
- # The bucket on the self-managed object storage server that is used to
834
- # read data from.
956
+ # Specifies the name of the object storage bucket involved in the
957
+ # transfer.
835
958
  # @return [String]
836
959
  #
837
960
  # @!attribute [rw] access_key
838
- # Optional. The access key is used if credentials are required to
839
- # access the self-managed object storage server. If your object
840
- # storage requires a user name and password to authenticate, use
841
- # `AccessKey` and `SecretKey` to provide the user name and password,
842
- # respectively.
961
+ # Specifies the access key (for example, a user name) if credentials
962
+ # are required to authenticate with the object storage server.
843
963
  # @return [String]
844
964
  #
845
965
  # @!attribute [rw] secret_key
846
- # Optional. The secret key is used if credentials are required to
847
- # access the self-managed object storage server. If your object
848
- # storage requires a user name and password to authenticate, use
849
- # `AccessKey` and `SecretKey` to provide the user name and password,
850
- # respectively.
966
+ # Specifies the secret key (for example, a password) if credentials
967
+ # are required to authenticate with the object storage server.
851
968
  # @return [String]
852
969
  #
853
970
  # @!attribute [rw] agent_arns
854
- # The Amazon Resource Name (ARN) of the agents associated with the
855
- # self-managed object storage server location.
971
+ # Specifies the Amazon Resource Names (ARNs) of the DataSync agents
972
+ # that can securely connect with your location.
856
973
  # @return [Array<String>]
857
974
  #
858
975
  # @!attribute [rw] tags
859
- # The key-value pair that represents the tag that you want to add to
860
- # the location. The value can be an empty string. We recommend using
861
- # tags to name your resources.
976
+ # Specifies the key-value pair that represents a tag that you want to
977
+ # add to the resource. Tags can help you manage, filter, and search
978
+ # for your resources. We recommend creating a name tag for your
979
+ # location.
862
980
  # @return [Array<Types::TagListEntry>]
863
981
  #
864
982
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationObjectStorageRequest AWS API Documentation
@@ -880,8 +998,8 @@ module Aws::DataSync
880
998
  # CreateLocationObjectStorageResponse
881
999
  #
882
1000
  # @!attribute [rw] location_arn
883
- # The Amazon Resource Name (ARN) of the agents associated with the
884
- # self-managed object storage server location.
1001
+ # Specifies the ARN of the object storage system location that you
1002
+ # create.
885
1003
  # @return [String]
886
1004
  #
887
1005
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationObjectStorageResponse AWS API Documentation
@@ -1060,8 +1178,8 @@ module Aws::DataSync
1060
1178
  # files and folders in the SMB share.
1061
1179
  #
1062
1180
  # For information about choosing a user name that ensures sufficient
1063
- # permissions to files, folders, and metadata, see
1064
- # [user](create-smb-location.html#SMBuser).
1181
+ # permissions to files, folders, and metadata, see the [User
1182
+ # setting](create-smb-location.html#SMBuser) for SMB locations.
1065
1183
  # @return [String]
1066
1184
  #
1067
1185
  # @!attribute [rw] domain
@@ -1424,7 +1542,8 @@ module Aws::DataSync
1424
1542
  # }
1425
1543
  #
1426
1544
  # @!attribute [rw] location_arn
1427
- # The Amazon Resource Name (ARN) of the EFS location to describe.
1545
+ # The Amazon Resource Name (ARN) of the Amazon EFS file system
1546
+ # location that you want information about.
1428
1547
  # @return [String]
1429
1548
  #
1430
1549
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationEfsRequest AWS API Documentation
@@ -1438,32 +1557,47 @@ module Aws::DataSync
1438
1557
  # DescribeLocationEfsResponse
1439
1558
  #
1440
1559
  # @!attribute [rw] location_arn
1441
- # The Amazon Resource Name (ARN) of the EFS location that was
1442
- # described.
1560
+ # The ARN of the Amazon EFS file system location.
1443
1561
  # @return [String]
1444
1562
  #
1445
1563
  # @!attribute [rw] location_uri
1446
- # The URL of the EFS location that was described.
1564
+ # The URL of the Amazon EFS file system location.
1447
1565
  # @return [String]
1448
1566
  #
1449
1567
  # @!attribute [rw] ec2_config
1450
- # The subnet that DataSync uses to access target EFS file system. The
1451
- # subnet must have at least one mount target for that file system. The
1452
- # security group that you provide needs to be able to communicate with
1453
- # the security group on the mount target in the subnet specified.
1568
+ # The subnet and security groups that DataSync uses to access your
1569
+ # Amazon EFS file system.
1454
1570
  # @return [Types::Ec2Config]
1455
1571
  #
1456
1572
  # @!attribute [rw] creation_time
1457
- # The time that the EFS location was created.
1573
+ # The time that the location was created.
1458
1574
  # @return [Time]
1459
1575
  #
1576
+ # @!attribute [rw] access_point_arn
1577
+ # The ARN of the access point that DataSync uses to access the Amazon
1578
+ # EFS file system.
1579
+ # @return [String]
1580
+ #
1581
+ # @!attribute [rw] file_system_access_role_arn
1582
+ # The Identity and Access Management (IAM) role that DataSync assumes
1583
+ # when mounting the Amazon EFS file system.
1584
+ # @return [String]
1585
+ #
1586
+ # @!attribute [rw] in_transit_encryption
1587
+ # Describes whether DataSync uses Transport Layer Security (TLS)
1588
+ # encryption when copying data to or from the Amazon EFS file system.
1589
+ # @return [String]
1590
+ #
1460
1591
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationEfsResponse AWS API Documentation
1461
1592
  #
1462
1593
  class DescribeLocationEfsResponse < Struct.new(
1463
1594
  :location_arn,
1464
1595
  :location_uri,
1465
1596
  :ec2_config,
1466
- :creation_time)
1597
+ :creation_time,
1598
+ :access_point_arn,
1599
+ :file_system_access_role_arn,
1600
+ :in_transit_encryption)
1467
1601
  SENSITIVE = []
1468
1602
  include Aws::Structure
1469
1603
  end
@@ -1517,6 +1651,72 @@ module Aws::DataSync
1517
1651
  include Aws::Structure
1518
1652
  end
1519
1653
 
1654
+ # @note When making an API call, you may pass DescribeLocationFsxOntapRequest
1655
+ # data as a hash:
1656
+ #
1657
+ # {
1658
+ # location_arn: "LocationArn", # required
1659
+ # }
1660
+ #
1661
+ # @!attribute [rw] location_arn
1662
+ # Specifies the Amazon Resource Name (ARN) of the FSx for ONTAP file
1663
+ # system location that you want information about.
1664
+ # @return [String]
1665
+ #
1666
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationFsxOntapRequest AWS API Documentation
1667
+ #
1668
+ class DescribeLocationFsxOntapRequest < Struct.new(
1669
+ :location_arn)
1670
+ SENSITIVE = []
1671
+ include Aws::Structure
1672
+ end
1673
+
1674
+ # @!attribute [rw] creation_time
1675
+ # The time that the location was created.
1676
+ # @return [Time]
1677
+ #
1678
+ # @!attribute [rw] location_arn
1679
+ # The ARN of the FSx for ONTAP file system location.
1680
+ # @return [String]
1681
+ #
1682
+ # @!attribute [rw] location_uri
1683
+ # The uniform resource identifier (URI) of the FSx for ONTAP file
1684
+ # system location.
1685
+ # @return [String]
1686
+ #
1687
+ # @!attribute [rw] protocol
1688
+ # Specifies the data transfer protocol that DataSync uses to access
1689
+ # your Amazon FSx file system.
1690
+ # @return [Types::FsxProtocol]
1691
+ #
1692
+ # @!attribute [rw] security_group_arns
1693
+ # The security groups that DataSync uses to access your FSx for ONTAP
1694
+ # file system.
1695
+ # @return [Array<String>]
1696
+ #
1697
+ # @!attribute [rw] storage_virtual_machine_arn
1698
+ # The ARN of the storage virtual machine (SVM) on your FSx for ONTAP
1699
+ # file system where you're copying data to or from.
1700
+ # @return [String]
1701
+ #
1702
+ # @!attribute [rw] fsx_filesystem_arn
1703
+ # The ARN of the FSx for ONTAP file system.
1704
+ # @return [String]
1705
+ #
1706
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationFsxOntapResponse AWS API Documentation
1707
+ #
1708
+ class DescribeLocationFsxOntapResponse < Struct.new(
1709
+ :creation_time,
1710
+ :location_arn,
1711
+ :location_uri,
1712
+ :protocol,
1713
+ :security_group_arns,
1714
+ :storage_virtual_machine_arn,
1715
+ :fsx_filesystem_arn)
1716
+ SENSITIVE = []
1717
+ include Aws::Structure
1718
+ end
1719
+
1520
1720
  # @note When making an API call, you may pass DescribeLocationFsxOpenZfsRequest
1521
1721
  # data as a hash:
1522
1722
  #
@@ -1797,8 +1997,8 @@ module Aws::DataSync
1797
1997
  # }
1798
1998
  #
1799
1999
  # @!attribute [rw] location_arn
1800
- # The Amazon Resource Name (ARN) of the self-managed object storage
1801
- # server location that was described.
2000
+ # The Amazon Resource Name (ARN) of the object storage system location
2001
+ # that you want information about.
1802
2002
  # @return [String]
1803
2003
  #
1804
2004
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorageRequest AWS API Documentation
@@ -1812,42 +2012,34 @@ module Aws::DataSync
1812
2012
  # DescribeLocationObjectStorageResponse
1813
2013
  #
1814
2014
  # @!attribute [rw] location_arn
1815
- # The Amazon Resource Name (ARN) of the self-managed object storage
1816
- # server location to describe.
2015
+ # The ARN of the object storage system location.
1817
2016
  # @return [String]
1818
2017
  #
1819
2018
  # @!attribute [rw] location_uri
1820
- # The URL of the source self-managed object storage server location
1821
- # that was described.
2019
+ # The URL of the object storage system location.
1822
2020
  # @return [String]
1823
2021
  #
1824
2022
  # @!attribute [rw] access_key
1825
- # Optional. The access key is used if credentials are required to
1826
- # access the self-managed object storage server. If your object
1827
- # storage requires a user name and password to authenticate, use
1828
- # `AccessKey` and `SecretKey` to provide the user name and password,
1829
- # respectively.
2023
+ # The access key (for example, a user name) required to authenticate
2024
+ # with the object storage server.
1830
2025
  # @return [String]
1831
2026
  #
1832
2027
  # @!attribute [rw] server_port
1833
- # The port that your self-managed object storage server accepts
1834
- # inbound network traffic on. The server port is set by default to TCP
1835
- # 80 (HTTP) or TCP 443 (HTTPS).
2028
+ # The port that your object storage server accepts inbound network
2029
+ # traffic on (for example, port 443).
1836
2030
  # @return [Integer]
1837
2031
  #
1838
2032
  # @!attribute [rw] server_protocol
1839
- # The protocol that the object storage server uses to communicate.
1840
- # Valid values are HTTP or HTTPS.
2033
+ # The protocol that your object storage server uses to communicate.
1841
2034
  # @return [String]
1842
2035
  #
1843
2036
  # @!attribute [rw] agent_arns
1844
- # The Amazon Resource Name (ARN) of the agents associated with the
1845
- # self-managed object storage server location.
2037
+ # The ARNs of the DataSync agents that can securely connect with your
2038
+ # location.
1846
2039
  # @return [Array<String>]
1847
2040
  #
1848
2041
  # @!attribute [rw] creation_time
1849
- # The time that the self-managed object storage server agent was
1850
- # created.
2042
+ # The time that the location was created.
1851
2043
  # @return [Time]
1852
2044
  #
1853
2045
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorageResponse AWS API Documentation
@@ -2298,10 +2490,8 @@ module Aws::DataSync
2298
2490
  include Aws::Structure
2299
2491
  end
2300
2492
 
2301
- # The subnet that DataSync uses to access target EFS file system. The
2302
- # subnet must have at least one mount target for that file system. The
2303
- # security group that you provide needs to be able to communicate with
2304
- # the security group on the mount target in the subnet specified.
2493
+ # The subnet and security groups that DataSync uses to access your
2494
+ # Amazon EFS file system.
2305
2495
  #
2306
2496
  # @note When making an API call, you may pass Ec2Config
2307
2497
  # data as a hash:
@@ -2312,13 +2502,30 @@ module Aws::DataSync
2312
2502
  # }
2313
2503
  #
2314
2504
  # @!attribute [rw] subnet_arn
2315
- # The ARN of the subnet that DataSync uses to access the target EFS
2316
- # file system.
2505
+ # Specifies the ARN of a subnet where DataSync creates the [network
2506
+ # interfaces][1] for managing traffic during your transfer.
2507
+ #
2508
+ # The subnet must be located:
2509
+ #
2510
+ # * In the same virtual private cloud (VPC) as the Amazon EFS file
2511
+ # system.
2512
+ #
2513
+ # * In the same Availability Zone as at least one mount target for the
2514
+ # Amazon EFS file system.
2515
+ #
2516
+ # <note markdown="1"> You don't need to specify a subnet that includes a file system
2517
+ # mount target.
2518
+ #
2519
+ # </note>
2520
+ #
2521
+ #
2522
+ #
2523
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
2317
2524
  # @return [String]
2318
2525
  #
2319
2526
  # @!attribute [rw] security_group_arns
2320
- # The Amazon Resource Names (ARNs) of the security groups that are
2321
- # configured for the Amazon EC2 resource.
2527
+ # Specifies the Amazon Resource Names (ARNs) of the security groups
2528
+ # associated with an Amazon EFS file system's mount target.
2322
2529
  # @return [Array<String>]
2323
2530
  #
2324
2531
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Ec2Config AWS API Documentation
@@ -2361,8 +2568,8 @@ module Aws::DataSync
2361
2568
  include Aws::Structure
2362
2569
  end
2363
2570
 
2364
- # Represents the protocol that DataSync uses to access your Amazon FSx
2365
- # for OpenZFS file system.
2571
+ # Specifies the data transfer protocol that DataSync uses to access your
2572
+ # Amazon FSx file system.
2366
2573
  #
2367
2574
  # @note When making an API call, you may pass FsxProtocol
2368
2575
  # data as a hash:
@@ -2373,23 +2580,39 @@ module Aws::DataSync
2373
2580
  # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
2374
2581
  # },
2375
2582
  # },
2583
+ # smb: {
2584
+ # domain: "SmbDomain",
2585
+ # mount_options: {
2586
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
2587
+ # },
2588
+ # password: "SmbPassword", # required
2589
+ # user: "SmbUser", # required
2590
+ # },
2376
2591
  # }
2377
2592
  #
2378
2593
  # @!attribute [rw] nfs
2379
- # Represents the Network File System (NFS) protocol that DataSync uses
2380
- # to access your FSx for OpenZFS file system.
2594
+ # Specifies the Network File System (NFS) protocol configuration that
2595
+ # DataSync uses to access your FSx for OpenZFS file system or FSx for
2596
+ # ONTAP file system's storage virtual machine (SVM).
2381
2597
  # @return [Types::FsxProtocolNfs]
2382
2598
  #
2599
+ # @!attribute [rw] smb
2600
+ # Specifies the Server Message Block (SMB) protocol configuration that
2601
+ # DataSync uses to access your FSx for ONTAP file system's SVM.
2602
+ # @return [Types::FsxProtocolSmb]
2603
+ #
2383
2604
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/FsxProtocol AWS API Documentation
2384
2605
  #
2385
2606
  class FsxProtocol < Struct.new(
2386
- :nfs)
2607
+ :nfs,
2608
+ :smb)
2387
2609
  SENSITIVE = []
2388
2610
  include Aws::Structure
2389
2611
  end
2390
2612
 
2391
- # Represents the Network File System (NFS) protocol that DataSync uses
2392
- # to access your Amazon FSx for OpenZFS file system.
2613
+ # Specifies the Network File System (NFS) protocol configuration that
2614
+ # DataSync uses to access your Amazon FSx for OpenZFS or Amazon FSx for
2615
+ # NetApp ONTAP file system.
2393
2616
  #
2394
2617
  # @note When making an API call, you may pass FsxProtocolNfs
2395
2618
  # data as a hash:
@@ -2401,8 +2624,7 @@ module Aws::DataSync
2401
2624
  # }
2402
2625
  #
2403
2626
  # @!attribute [rw] mount_options
2404
- # Represents the mount options that are available for DataSync to
2405
- # access an NFS location.
2627
+ # Specifies how DataSync can access a location using the NFS protocol.
2406
2628
  # @return [Types::NfsMountOptions]
2407
2629
  #
2408
2630
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/FsxProtocolNfs AWS API Documentation
@@ -2413,6 +2635,85 @@ module Aws::DataSync
2413
2635
  include Aws::Structure
2414
2636
  end
2415
2637
 
2638
+ # Specifies the Server Message Block (SMB) protocol configuration that
2639
+ # DataSync uses to access your Amazon FSx for NetApp ONTAP file system.
2640
+ # For more information, see [Accessing FSx for ONTAP file systems][1].
2641
+ #
2642
+ #
2643
+ #
2644
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access
2645
+ #
2646
+ # @note When making an API call, you may pass FsxProtocolSmb
2647
+ # data as a hash:
2648
+ #
2649
+ # {
2650
+ # domain: "SmbDomain",
2651
+ # mount_options: {
2652
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
2653
+ # },
2654
+ # password: "SmbPassword", # required
2655
+ # user: "SmbUser", # required
2656
+ # }
2657
+ #
2658
+ # @!attribute [rw] domain
2659
+ # Specifies the fully qualified domain name (FQDN) of the Microsoft
2660
+ # Active Directory that your storage virtual machine (SVM) belongs to.
2661
+ # @return [String]
2662
+ #
2663
+ # @!attribute [rw] mount_options
2664
+ # Specifies how DataSync can access a location using the SMB protocol.
2665
+ # @return [Types::SmbMountOptions]
2666
+ #
2667
+ # @!attribute [rw] password
2668
+ # Specifies the password of a user who has permission to access your
2669
+ # SVM.
2670
+ # @return [String]
2671
+ #
2672
+ # @!attribute [rw] user
2673
+ # Specifies a user name that can mount the location and access the
2674
+ # files, folders, and metadata that you need in the SVM.
2675
+ #
2676
+ # If you provide a user in your Active Directory, note the following:
2677
+ #
2678
+ # * If you're using Directory Service for Microsoft Active Directory,
2679
+ # the user must be a member of the Amazon Web Services Delegated FSx
2680
+ # Administrators group.
2681
+ #
2682
+ # * If you're using a self-managed Active Directory, the user must be
2683
+ # a member of either the Domain Admins group or a custom group that
2684
+ # you specified for file system administration when you created your
2685
+ # file system.
2686
+ #
2687
+ # Make sure that the user has the permissions it needs to copy the
2688
+ # data you want:
2689
+ #
2690
+ # * `SE_TCB_NAME`\: Required to set object ownership and file
2691
+ # metadata. With this privilege, you also can copy NTFS
2692
+ # discretionary access lists (DACLs).
2693
+ #
2694
+ # * `SE_SECURITY_NAME`\: May be needed to copy NTFS system access
2695
+ # control lists (SACLs). This operation specifically requires the
2696
+ # Windows privilege, which is granted to members of the Domain
2697
+ # Admins group. If you configure your task to copy SACLs, make sure
2698
+ # that the user has the required privileges. For information about
2699
+ # copying SACLs, see [Ownership and permissions-related options][1].
2700
+ #
2701
+ #
2702
+ #
2703
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html#configure-ownership-and-permissions
2704
+ # @return [String]
2705
+ #
2706
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/FsxProtocolSmb AWS API Documentation
2707
+ #
2708
+ class FsxProtocolSmb < Struct.new(
2709
+ :domain,
2710
+ :mount_options,
2711
+ :password,
2712
+ :user)
2713
+ SENSITIVE = [:password]
2714
+ include Aws::Structure
2715
+ end
2716
+
2416
2717
  # The NameNode of the Hadoop Distributed File System (HDFS). The
2417
2718
  # NameNode manages the file system's namespace. The NameNode performs
2418
2719
  # operations such as opening, closing, and renaming files and
@@ -2768,10 +3069,16 @@ module Aws::DataSync
2768
3069
  include Aws::Structure
2769
3070
  end
2770
3071
 
2771
- # You can use API filters to narrow down the list of resources returned
2772
- # by `ListLocations`. For example, to retrieve all your Amazon S3
2773
- # locations, you can use `ListLocations` with filter name `LocationType
2774
- # S3` and `Operator Equals`.
3072
+ # Narrow down the list of resources returned by `ListLocations`. For
3073
+ # example, to see all your Amazon S3 locations, create a filter using
3074
+ # `"Name": "LocationType"`, `"Operator": "Equals"`, and `"Values":
3075
+ # "S3"`.
3076
+ #
3077
+ # For more information, see [filtering resources][1].
3078
+ #
3079
+ #
3080
+ #
3081
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
2775
3082
  #
2776
3083
  # @note When making an API call, you may pass LocationFilter
2777
3084
  # data as a hash:
@@ -2795,12 +3102,7 @@ module Aws::DataSync
2795
3102
  #
2796
3103
  # @!attribute [rw] operator
2797
3104
  # The operator that is used to compare filter values (for example,
2798
- # `Equals` or `Contains`). For more about API filtering operators, see
2799
- # [API filters for ListTasks and ListLocations][1].
2800
- #
2801
- #
2802
- #
2803
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
3105
+ # `Equals` or `Contains`).
2804
3106
  # @return [String]
2805
3107
  #
2806
3108
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/LocationFilter AWS API Documentation
@@ -2864,8 +3166,7 @@ module Aws::DataSync
2864
3166
  include Aws::Structure
2865
3167
  end
2866
3168
 
2867
- # Represents the mount options that are available for DataSync to access
2868
- # an NFS location.
3169
+ # Specifies how DataSync can access a location using the NFS protocol.
2869
3170
  #
2870
3171
  # @note When making an API call, you may pass NfsMountOptions
2871
3172
  # data as a hash:
@@ -2875,26 +3176,28 @@ module Aws::DataSync
2875
3176
  # }
2876
3177
  #
2877
3178
  # @!attribute [rw] version
2878
- # The specific NFS version that you want DataSync to use to mount your
2879
- # NFS share. If the server refuses to use the version specified, the
2880
- # sync will fail. If you don't specify a version, DataSync defaults
2881
- # to `AUTOMATIC`. That is, DataSync automatically selects a version
2882
- # based on negotiation with the NFS server.
3179
+ # Specifies the NFS version that you want DataSync to use when
3180
+ # mounting your NFS share. If the server refuses to use the version
3181
+ # specified, the task fails.
3182
+ #
3183
+ # You can specify the following options:
3184
+ #
3185
+ # * `AUTOMATIC` (default): DataSync chooses NFS version 4.1.
3186
+ #
3187
+ # * `NFS3`\: Stateless protocol version that allows for asynchronous
3188
+ # writes on the server.
2883
3189
  #
2884
- # You can specify the following NFS versions:
3190
+ # * `NFSv4_0`\: Stateful, firewall-friendly protocol version that
3191
+ # supports delegations and pseudo file systems.
2885
3192
  #
2886
- # * <b> <a href="https://tools.ietf.org/html/rfc1813">NFSv3</a> </b> -
2887
- # stateless protocol version that allows for asynchronous writes on
2888
- # the server.
3193
+ # * `NFSv4_1`\: Stateful protocol version that supports sessions,
3194
+ # directory delegations, and parallel data processing. NFS version
3195
+ # 4.1 also includes all features available in version 4.0.
2889
3196
  #
2890
- # * <b> <a href="https://tools.ietf.org/html/rfc3530">NFSv4.0</a> </b>
2891
- # - stateful, firewall-friendly protocol version that supports
2892
- # delegations and pseudo file systems.
3197
+ # <note markdown="1"> DataSync currently only supports NFS version 3 with Amazon FSx for
3198
+ # NetApp ONTAP locations.
2893
3199
  #
2894
- # * <b> <a href="https://tools.ietf.org/html/rfc5661">NFSv4.1</a> </b>
2895
- # - stateful protocol version that supports sessions, directory
2896
- # delegations, and parallel data processing. Version 4.1 also
2897
- # includes all features available in version 4.0.
3200
+ # </note>
2898
3201
  # @return [String]
2899
3202
  #
2900
3203
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/NfsMountOptions AWS API Documentation
@@ -2969,20 +3272,20 @@ module Aws::DataSync
2969
3272
  # metadata have been transferred. For more information, see [Configure
2970
3273
  # task settings][1].
2971
3274
  #
2972
- # Default value: POINT\_IN\_TIME\_CONSISTENT.
3275
+ # Default value: `POINT_IN_TIME_CONSISTENT`
2973
3276
  #
2974
- # ONLY\_FILES\_TRANSFERRED (recommended): Perform verification only on
3277
+ # `ONLY_FILES_TRANSFERRED` (recommended): Perform verification only on
2975
3278
  # files that were transferred.
2976
3279
  #
2977
- # POINT\_IN\_TIME\_CONSISTENT: Scan the entire source and entire
3280
+ # `POINT_IN_TIME_CONSISTENT`\: Scan the entire source and entire
2978
3281
  # destination at the end of the transfer to verify that source and
2979
3282
  # destination are fully synchronized. This option isn't supported
2980
3283
  # when transferring to S3 Glacier Flexible Retrieval or S3 Glacier
2981
3284
  # Deep Archive storage classes.
2982
3285
  #
2983
- # NONE: No additional verification is done at the end of the transfer,
2984
- # but all data transmissions are integrity-checked with checksum
2985
- # verification during the transfer.
3286
+ # `NONE`\: No additional verification is done at the end of the
3287
+ # transfer, but all data transmissions are integrity-checked with
3288
+ # checksum verification during the transfer.
2986
3289
  #
2987
3290
  #
2988
3291
  #
@@ -3010,58 +3313,59 @@ module Aws::DataSync
3010
3313
  # @!attribute [rw] atime
3011
3314
  # A file metadata value that shows the last time a file was accessed
3012
3315
  # (that is, when the file was read or written to). If you set `Atime`
3013
- # to BEST\_EFFORT, DataSync attempts to preserve the original `Atime`
3316
+ # to `BEST_EFFORT`, DataSync attempts to preserve the original `Atime`
3014
3317
  # attribute on all source files (that is, the version before the
3015
- # PREPARING phase). However, `Atime`'s behavior is not fully standard
3016
- # across platforms, so DataSync can only do this on a best-effort
3017
- # basis.
3318
+ # `PREPARING` phase). However, `Atime`'s behavior is not fully
3319
+ # standard across platforms, so DataSync can only do this on a
3320
+ # best-effort basis.
3018
3321
  #
3019
- # Default value: BEST\_EFFORT.
3322
+ # Default value: `BEST_EFFORT`
3020
3323
  #
3021
- # BEST\_EFFORT: Attempt to preserve the per-file `Atime` value
3324
+ # `BEST_EFFORT`\: Attempt to preserve the per-file `Atime` value
3022
3325
  # (recommended).
3023
3326
  #
3024
- # NONE: Ignore `Atime`.
3327
+ # `NONE`\: Ignore `Atime`.
3025
3328
  #
3026
- # <note markdown="1"> If `Atime` is set to BEST\_EFFORT, `Mtime` must be set to PRESERVE.
3329
+ # <note markdown="1"> If `Atime` is set to `BEST_EFFORT`, `Mtime` must be set to
3330
+ # `PRESERVE`.
3027
3331
  #
3028
- # If `Atime` is set to NONE, `Mtime` must also be NONE.
3332
+ # If `Atime` is set to `NONE`, `Mtime` must also be `NONE`.
3029
3333
  #
3030
3334
  # </note>
3031
3335
  # @return [String]
3032
3336
  #
3033
3337
  # @!attribute [rw] mtime
3034
3338
  # A value that indicates the last time that a file was modified (that
3035
- # is, a file was written to) before the PREPARING phase. This option
3339
+ # is, a file was written to) before the `PREPARING` phase. This option
3036
3340
  # is required for cases when you need to run the same task more than
3037
3341
  # one time.
3038
3342
  #
3039
3343
  # Default Value: `PRESERVE`
3040
3344
  #
3041
- # PRESERVE: Preserve original `Mtime` (recommended)
3345
+ # `PRESERVE`\: Preserve original `Mtime` (recommended)
3042
3346
  #
3043
- # NONE: Ignore `Mtime`.
3347
+ # `NONE`\: Ignore `Mtime`.
3044
3348
  #
3045
- # <note markdown="1"> If `Mtime` is set to PRESERVE, `Atime` must be set to BEST\_EFFORT.
3349
+ # <note markdown="1"> If `Mtime` is set to `PRESERVE`, `Atime` must be set to
3350
+ # `BEST_EFFORT`.
3046
3351
  #
3047
- # If `Mtime` is set to NONE, `Atime` must also be set to NONE.
3352
+ # If `Mtime` is set to `NONE`, `Atime` must also be set to `NONE`.
3048
3353
  #
3049
3354
  # </note>
3050
3355
  # @return [String]
3051
3356
  #
3052
3357
  # @!attribute [rw] uid
3053
- # The POSIX user ID (UID) of the file's owner. This option should
3054
- # only be set for NFS, EFS, and S3 locations. To learn more about what
3055
- # metadata is copied by DataSync, see [Metadata Copied by
3056
- # DataSync][1].
3358
+ # The POSIX user ID (UID) of the file's owner.
3359
+ #
3360
+ # For more information, see [Metadata copied by DataSync][1].
3057
3361
  #
3058
- # Default value: INT\_VALUE. This preserves the integer value of the
3362
+ # Default value: `INT_VALUE`. This preserves the integer value of the
3059
3363
  # ID.
3060
3364
  #
3061
- # INT\_VALUE: Preserve the integer value of UID and group ID (GID)
3365
+ # `INT_VALUE`\: Preserve the integer value of UID and group ID (GID)
3062
3366
  # (recommended).
3063
3367
  #
3064
- # NONE: Ignore UID and GID.
3368
+ # `NONE`\: Ignore UID and GID.
3065
3369
  #
3066
3370
  #
3067
3371
  #
@@ -3069,18 +3373,17 @@ module Aws::DataSync
3069
3373
  # @return [String]
3070
3374
  #
3071
3375
  # @!attribute [rw] gid
3072
- # The POSIX group ID (GID) of the file's owners. This option should
3073
- # only be set for NFS, EFS, and S3 locations. For more information
3074
- # about what metadata is copied by DataSync, see [Metadata Copied by
3075
- # DataSync][1].
3376
+ # The POSIX group ID (GID) of the file's owners.
3076
3377
  #
3077
- # Default value: INT\_VALUE. This preserves the integer value of the
3378
+ # For more information, see [Metadata copied by DataSync][1].
3379
+ #
3380
+ # Default value: `INT_VALUE`. This preserves the integer value of the
3078
3381
  # ID.
3079
3382
  #
3080
- # INT\_VALUE: Preserve the integer value of user ID (UID) and GID
3383
+ # `INT_VALUE`\: Preserve the integer value of user ID (UID) and GID
3081
3384
  # (recommended).
3082
3385
  #
3083
- # NONE: Ignore UID and GID.
3386
+ # `NONE`\: Ignore UID and GID.
3084
3387
  #
3085
3388
  #
3086
3389
  #
@@ -3096,11 +3399,12 @@ module Aws::DataSync
3096
3399
  # Amazon S3 storage classes in DataSync ][1] in the *DataSync User
3097
3400
  # Guide*.
3098
3401
  #
3099
- # Default value: PRESERVE.
3402
+ # Default value: `PRESERVE`
3100
3403
  #
3101
- # PRESERVE: Ignore such destination files (recommended).
3404
+ # `PRESERVE`\: Ignore such destination files (recommended).
3102
3405
  #
3103
- # REMOVE: Delete destination files that aren’t present in the source.
3406
+ # `REMOVE`\: Delete destination files that aren’t present in the
3407
+ # source.
3104
3408
  #
3105
3409
  #
3106
3410
  #
@@ -3119,26 +3423,26 @@ module Aws::DataSync
3119
3423
  #
3120
3424
  # </note>
3121
3425
  #
3122
- # Default value: NONE.
3426
+ # Default value: `NONE`
3123
3427
  #
3124
- # NONE: Ignore special devices (recommended).
3428
+ # `NONE`\: Ignore special devices (recommended).
3125
3429
  #
3126
- # PRESERVE: Preserve character and block device metadata. This option
3127
- # isn't currently supported for Amazon EFS.
3430
+ # `PRESERVE`\: Preserve character and block device metadata. This
3431
+ # option isn't currently supported for Amazon EFS.
3128
3432
  # @return [String]
3129
3433
  #
3130
3434
  # @!attribute [rw] posix_permissions
3131
3435
  # A value that determines which users or groups can access a file for
3132
3436
  # a specific purpose such as reading, writing, or execution of the
3133
- # file. This option should only be set for NFS, EFS, and S3 locations.
3134
- # For more information about what metadata is copied by DataSync, see
3135
- # [Metadata Copied by DataSync][1].
3437
+ # file.
3438
+ #
3439
+ # For more information, see [Metadata copied by DataSync][1].
3136
3440
  #
3137
- # Default value: PRESERVE.
3441
+ # Default value: `PRESERVE`
3138
3442
  #
3139
- # PRESERVE: Preserve POSIX-style permissions (recommended).
3443
+ # `PRESERVE`\: Preserve POSIX-style permissions (recommended).
3140
3444
  #
3141
- # NONE: Ignore permissions.
3445
+ # `NONE`\: Ignore permissions.
3142
3446
  #
3143
3447
  # <note markdown="1"> DataSync can preserve extant permissions of a source location.
3144
3448
  #
@@ -3189,12 +3493,13 @@ module Aws::DataSync
3189
3493
  # location, or whether DataSync transfers all the content from the
3190
3494
  # source, without comparing to the destination location.
3191
3495
  #
3192
- # CHANGED: DataSync copies only data or metadata that is new or
3496
+ # `CHANGED`\: DataSync copies only data or metadata that is new or
3193
3497
  # different content from the source location to the destination
3194
3498
  # location.
3195
3499
  #
3196
- # ALL: DataSync copies all source location content to the destination,
3197
- # without comparing to existing content on the destination.
3500
+ # `ALL`\: DataSync copies all source location content to the
3501
+ # destination, without comparing to existing content on the
3502
+ # destination.
3198
3503
  # @return [String]
3199
3504
  #
3200
3505
  # @!attribute [rw] security_descriptor_copy_flags
@@ -3207,10 +3512,10 @@ module Aws::DataSync
3207
3512
  # handles metadata, see [How DataSync Handles Metadata and Special
3208
3513
  # Files][1].
3209
3514
  #
3210
- # Default value: OWNER\_DACL.
3515
+ # Default value: `OWNER_DACL`
3211
3516
  #
3212
- # **OWNER\_DACL**\: For each copied object, DataSync copies the
3213
- # following metadata:
3517
+ # `OWNER_DACL`\: For each copied object, DataSync copies the following
3518
+ # metadata:
3214
3519
  #
3215
3520
  # * Object owner.
3216
3521
  #
@@ -3221,7 +3526,7 @@ module Aws::DataSync
3221
3526
  # access control lists (SACLs), which are used by administrators to
3222
3527
  # log attempts to access a secured object.
3223
3528
  #
3224
- # **OWNER\_DACL\_SACL**\: For each copied object, DataSync copies the
3529
+ # `OWNER_DACL_SACL`\: For each copied object, DataSync copies the
3225
3530
  # following metadata:
3226
3531
  #
3227
3532
  # * Object owner.
@@ -3238,10 +3543,10 @@ module Aws::DataSync
3238
3543
  # permissions to files, folders, and metadata, see
3239
3544
  # [user](create-smb-location.html#SMBuser).
3240
3545
  #
3241
- # **NONE**\: None of the SMB security descriptor components are
3242
- # copied. Destination objects are owned by the user that was provided
3243
- # for accessing the destination location. DACLs and SACLs are set
3244
- # based on the destination server’s configuration.
3546
+ # `NONE`\: None of the SMB security descriptor components are copied.
3547
+ # Destination objects are owned by the user that was provided for
3548
+ # accessing the destination location. DACLs and SACLs are set based on
3549
+ # the destination server’s configuration.
3245
3550
  #
3246
3551
  #
3247
3552
  #
@@ -3378,8 +3683,7 @@ module Aws::DataSync
3378
3683
  include Aws::Structure
3379
3684
  end
3380
3685
 
3381
- # Represents the mount options that are available for DataSync to access
3382
- # an SMB location.
3686
+ # Specifies how DataSync can access a location using the SMB protocol.
3383
3687
  #
3384
3688
  # @note When making an API call, you may pass SmbMountOptions
3385
3689
  # data as a hash:
@@ -3389,10 +3693,10 @@ module Aws::DataSync
3389
3693
  # }
3390
3694
  #
3391
3695
  # @!attribute [rw] version
3392
- # The specific SMB version that you want DataSync to use to mount your
3393
- # SMB share. If you don't specify a version, DataSync defaults to
3394
- # `AUTOMATIC`. That is, DataSync automatically selects a version based
3395
- # on negotiation with the SMB server.
3696
+ # Specifies the SMB version that you want DataSync to use when
3697
+ # mounting your SMB share. If you don't specify a version, DataSync
3698
+ # defaults to `AUTOMATIC` and chooses a version based on negotiation
3699
+ # with the SMB server.
3396
3700
  # @return [String]
3397
3701
  #
3398
3702
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/SmbMountOptions AWS API Documentation
@@ -3666,6 +3970,12 @@ module Aws::DataSync
3666
3970
  # location, you can use `ListTasks` with filter name `LocationId` and
3667
3971
  # `Operator Equals` with the ARN for the location.
3668
3972
  #
3973
+ # For more information, see [filtering DataSync resources][1].
3974
+ #
3975
+ #
3976
+ #
3977
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
3978
+ #
3669
3979
  # @note When making an API call, you may pass TaskFilter
3670
3980
  # data as a hash:
3671
3981
  #
@@ -3688,12 +3998,7 @@ module Aws::DataSync
3688
3998
  #
3689
3999
  # @!attribute [rw] operator
3690
4000
  # The operator that is used to compare filter values (for example,
3691
- # `Equals` or `Contains`). For more about API filtering operators, see
3692
- # [API filters for ListTasks and ListLocations][1].
3693
- #
3694
- #
3695
- #
3696
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
4001
+ # `Equals` or `Contains`).
3697
4002
  # @return [String]
3698
4003
  #
3699
4004
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskFilter AWS API Documentation
@@ -4005,8 +4310,7 @@ module Aws::DataSync
4005
4310
  # @return [Types::OnPremConfig]
4006
4311
  #
4007
4312
  # @!attribute [rw] mount_options
4008
- # Represents the mount options that are available for DataSync to
4009
- # access an NFS location.
4313
+ # Specifies how DataSync can access a location using the NFS protocol.
4010
4314
  # @return [Types::NfsMountOptions]
4011
4315
  #
4012
4316
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationNfsRequest AWS API Documentation
@@ -4165,8 +4469,7 @@ module Aws::DataSync
4165
4469
  # @return [Array<String>]
4166
4470
  #
4167
4471
  # @!attribute [rw] mount_options
4168
- # Represents the mount options that are available for DataSync to
4169
- # access an SMB location.
4472
+ # Specifies how DataSync can access a location using the SMB protocol.
4170
4473
  # @return [Types::SmbMountOptions]
4171
4474
  #
4172
4475
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmbRequest AWS API Documentation