aws-sdk-datasync 1.34.0 → 1.38.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -346,8 +346,8 @@ module Aws::DataSync
346
346
  # you allow the task execution to complete, file content on the
347
347
  # destination is complete and consistent. This applies to other
348
348
  # unexpected failures that interrupt a task execution. In all of these
349
- # cases, AWS DataSync successfully complete the transfer when you start
350
- # the next task execution.
349
+ # cases, DataSync successfully complete the transfer when you start the
350
+ # next task execution.
351
351
  #
352
352
  # @option params [required, String] :task_execution_arn
353
353
  # The Amazon Resource Name (ARN) of the task execution to cancel.
@@ -369,12 +369,13 @@ module Aws::DataSync
369
369
  req.send_request(options)
370
370
  end
371
371
 
372
- # Activates an AWS DataSync agent that you have deployed on your host.
373
- # The activation process associates your agent with your account. In the
374
- # activation process, you specify information such as the AWS Region
375
- # that you want to activate the agent in. You activate the agent in the
376
- # AWS Region where your target locations (in Amazon S3 or Amazon EFS)
377
- # reside. Your tasks are created in this AWS Region.
372
+ # Activates an DataSync agent that you have deployed on your host. The
373
+ # activation process associates your agent with your account. In the
374
+ # activation process, you specify information such as the Amazon Web
375
+ # Services Region that you want to activate the agent in. You activate
376
+ # the agent in the Amazon Web Services Region where your target
377
+ # locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created
378
+ # in this Amazon Web Services Region.
378
379
  #
379
380
  # You can activate the agent in a VPC (virtual private cloud) or provide
380
381
  # the agent access to a VPC endpoint so you can run tasks without going
@@ -385,13 +386,14 @@ module Aws::DataSync
385
386
  # task to run. If you use multiple agents for a source location, the
386
387
  # status of all the agents must be AVAILABLE for the task to run.
387
388
  #
388
- # Agents are automatically updated by AWS on a regular basis, using a
389
- # mechanism that ensures minimal interruption to your tasks.
389
+ # Agents are automatically updated by Amazon Web Services on a regular
390
+ # basis, using a mechanism that ensures minimal interruption to your
391
+ # tasks.
390
392
  #
391
393
  # @option params [required, String] :activation_key
392
394
  # Your agent activation key. You can get the activation key either by
393
395
  # sending an HTTP GET request with redirects that enable you to get the
394
- # agent IP address (port 80). Alternatively, you can get it from the AWS
396
+ # agent IP address (port 80). Alternatively, you can get it from the
395
397
  # DataSync console.
396
398
  #
397
399
  # The redirect URL returned in the response provides you the activation
@@ -400,8 +402,8 @@ module Aws::DataSync
400
402
  # are merely defaults. The arguments you pass to this API call determine
401
403
  # the actual configuration of your agent.
402
404
  #
403
- # For more information, see Activating an Agent in the *AWS DataSync
404
- # User Guide.*
405
+ # For more information, see Activating an Agent in the *DataSync User
406
+ # Guide.*
405
407
  #
406
408
  # @option params [String] :agent_name
407
409
  # The name you configured for your agent. This value is a text reference
@@ -487,7 +489,7 @@ module Aws::DataSync
487
489
  # @option params [String] :subdirectory
488
490
  # A subdirectory in the location’s path. This subdirectory in the EFS
489
491
  # file system is used to read data from the EFS source location or write
490
- # data to the EFS destination. By default, AWS DataSync uses the root
492
+ # data to the EFS destination. By default, DataSync uses the root
491
493
  # directory.
492
494
  #
493
495
  # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
@@ -634,6 +636,141 @@ module Aws::DataSync
634
636
  req.send_request(options)
635
637
  end
636
638
 
639
+ # Creates an endpoint for a Hadoop Distributed File System (HDFS).
640
+ #
641
+ # @option params [String] :subdirectory
642
+ # A subdirectory in the HDFS cluster. This subdirectory is used to read
643
+ # data from or write data to the HDFS cluster. If the subdirectory
644
+ # isn't specified, it will default to `/`.
645
+ #
646
+ # @option params [required, Array<Types::HdfsNameNode>] :name_nodes
647
+ # The NameNode that manages the HDFS namespace. The NameNode performs
648
+ # operations such as opening, closing, and renaming files and
649
+ # directories. The NameNode contains the information to map blocks of
650
+ # data to the DataNodes. You can use only one NameNode.
651
+ #
652
+ # @option params [Integer] :block_size
653
+ # The size of data blocks to write into the HDFS cluster. The block size
654
+ # must be a multiple of 512 bytes. The default block size is 128
655
+ # mebibytes (MiB).
656
+ #
657
+ # @option params [Integer] :replication_factor
658
+ # The number of DataNodes to replicate the data to when writing to the
659
+ # HDFS cluster. By default, data is replicated to three DataNodes.
660
+ #
661
+ # @option params [String] :kms_key_provider_uri
662
+ # The URI of the HDFS cluster's Key Management Server (KMS).
663
+ #
664
+ # @option params [Types::QopConfiguration] :qop_configuration
665
+ # The Quality of Protection (QOP) configuration specifies the Remote
666
+ # Procedure Call (RPC) and data transfer protection settings configured
667
+ # on the Hadoop Distributed File System (HDFS) cluster. If
668
+ # `QopConfiguration` isn't specified, `RpcProtection` and
669
+ # `DataTransferProtection` default to `PRIVACY`. If you set
670
+ # `RpcProtection` or `DataTransferProtection`, the other parameter
671
+ # assumes the same value.
672
+ #
673
+ # @option params [required, String] :authentication_type
674
+ # The type of authentication used to determine the identity of the user.
675
+ #
676
+ # @option params [String] :simple_user
677
+ # The user name used to identify the client on the host operating
678
+ # system.
679
+ #
680
+ # <note markdown="1"> If `SIMPLE` is specified for `AuthenticationType`, this parameter is
681
+ # required.
682
+ #
683
+ # </note>
684
+ #
685
+ # @option params [String] :kerberos_principal
686
+ # The Kerberos principal with access to the files and folders on the
687
+ # HDFS cluster.
688
+ #
689
+ # <note markdown="1"> If `KERBEROS` is specified for `AuthenticationType`, this parameter is
690
+ # required.
691
+ #
692
+ # </note>
693
+ #
694
+ # @option params [String, StringIO, File] :kerberos_keytab
695
+ # The Kerberos key table (keytab) that contains mappings between the
696
+ # defined Kerberos principal and the encrypted keys. You can load the
697
+ # keytab from a file by providing the file's address. If you're using
698
+ # the CLI, it performs base64 encoding for you. Otherwise, provide the
699
+ # base64-encoded text.
700
+ #
701
+ # <note markdown="1"> If `KERBEROS` is specified for `AuthenticationType`, this parameter is
702
+ # required.
703
+ #
704
+ # </note>
705
+ #
706
+ # @option params [String, StringIO, File] :kerberos_krb_5_conf
707
+ # The `krb5.conf` file that contains the Kerberos configuration
708
+ # information. You can load the `krb5.conf` file by providing the
709
+ # file's address. If you're using the CLI, it performs the base64
710
+ # encoding for you. Otherwise, provide the base64-encoded text.
711
+ #
712
+ # <note markdown="1"> If `KERBEROS` is specified for `AuthenticationType`, this parameter is
713
+ # required.
714
+ #
715
+ # </note>
716
+ #
717
+ # @option params [required, Array<String>] :agent_arns
718
+ # The Amazon Resource Names (ARNs) of the agents that are used to
719
+ # connect to the HDFS cluster.
720
+ #
721
+ # @option params [Array<Types::TagListEntry>] :tags
722
+ # The key-value pair that represents the tag that you want to add to the
723
+ # location. The value can be an empty string. We recommend using tags to
724
+ # name your resources.
725
+ #
726
+ # @return [Types::CreateLocationHdfsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
727
+ #
728
+ # * {Types::CreateLocationHdfsResponse#location_arn #location_arn} => String
729
+ #
730
+ # @example Request syntax with placeholder values
731
+ #
732
+ # resp = client.create_location_hdfs({
733
+ # subdirectory: "HdfsSubdirectory",
734
+ # name_nodes: [ # required
735
+ # {
736
+ # hostname: "HdfsServerHostname", # required
737
+ # port: 1, # required
738
+ # },
739
+ # ],
740
+ # block_size: 1,
741
+ # replication_factor: 1,
742
+ # kms_key_provider_uri: "KmsKeyProviderUri",
743
+ # qop_configuration: {
744
+ # rpc_protection: "DISABLED", # accepts DISABLED, AUTHENTICATION, INTEGRITY, PRIVACY
745
+ # data_transfer_protection: "DISABLED", # accepts DISABLED, AUTHENTICATION, INTEGRITY, PRIVACY
746
+ # },
747
+ # authentication_type: "SIMPLE", # required, accepts SIMPLE, KERBEROS
748
+ # simple_user: "HdfsUser",
749
+ # kerberos_principal: "KerberosPrincipal",
750
+ # kerberos_keytab: "data",
751
+ # kerberos_krb_5_conf: "data",
752
+ # agent_arns: ["AgentArn"], # required
753
+ # tags: [
754
+ # {
755
+ # key: "TagKey", # required
756
+ # value: "TagValue",
757
+ # },
758
+ # ],
759
+ # })
760
+ #
761
+ # @example Response structure
762
+ #
763
+ # resp.location_arn #=> String
764
+ #
765
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationHdfs AWS API Documentation
766
+ #
767
+ # @overload create_location_hdfs(params = {})
768
+ # @param [Hash] params ({})
769
+ def create_location_hdfs(params = {}, options = {})
770
+ req = build_request(:create_location_hdfs, params)
771
+ req.send_request(options)
772
+ end
773
+
637
774
  # Defines a file system on a Network File System (NFS) server that can
638
775
  # be read from or written to.
639
776
  #
@@ -658,8 +795,8 @@ module Aws::DataSync
658
795
  # files. For the agent to access directories, you must additionally
659
796
  # enable all execute access.
660
797
  #
661
- # If you are copying data to or from your AWS Snowcone device, see [NFS
662
- # Server on AWS Snowcone][1] for more information.
798
+ # If you are copying data to or from your Snowcone device, see [NFS
799
+ # Server on Snowcone][1] for more information.
663
800
  #
664
801
  # For information about NFS export configuration, see 18.7. The
665
802
  # /etc/exports Configuration File in the Red Hat Enterprise Linux
@@ -674,8 +811,8 @@ module Aws::DataSync
674
811
  # Name Service (DNS) name of the NFS server. An agent that is installed
675
812
  # on-premises uses this host name to mount the NFS server in a network.
676
813
  #
677
- # If you are copying data to or from your AWS Snowcone device, see [NFS
678
- # Server on AWS Snowcone][1] for more information.
814
+ # If you are copying data to or from your Snowcone device, see [NFS
815
+ # Server on Snowcone][1] for more information.
679
816
  #
680
817
  # <note markdown="1"> This name must either be DNS-compliant or must be an IP version 4
681
818
  # (IPv4) address.
@@ -690,8 +827,8 @@ module Aws::DataSync
690
827
  # Contains a list of Amazon Resource Names (ARNs) of agents that are
691
828
  # used to connect to an NFS server.
692
829
  #
693
- # If you are copying data to or from your AWS Snowcone device, see [NFS
694
- # Server on AWS Snowcone][1] for more information.
830
+ # If you are copying data to or from your Snowcone device, see [NFS
831
+ # Server on Snowcone][1] for more information.
695
832
  #
696
833
  #
697
834
  #
@@ -832,9 +969,12 @@ module Aws::DataSync
832
969
 
833
970
  # Creates an endpoint for an Amazon S3 bucket.
834
971
  #
835
- # For more information, see
836
- # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
837
- # in the *AWS DataSync User Guide*.
972
+ # For more information, see [Create an Amazon S3 location][1] in the
973
+ # *DataSync User Guide*.
974
+ #
975
+ #
976
+ #
977
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
838
978
  #
839
979
  # @option params [String] :subdirectory
840
980
  # A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -842,14 +982,15 @@ module Aws::DataSync
842
982
  # S3 destination.
843
983
  #
844
984
  # @option params [required, String] :s3_bucket_arn
845
- # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
846
- # this must be an access point ARN.
985
+ # The ARN of the Amazon S3 bucket. If the bucket is on an Amazon Web
986
+ # Services Outpost, this must be an access point ARN.
847
987
  #
848
988
  # @option params [String] :s3_storage_class
849
989
  # The Amazon S3 storage class that you want to store your files in when
850
- # this location is used as a task destination. For buckets in AWS
851
- # Regions, the storage class defaults to Standard. For buckets on AWS
852
- # Outposts, the storage class defaults to AWS S3 Outposts.
990
+ # this location is used as a task destination. For buckets in Amazon Web
991
+ # Services Regions, the storage class defaults to Standard. For buckets
992
+ # on Outposts, the storage class defaults to Amazon Web Services S3
993
+ # Outposts.
853
994
  #
854
995
  # For more information about S3 storage classes, see [Amazon S3 Storage
855
996
  # Classes][1]. Some storage classes have behaviors that can affect your
@@ -862,17 +1003,18 @@ module Aws::DataSync
862
1003
  # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
863
1004
  #
864
1005
  # @option params [required, Types::S3Config] :s3_config
865
- # The Amazon Resource Name (ARN) of the AWS Identity and Access
866
- # Management (IAM) role that is used to access an Amazon S3 bucket.
1006
+ # The Amazon Resource Name (ARN) of the Identity and Access Management
1007
+ # (IAM) role that is used to access an Amazon S3 bucket.
867
1008
  #
868
1009
  # For detailed information about using such a role, see Creating a
869
- # Location for Amazon S3 in the *AWS DataSync User Guide*.
1010
+ # Location for Amazon S3 in the *DataSync User Guide*.
870
1011
  #
871
1012
  # @option params [Array<String>] :agent_arns
872
- # If you are using DataSync on an AWS Outpost, specify the Amazon
873
- # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
874
- # For more information about launching a DataSync agent on an AWS
875
- # Outpost, see [Deploy your DataSync agent on AWS Outposts][1].
1013
+ # If you are using DataSync on an Amazon Web Services Outpost, specify
1014
+ # the Amazon Resource Names (ARNs) of the DataSync agents deployed on
1015
+ # your Outpost. For more information about launching a DataSync agent on
1016
+ # an Amazon Web Services Outpost, see [Deploy your DataSync agent on
1017
+ # Outposts][1].
876
1018
  #
877
1019
  #
878
1020
  #
@@ -1025,18 +1167,21 @@ module Aws::DataSync
1025
1167
  # The configuration specifies options such as task scheduling, bandwidth
1026
1168
  # limits, etc. A task is the complete definition of a data transfer.
1027
1169
  #
1028
- # When you create a task that transfers data between AWS services in
1029
- # different AWS Regions, one of the two locations that you specify must
1030
- # reside in the Region where DataSync is being used. The other location
1031
- # must be specified in a different Region.
1170
+ # When you create a task that transfers data between Amazon Web Services
1171
+ # services in different Amazon Web Services Regions, one of the two
1172
+ # locations that you specify must reside in the Region where DataSync is
1173
+ # being used. The other location must be specified in a different
1174
+ # Region.
1032
1175
  #
1033
- # You can transfer data between commercial AWS Regions except for China,
1034
- # or between AWS GovCloud (US-East and US-West) Regions.
1176
+ # You can transfer data between commercial Amazon Web Services Regions
1177
+ # except for China, or between Amazon Web Services GovCloud (US)
1178
+ # Regions.
1035
1179
  #
1036
- # When you use DataSync to copy files or objects between AWS Regions,
1037
- # you pay for data transfer between Regions. This is billed as data
1038
- # transfer OUT from your source Region to your destination Region. For
1039
- # more information, see [Data Transfer pricing][1].
1180
+ # When you use DataSync to copy files or objects between Amazon Web
1181
+ # Services Regions, you pay for data transfer between Regions. This is
1182
+ # billed as data transfer OUT from your source Region to your
1183
+ # destination Region. For more information, see [Data Transfer
1184
+ # pricing][1].
1040
1185
  #
1041
1186
  #
1042
1187
  #
@@ -1046,7 +1191,8 @@ module Aws::DataSync
1046
1191
  # The Amazon Resource Name (ARN) of the source location for the task.
1047
1192
  #
1048
1193
  # @option params [required, String] :destination_location_arn
1049
- # The Amazon Resource Name (ARN) of an AWS storage resource's location.
1194
+ # The Amazon Resource Name (ARN) of an Amazon Web Services storage
1195
+ # resource's location.
1050
1196
  #
1051
1197
  # @option params [String] :cloud_watch_log_group_arn
1052
1198
  # The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
@@ -1090,6 +1236,12 @@ module Aws::DataSync
1090
1236
  # The key-value pair that represents the tag that you want to add to the
1091
1237
  # resource. The value can be an empty string.
1092
1238
  #
1239
+ # @option params [Array<Types::FilterRule>] :includes
1240
+ # A list of filter rules that determines which files to include when
1241
+ # running a task. The pattern contains a single filter string that
1242
+ # consists of the patterns to include. The patterns are delimited by
1243
+ # "\|" (that is, a pipe), for example, `"/folder1|/folder2"`.
1244
+ #
1093
1245
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1094
1246
  #
1095
1247
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1132,6 +1284,12 @@ module Aws::DataSync
1132
1284
  # value: "TagValue",
1133
1285
  # },
1134
1286
  # ],
1287
+ # includes: [
1288
+ # {
1289
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
1290
+ # value: "FilterValue",
1291
+ # },
1292
+ # ],
1135
1293
  # })
1136
1294
  #
1137
1295
  # @example Response structure
@@ -1149,14 +1307,14 @@ module Aws::DataSync
1149
1307
 
1150
1308
  # Deletes an agent. To specify which agent to delete, use the Amazon
1151
1309
  # Resource Name (ARN) of the agent in your request. The operation
1152
- # disassociates the agent from your AWS account. However, it doesn't
1153
- # delete the agent virtual machine (VM) from your on-premises
1154
- # environment.
1310
+ # disassociates the agent from your Amazon Web Services account.
1311
+ # However, it doesn't delete the agent virtual machine (VM) from your
1312
+ # on-premises environment.
1155
1313
  #
1156
1314
  # @option params [required, String] :agent_arn
1157
1315
  # The Amazon Resource Name (ARN) of the agent to delete. Use the
1158
1316
  # `ListAgents` operation to return a list of agents for your account and
1159
- # AWS Region.
1317
+ # Amazon Web Services Region.
1160
1318
  #
1161
1319
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1162
1320
  #
@@ -1175,7 +1333,7 @@ module Aws::DataSync
1175
1333
  req.send_request(options)
1176
1334
  end
1177
1335
 
1178
- # Deletes the configuration of a location used by AWS DataSync.
1336
+ # Deletes the configuration of a location used by DataSync.
1179
1337
  #
1180
1338
  # @option params [required, String] :location_arn
1181
1339
  # The Amazon Resource Name (ARN) of the location to delete.
@@ -1345,6 +1503,62 @@ module Aws::DataSync
1345
1503
  req.send_request(options)
1346
1504
  end
1347
1505
 
1506
+ # Returns metadata, such as the authentication information about the
1507
+ # Hadoop Distributed File System (HDFS) location.
1508
+ #
1509
+ # @option params [required, String] :location_arn
1510
+ # The Amazon Resource Name (ARN) of the HDFS cluster location to
1511
+ # describe.
1512
+ #
1513
+ # @return [Types::DescribeLocationHdfsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1514
+ #
1515
+ # * {Types::DescribeLocationHdfsResponse#location_arn #location_arn} => String
1516
+ # * {Types::DescribeLocationHdfsResponse#location_uri #location_uri} => String
1517
+ # * {Types::DescribeLocationHdfsResponse#name_nodes #name_nodes} => Array&lt;Types::HdfsNameNode&gt;
1518
+ # * {Types::DescribeLocationHdfsResponse#block_size #block_size} => Integer
1519
+ # * {Types::DescribeLocationHdfsResponse#replication_factor #replication_factor} => Integer
1520
+ # * {Types::DescribeLocationHdfsResponse#kms_key_provider_uri #kms_key_provider_uri} => String
1521
+ # * {Types::DescribeLocationHdfsResponse#qop_configuration #qop_configuration} => Types::QopConfiguration
1522
+ # * {Types::DescribeLocationHdfsResponse#authentication_type #authentication_type} => String
1523
+ # * {Types::DescribeLocationHdfsResponse#simple_user #simple_user} => String
1524
+ # * {Types::DescribeLocationHdfsResponse#kerberos_principal #kerberos_principal} => String
1525
+ # * {Types::DescribeLocationHdfsResponse#agent_arns #agent_arns} => Array&lt;String&gt;
1526
+ # * {Types::DescribeLocationHdfsResponse#creation_time #creation_time} => Time
1527
+ #
1528
+ # @example Request syntax with placeholder values
1529
+ #
1530
+ # resp = client.describe_location_hdfs({
1531
+ # location_arn: "LocationArn", # required
1532
+ # })
1533
+ #
1534
+ # @example Response structure
1535
+ #
1536
+ # resp.location_arn #=> String
1537
+ # resp.location_uri #=> String
1538
+ # resp.name_nodes #=> Array
1539
+ # resp.name_nodes[0].hostname #=> String
1540
+ # resp.name_nodes[0].port #=> Integer
1541
+ # resp.block_size #=> Integer
1542
+ # resp.replication_factor #=> Integer
1543
+ # resp.kms_key_provider_uri #=> String
1544
+ # resp.qop_configuration.rpc_protection #=> String, one of "DISABLED", "AUTHENTICATION", "INTEGRITY", "PRIVACY"
1545
+ # resp.qop_configuration.data_transfer_protection #=> String, one of "DISABLED", "AUTHENTICATION", "INTEGRITY", "PRIVACY"
1546
+ # resp.authentication_type #=> String, one of "SIMPLE", "KERBEROS"
1547
+ # resp.simple_user #=> String
1548
+ # resp.kerberos_principal #=> String
1549
+ # resp.agent_arns #=> Array
1550
+ # resp.agent_arns[0] #=> String
1551
+ # resp.creation_time #=> Time
1552
+ #
1553
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationHdfs AWS API Documentation
1554
+ #
1555
+ # @overload describe_location_hdfs(params = {})
1556
+ # @param [Hash] params ({})
1557
+ def describe_location_hdfs(params = {}, options = {})
1558
+ req = build_request(:describe_location_hdfs, params)
1559
+ req.send_request(options)
1560
+ end
1561
+
1348
1562
  # Returns metadata, such as the path information, about an NFS location.
1349
1563
  #
1350
1564
  # @option params [required, String] :location_arn
@@ -1535,6 +1749,7 @@ module Aws::DataSync
1535
1749
  # * {Types::DescribeTaskResponse#error_code #error_code} => String
1536
1750
  # * {Types::DescribeTaskResponse#error_detail #error_detail} => String
1537
1751
  # * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
1752
+ # * {Types::DescribeTaskResponse#includes #includes} => Array&lt;Types::FilterRule&gt;
1538
1753
  #
1539
1754
  # @example Request syntax with placeholder values
1540
1755
  #
@@ -1576,6 +1791,9 @@ module Aws::DataSync
1576
1791
  # resp.error_code #=> String
1577
1792
  # resp.error_detail #=> String
1578
1793
  # resp.creation_time #=> Time
1794
+ # resp.includes #=> Array
1795
+ # resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1796
+ # resp.includes[0].value #=> String
1579
1797
  #
1580
1798
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
1581
1799
  #
@@ -1661,9 +1879,9 @@ module Aws::DataSync
1661
1879
  req.send_request(options)
1662
1880
  end
1663
1881
 
1664
- # Returns a list of agents owned by an AWS account in the AWS Region
1665
- # specified in the request. The returned list is ordered by agent Amazon
1666
- # Resource Name (ARN).
1882
+ # Returns a list of agents owned by an Amazon Web Services account in
1883
+ # the Amazon Web Services Region specified in the request. The returned
1884
+ # list is ordered by agent Amazon Resource Name (ARN).
1667
1885
  #
1668
1886
  # By default, this operation returns a maximum of 100 agents. This
1669
1887
  # operation supports pagination that enables you to optionally reduce
@@ -1917,7 +2135,7 @@ module Aws::DataSync
1917
2135
  # PREPARING \| TRANSFERRING \| VERIFYING \| SUCCESS/FAILURE.
1918
2136
  #
1919
2137
  # For detailed information, see the Task Execution section in the
1920
- # Components and Terminology topic in the *AWS DataSync User Guide*.
2138
+ # Components and Terminology topic in the *DataSync User Guide*.
1921
2139
  #
1922
2140
  # @option params [required, String] :task_arn
1923
2141
  # The Amazon Resource Name (ARN) of the task to start.
@@ -1942,7 +2160,13 @@ module Aws::DataSync
1942
2160
  # A list of filter rules that determines which files to include when
1943
2161
  # running a task. The pattern should contain a single filter string that
1944
2162
  # consists of the patterns to include. The patterns are delimited by
1945
- # "\|" (that is, a pipe). For example: `"/folder1|/folder2"`
2163
+ # "\|" (that is, a pipe), for example, `"/folder1|/folder2"`.
2164
+ #
2165
+ # @option params [Array<Types::FilterRule>] :excludes
2166
+ # A list of filter rules that determines which files to exclude from a
2167
+ # task. The list contains a single filter string that consists of the
2168
+ # patterns to exclude. The patterns are delimited by "\|" (that is, a
2169
+ # pipe), for example, `"/folder1|/folder2"`.
1946
2170
  #
1947
2171
  # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1948
2172
  #
@@ -1974,6 +2198,12 @@ module Aws::DataSync
1974
2198
  # value: "FilterValue",
1975
2199
  # },
1976
2200
  # ],
2201
+ # excludes: [
2202
+ # {
2203
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
2204
+ # value: "FilterValue",
2205
+ # },
2206
+ # ],
1977
2207
  # })
1978
2208
  #
1979
2209
  # @example Response structure
@@ -1989,7 +2219,7 @@ module Aws::DataSync
1989
2219
  req.send_request(options)
1990
2220
  end
1991
2221
 
1992
- # Applies a key-value pair to an AWS resource.
2222
+ # Applies a key-value pair to an Amazon Web Services resource.
1993
2223
  #
1994
2224
  # @option params [required, String] :resource_arn
1995
2225
  # The Amazon Resource Name (ARN) of the resource to apply the tag to.
@@ -2020,7 +2250,7 @@ module Aws::DataSync
2020
2250
  req.send_request(options)
2021
2251
  end
2022
2252
 
2023
- # Removes a tag from an AWS resource.
2253
+ # Removes a tag from an Amazon Web Services resource.
2024
2254
  #
2025
2255
  # @option params [required, String] :resource_arn
2026
2256
  # The Amazon Resource Name (ARN) of the resource to remove the tag from.
@@ -2072,6 +2302,101 @@ module Aws::DataSync
2072
2302
  req.send_request(options)
2073
2303
  end
2074
2304
 
2305
+ # Updates some parameters of a previously created location for a Hadoop
2306
+ # Distributed File System cluster.
2307
+ #
2308
+ # @option params [required, String] :location_arn
2309
+ # The Amazon Resource Name (ARN) of the source HDFS cluster location.
2310
+ #
2311
+ # @option params [String] :subdirectory
2312
+ # A subdirectory in the HDFS cluster. This subdirectory is used to read
2313
+ # data from or write data to the HDFS cluster.
2314
+ #
2315
+ # @option params [Array<Types::HdfsNameNode>] :name_nodes
2316
+ # The NameNode that manages the HDFS namespace. The NameNode performs
2317
+ # operations such as opening, closing, and renaming files and
2318
+ # directories. The NameNode contains the information to map blocks of
2319
+ # data to the DataNodes. You can use only one NameNode.
2320
+ #
2321
+ # @option params [Integer] :block_size
2322
+ # The size of the data blocks to write into the HDFS cluster.
2323
+ #
2324
+ # @option params [Integer] :replication_factor
2325
+ # The number of DataNodes to replicate the data to when writing to the
2326
+ # HDFS cluster.
2327
+ #
2328
+ # @option params [String] :kms_key_provider_uri
2329
+ # The URI of the HDFS cluster's Key Management Server (KMS).
2330
+ #
2331
+ # @option params [Types::QopConfiguration] :qop_configuration
2332
+ # The Quality of Protection (QOP) configuration specifies the Remote
2333
+ # Procedure Call (RPC) and data transfer privacy settings configured on
2334
+ # the Hadoop Distributed File System (HDFS) cluster.
2335
+ #
2336
+ # @option params [String] :authentication_type
2337
+ # The type of authentication used to determine the identity of the user.
2338
+ #
2339
+ # @option params [String] :simple_user
2340
+ # The user name used to identify the client on the host operating
2341
+ # system.
2342
+ #
2343
+ # @option params [String] :kerberos_principal
2344
+ # The Kerberos principal with access to the files and folders on the
2345
+ # HDFS cluster.
2346
+ #
2347
+ # @option params [String, StringIO, File] :kerberos_keytab
2348
+ # The Kerberos key table (keytab) that contains mappings between the
2349
+ # defined Kerberos principal and the encrypted keys. You can load the
2350
+ # keytab from a file by providing the file's address. If you use the
2351
+ # AWS CLI, it performs base64 encoding for you. Otherwise, provide the
2352
+ # base64-encoded text.
2353
+ #
2354
+ # @option params [String, StringIO, File] :kerberos_krb_5_conf
2355
+ # The `krb5.conf` file that contains the Kerberos configuration
2356
+ # information. You can load the `krb5.conf` file by providing the
2357
+ # file's address. If you're using the AWS CLI, it performs the base64
2358
+ # encoding for you. Otherwise, provide the base64-encoded text.
2359
+ #
2360
+ # @option params [Array<String>] :agent_arns
2361
+ # The ARNs of the agents that are used to connect to the HDFS cluster.
2362
+ #
2363
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2364
+ #
2365
+ # @example Request syntax with placeholder values
2366
+ #
2367
+ # resp = client.update_location_hdfs({
2368
+ # location_arn: "LocationArn", # required
2369
+ # subdirectory: "HdfsSubdirectory",
2370
+ # name_nodes: [
2371
+ # {
2372
+ # hostname: "HdfsServerHostname", # required
2373
+ # port: 1, # required
2374
+ # },
2375
+ # ],
2376
+ # block_size: 1,
2377
+ # replication_factor: 1,
2378
+ # kms_key_provider_uri: "KmsKeyProviderUri",
2379
+ # qop_configuration: {
2380
+ # rpc_protection: "DISABLED", # accepts DISABLED, AUTHENTICATION, INTEGRITY, PRIVACY
2381
+ # data_transfer_protection: "DISABLED", # accepts DISABLED, AUTHENTICATION, INTEGRITY, PRIVACY
2382
+ # },
2383
+ # authentication_type: "SIMPLE", # accepts SIMPLE, KERBEROS
2384
+ # simple_user: "HdfsUser",
2385
+ # kerberos_principal: "KerberosPrincipal",
2386
+ # kerberos_keytab: "data",
2387
+ # kerberos_krb_5_conf: "data",
2388
+ # agent_arns: ["AgentArn"],
2389
+ # })
2390
+ #
2391
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationHdfs AWS API Documentation
2392
+ #
2393
+ # @overload update_location_hdfs(params = {})
2394
+ # @param [Hash] params ({})
2395
+ def update_location_hdfs(params = {}, options = {})
2396
+ req = build_request(:update_location_hdfs, params)
2397
+ req.send_request(options)
2398
+ end
2399
+
2075
2400
  # Updates some of the parameters of a previously created location for
2076
2401
  # Network File System (NFS) access. For information about creating an
2077
2402
  # NFS location, see [Creating a location for NFS][1].
@@ -2104,8 +2429,8 @@ module Aws::DataSync
2104
2429
  # the files. For the agent to access directories, you must additionally
2105
2430
  # enable all execute access.
2106
2431
  #
2107
- # If you are copying data to or from your AWS Snowcone device, see [NFS
2108
- # Server on AWS Snowcone][1] for more information.
2432
+ # If you are copying data to or from your Snowcone device, see [NFS
2433
+ # Server on Snowcone][1] for more information.
2109
2434
  #
2110
2435
  # For information about NFS export configuration, see 18.7. The
2111
2436
  # /etc/exports Configuration File in the Red Hat Enterprise Linux
@@ -2321,7 +2646,7 @@ module Aws::DataSync
2321
2646
  # A list of filter rules that determines which files to exclude from a
2322
2647
  # task. The list should contain a single filter string that consists of
2323
2648
  # the patterns to exclude. The patterns are delimited by "\|" (that
2324
- # is, a pipe), for example: `"/folder1|/folder2"`
2649
+ # is, a pipe), for example, `"/folder1|/folder2"`.
2325
2650
  #
2326
2651
  # @option params [Types::TaskSchedule] :schedule
2327
2652
  # Specifies a schedule used to periodically transfer files from a source
@@ -2339,8 +2664,14 @@ module Aws::DataSync
2339
2664
  # The name of the task to update.
2340
2665
  #
2341
2666
  # @option params [String] :cloud_watch_log_group_arn
2342
- # The Amazon Resource Name (ARN) of the resource name of the CloudWatch
2343
- # LogGroup.
2667
+ # The Amazon Resource Name (ARN) of the resource name of the Amazon
2668
+ # CloudWatch log group.
2669
+ #
2670
+ # @option params [Array<Types::FilterRule>] :includes
2671
+ # A list of filter rules that determines which files to include when
2672
+ # running a task. The pattern contains a single filter string that
2673
+ # consists of the patterns to include. The patterns are delimited by
2674
+ # "\|" (that is, a pipe), for example, `"/folder1|/folder2"`.
2344
2675
  #
2345
2676
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2346
2677
  #
@@ -2375,6 +2706,12 @@ module Aws::DataSync
2375
2706
  # },
2376
2707
  # name: "TagValue",
2377
2708
  # cloud_watch_log_group_arn: "LogGroupArn",
2709
+ # includes: [
2710
+ # {
2711
+ # filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
2712
+ # value: "FilterValue",
2713
+ # },
2714
+ # ],
2378
2715
  # })
2379
2716
  #
2380
2717
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -2467,7 +2804,7 @@ module Aws::DataSync
2467
2804
  params: params,
2468
2805
  config: config)
2469
2806
  context[:gem_name] = 'aws-sdk-datasync'
2470
- context[:gem_version] = '1.34.0'
2807
+ context[:gem_version] = '1.38.0'
2471
2808
  Seahorse::Client::Request.new(handlers, context)
2472
2809
  end
2473
2810