aws-sdk-lakeformation 1.18.0 → 1.22.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,8 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
30
31
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
- require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
32
+ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
32
33
 
33
34
  Aws::Plugins::GlobalConfiguration.add_identifier(:lakeformation)
34
35
 
@@ -73,8 +74,9 @@ module Aws::LakeFormation
73
74
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
75
  add_plugin(Aws::Plugins::TransferEncoding)
75
76
  add_plugin(Aws::Plugins::HttpChecksum)
77
+ add_plugin(Aws::Plugins::DefaultsMode)
76
78
  add_plugin(Aws::Plugins::SignatureV4)
77
- add_plugin(Aws::Plugins::Protocols::JsonRpc)
79
+ add_plugin(Aws::Plugins::Protocols::RestJson)
78
80
 
79
81
  # @overload initialize(options)
80
82
  # @param [Hash] options
@@ -119,7 +121,9 @@ module Aws::LakeFormation
119
121
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
122
  # are very aggressive. Construct and pass an instance of
121
123
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
124
+ # enable retries and extended timeouts. Instance profile credential
125
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
126
+ # to true.
123
127
  #
124
128
  # @option options [required, String] :region
125
129
  # The AWS region to connect to. The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::LakeFormation
173
177
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
174
178
  # a clock skew correction and retry requests with skewed client clocks.
175
179
  #
180
+ # @option options [String] :defaults_mode ("legacy")
181
+ # See {Aws::DefaultsModeConfiguration} for a list of the
182
+ # accepted modes and the configuration defaults that are included.
183
+ #
176
184
  # @option options [Boolean] :disable_host_prefix_injection (false)
177
185
  # Set to true to disable SDK automatically adding host prefix
178
186
  # to default service endpoint when available.
@@ -266,16 +274,6 @@ module Aws::LakeFormation
266
274
  #
267
275
  # @option options [String] :session_token
268
276
  #
269
- # @option options [Boolean] :simple_json (false)
270
- # Disables request parameter conversion, validation, and formatting.
271
- # Also disable response data type conversions. This option is useful
272
- # when you want to ensure the highest level of performance by
273
- # avoiding overhead of walking request parameters and response data
274
- # structures.
275
- #
276
- # When `:simple_json` is enabled, the request parameters hash must
277
- # be formatted exactly as the DynamoDB API expects.
278
- #
279
277
  # @option options [Boolean] :stub_responses (false)
280
278
  # Causes the client to return stubbed responses. By default
281
279
  # fake responses are generated and returned. You can specify
@@ -285,6 +283,15 @@ module Aws::LakeFormation
285
283
  # ** Please note ** When response stubbing is enabled, no HTTP
286
284
  # requests are made, and retries are disabled.
287
285
  #
286
+ # @option options [Boolean] :use_dualstack_endpoint
287
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
288
+ # will be used if available.
289
+ #
290
+ # @option options [Boolean] :use_fips_endpoint
291
+ # When set to `true`, fips compatible endpoints will be used if available.
292
+ # When a `fips` region is used, the region is normalized and this config
293
+ # is set to `true`.
294
+ #
288
295
  # @option options [Boolean] :validate_params (true)
289
296
  # When `true`, request parameters are validated before
290
297
  # sending the request.
@@ -296,7 +303,7 @@ module Aws::LakeFormation
296
303
  # seconds to wait when opening a HTTP session before raising a
297
304
  # `Timeout::Error`.
298
305
  #
299
- # @option options [Integer] :http_read_timeout (60) The default
306
+ # @option options [Float] :http_read_timeout (60) The default
300
307
  # number of seconds to wait for response data. This value can
301
308
  # safely be set per-request on the session.
302
309
  #
@@ -312,6 +319,9 @@ module Aws::LakeFormation
312
319
  # disables this behaviour. This value can safely be set per
313
320
  # request on the session.
314
321
  #
322
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
323
+ # in seconds.
324
+ #
315
325
  # @option options [Boolean] :http_wire_trace (false) When `true`,
316
326
  # HTTP debug output will be sent to the `:logger`.
317
327
  #
@@ -337,19 +347,19 @@ module Aws::LakeFormation
337
347
 
338
348
  # @!group API Operations
339
349
 
340
- # Attaches one or more tags to an existing resource.
350
+ # Attaches one or more LF-tags to an existing resource.
341
351
  #
342
352
  # @option params [String] :catalog_id
343
353
  # The identifier for the Data Catalog. By default, the account ID. The
344
354
  # Data Catalog is the persistent metadata store. It contains database
345
355
  # definitions, table definitions, and other control information to
346
- # manage your AWS Lake Formation environment.
356
+ # manage your Lake Formation environment.
347
357
  #
348
358
  # @option params [required, Types::Resource] :resource
349
- # The resource to which to attach a tag.
359
+ # The database, table, or column resource to which to attach an LF-tag.
350
360
  #
351
361
  # @option params [required, Array<Types::LFTagPair>] :lf_tags
352
- # The tags to attach to the resource.
362
+ # The LF-tags to attach to the resource.
353
363
  #
354
364
  # @return [Types::AddLFTagsToResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
355
365
  #
@@ -386,6 +396,12 @@ module Aws::LakeFormation
386
396
  # catalog_id: "CatalogIdString",
387
397
  # resource_arn: "ResourceArnString", # required
388
398
  # },
399
+ # data_cells_filter: {
400
+ # table_catalog_id: "CatalogIdString",
401
+ # database_name: "NameString",
402
+ # table_name: "NameString",
403
+ # name: "NameString",
404
+ # },
389
405
  # lf_tag: {
390
406
  # catalog_id: "CatalogIdString",
391
407
  # tag_key: "NameString", # required
@@ -436,7 +452,7 @@ module Aws::LakeFormation
436
452
  # The identifier for the Data Catalog. By default, the account ID. The
437
453
  # Data Catalog is the persistent metadata store. It contains database
438
454
  # definitions, table definitions, and other control information to
439
- # manage your AWS Lake Formation environment.
455
+ # manage your Lake Formation environment.
440
456
  #
441
457
  # @option params [required, Array<Types::BatchPermissionsRequestEntry>] :entries
442
458
  # A list of up to 20 entries for resource permissions to be granted by
@@ -483,6 +499,12 @@ module Aws::LakeFormation
483
499
  # catalog_id: "CatalogIdString",
484
500
  # resource_arn: "ResourceArnString", # required
485
501
  # },
502
+ # data_cells_filter: {
503
+ # table_catalog_id: "CatalogIdString",
504
+ # database_name: "NameString",
505
+ # table_name: "NameString",
506
+ # name: "NameString",
507
+ # },
486
508
  # lf_tag: {
487
509
  # catalog_id: "CatalogIdString",
488
510
  # tag_key: "NameString", # required
@@ -524,6 +546,10 @@ module Aws::LakeFormation
524
546
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
525
547
  # resp.failures[0].request_entry.resource.data_location.catalog_id #=> String
526
548
  # resp.failures[0].request_entry.resource.data_location.resource_arn #=> String
549
+ # resp.failures[0].request_entry.resource.data_cells_filter.table_catalog_id #=> String
550
+ # resp.failures[0].request_entry.resource.data_cells_filter.database_name #=> String
551
+ # resp.failures[0].request_entry.resource.data_cells_filter.table_name #=> String
552
+ # resp.failures[0].request_entry.resource.data_cells_filter.name #=> String
527
553
  # resp.failures[0].request_entry.resource.lf_tag.catalog_id #=> String
528
554
  # resp.failures[0].request_entry.resource.lf_tag.tag_key #=> String
529
555
  # resp.failures[0].request_entry.resource.lf_tag.tag_values #=> Array
@@ -556,7 +582,7 @@ module Aws::LakeFormation
556
582
  # The identifier for the Data Catalog. By default, the account ID. The
557
583
  # Data Catalog is the persistent metadata store. It contains database
558
584
  # definitions, table definitions, and other control information to
559
- # manage your AWS Lake Formation environment.
585
+ # manage your Lake Formation environment.
560
586
  #
561
587
  # @option params [required, Array<Types::BatchPermissionsRequestEntry>] :entries
562
588
  # A list of up to 20 entries for resource permissions to be revoked by
@@ -603,6 +629,12 @@ module Aws::LakeFormation
603
629
  # catalog_id: "CatalogIdString",
604
630
  # resource_arn: "ResourceArnString", # required
605
631
  # },
632
+ # data_cells_filter: {
633
+ # table_catalog_id: "CatalogIdString",
634
+ # database_name: "NameString",
635
+ # table_name: "NameString",
636
+ # name: "NameString",
637
+ # },
606
638
  # lf_tag: {
607
639
  # catalog_id: "CatalogIdString",
608
640
  # tag_key: "NameString", # required
@@ -644,6 +676,10 @@ module Aws::LakeFormation
644
676
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
645
677
  # resp.failures[0].request_entry.resource.data_location.catalog_id #=> String
646
678
  # resp.failures[0].request_entry.resource.data_location.resource_arn #=> String
679
+ # resp.failures[0].request_entry.resource.data_cells_filter.table_catalog_id #=> String
680
+ # resp.failures[0].request_entry.resource.data_cells_filter.database_name #=> String
681
+ # resp.failures[0].request_entry.resource.data_cells_filter.table_name #=> String
682
+ # resp.failures[0].request_entry.resource.data_cells_filter.name #=> String
647
683
  # resp.failures[0].request_entry.resource.lf_tag.catalog_id #=> String
648
684
  # resp.failures[0].request_entry.resource.lf_tag.tag_key #=> String
649
685
  # resp.failures[0].request_entry.resource.lf_tag.tag_values #=> Array
@@ -670,16 +706,107 @@ module Aws::LakeFormation
670
706
  req.send_request(options)
671
707
  end
672
708
 
673
- # Creates a tag with the specified name and values.
709
+ # Attempts to cancel the specified transaction. Returns an exception if
710
+ # the transaction was previously committed.
711
+ #
712
+ # @option params [required, String] :transaction_id
713
+ # The transaction to cancel.
714
+ #
715
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
716
+ #
717
+ # @example Request syntax with placeholder values
718
+ #
719
+ # resp = client.cancel_transaction({
720
+ # transaction_id: "TransactionIdString", # required
721
+ # })
722
+ #
723
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/CancelTransaction AWS API Documentation
724
+ #
725
+ # @overload cancel_transaction(params = {})
726
+ # @param [Hash] params ({})
727
+ def cancel_transaction(params = {}, options = {})
728
+ req = build_request(:cancel_transaction, params)
729
+ req.send_request(options)
730
+ end
731
+
732
+ # Attempts to commit the specified transaction. Returns an exception if
733
+ # the transaction was previously aborted. This API action is idempotent
734
+ # if called multiple times for the same transaction.
735
+ #
736
+ # @option params [required, String] :transaction_id
737
+ # The transaction to commit.
738
+ #
739
+ # @return [Types::CommitTransactionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
740
+ #
741
+ # * {Types::CommitTransactionResponse#transaction_status #transaction_status} => String
742
+ #
743
+ # @example Request syntax with placeholder values
744
+ #
745
+ # resp = client.commit_transaction({
746
+ # transaction_id: "TransactionIdString", # required
747
+ # })
748
+ #
749
+ # @example Response structure
750
+ #
751
+ # resp.transaction_status #=> String, one of "ACTIVE", "COMMITTED", "ABORTED", "COMMIT_IN_PROGRESS"
752
+ #
753
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/CommitTransaction AWS API Documentation
754
+ #
755
+ # @overload commit_transaction(params = {})
756
+ # @param [Hash] params ({})
757
+ def commit_transaction(params = {}, options = {})
758
+ req = build_request(:commit_transaction, params)
759
+ req.send_request(options)
760
+ end
761
+
762
+ # Creates a data cell filter to allow one to grant access to certain
763
+ # columns on certain rows.
764
+ #
765
+ # @option params [required, Types::DataCellsFilter] :table_data
766
+ # A `DataCellsFilter` structure containing information about the data
767
+ # cells filter.
768
+ #
769
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
770
+ #
771
+ # @example Request syntax with placeholder values
772
+ #
773
+ # resp = client.create_data_cells_filter({
774
+ # table_data: { # required
775
+ # table_catalog_id: "CatalogIdString", # required
776
+ # database_name: "NameString", # required
777
+ # table_name: "NameString", # required
778
+ # name: "NameString", # required
779
+ # row_filter: {
780
+ # filter_expression: "PredicateString",
781
+ # all_rows_wildcard: {
782
+ # },
783
+ # },
784
+ # column_names: ["NameString"],
785
+ # column_wildcard: {
786
+ # excluded_column_names: ["NameString"],
787
+ # },
788
+ # },
789
+ # })
790
+ #
791
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/CreateDataCellsFilter AWS API Documentation
792
+ #
793
+ # @overload create_data_cells_filter(params = {})
794
+ # @param [Hash] params ({})
795
+ def create_data_cells_filter(params = {}, options = {})
796
+ req = build_request(:create_data_cells_filter, params)
797
+ req.send_request(options)
798
+ end
799
+
800
+ # Creates an LF-tag with the specified name and values.
674
801
  #
675
802
  # @option params [String] :catalog_id
676
803
  # The identifier for the Data Catalog. By default, the account ID. The
677
804
  # Data Catalog is the persistent metadata store. It contains database
678
805
  # definitions, table definitions, and other control information to
679
- # manage your AWS Lake Formation environment.
806
+ # manage your Lake Formation environment.
680
807
  #
681
808
  # @option params [required, String] :tag_key
682
- # The key-name for the tag.
809
+ # The key-name for the LF-tag.
683
810
  #
684
811
  # @option params [required, Array<String>] :tag_values
685
812
  # A list of possible values an attribute can take.
@@ -703,22 +830,56 @@ module Aws::LakeFormation
703
830
  req.send_request(options)
704
831
  end
705
832
 
706
- # Deletes the specified tag key name. If the attribute key does not
707
- # exist or the tag does not exist, then the operation will not do
833
+ # Deletes a data cell filter.
834
+ #
835
+ # @option params [String] :table_catalog_id
836
+ # The ID of the catalog to which the table belongs.
837
+ #
838
+ # @option params [String] :database_name
839
+ # A database in the Glue Data Catalog.
840
+ #
841
+ # @option params [String] :table_name
842
+ # A table in the database.
843
+ #
844
+ # @option params [String] :name
845
+ # The name given by the user to the data filter cell.
846
+ #
847
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
848
+ #
849
+ # @example Request syntax with placeholder values
850
+ #
851
+ # resp = client.delete_data_cells_filter({
852
+ # table_catalog_id: "CatalogIdString",
853
+ # database_name: "NameString",
854
+ # table_name: "NameString",
855
+ # name: "NameString",
856
+ # })
857
+ #
858
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/DeleteDataCellsFilter AWS API Documentation
859
+ #
860
+ # @overload delete_data_cells_filter(params = {})
861
+ # @param [Hash] params ({})
862
+ def delete_data_cells_filter(params = {}, options = {})
863
+ req = build_request(:delete_data_cells_filter, params)
864
+ req.send_request(options)
865
+ end
866
+
867
+ # Deletes the specified LF-tag key name. If the attribute key does not
868
+ # exist or the LF-tag does not exist, then the operation will not do
708
869
  # anything. If the attribute key exists, then the operation checks if
709
870
  # any resources are tagged with this attribute key, if yes, the API
710
871
  # throws a 400 Exception with the message "Delete not allowed" as the
711
- # tag key is still attached with resources. You can consider untagging
712
- # resources with this tag key.
872
+ # LF-tag key is still attached with resources. You can consider
873
+ # untagging resources with this LF-tag key.
713
874
  #
714
875
  # @option params [String] :catalog_id
715
876
  # The identifier for the Data Catalog. By default, the account ID. The
716
877
  # Data Catalog is the persistent metadata store. It contains database
717
878
  # definitions, table definitions, and other control information to
718
- # manage your AWS Lake Formation environment.
879
+ # manage your Lake Formation environment.
719
880
  #
720
881
  # @option params [required, String] :tag_key
721
- # The key-name for the tag to delete.
882
+ # The key-name for the LF-tag to delete.
722
883
  #
723
884
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
724
885
  #
@@ -738,6 +899,64 @@ module Aws::LakeFormation
738
899
  req.send_request(options)
739
900
  end
740
901
 
902
+ # For a specific governed table, provides a list of Amazon S3 objects
903
+ # that will be written during the current transaction and that can be
904
+ # automatically deleted if the transaction is canceled. Without this
905
+ # call, no Amazon S3 objects are automatically deleted when a
906
+ # transaction cancels.
907
+ #
908
+ # The Glue ETL library function `write_dynamic_frame.from_catalog()`
909
+ # includes an option to automatically call `DeleteObjectsOnCancel`
910
+ # before writes. For more information, see [Rolling Back Amazon S3
911
+ # Writes][1].
912
+ #
913
+ #
914
+ #
915
+ # [1]: https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html#rolling-back-writes
916
+ #
917
+ # @option params [String] :catalog_id
918
+ # The Glue data catalog that contains the governed table. Defaults to
919
+ # the current account ID.
920
+ #
921
+ # @option params [required, String] :database_name
922
+ # The database that contains the governed table.
923
+ #
924
+ # @option params [required, String] :table_name
925
+ # The name of the governed table.
926
+ #
927
+ # @option params [required, String] :transaction_id
928
+ # ID of the transaction that the writes occur in.
929
+ #
930
+ # @option params [required, Array<Types::VirtualObject>] :objects
931
+ # A list of VirtualObject structures, which indicates the Amazon S3
932
+ # objects to be deleted if the transaction cancels.
933
+ #
934
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
935
+ #
936
+ # @example Request syntax with placeholder values
937
+ #
938
+ # resp = client.delete_objects_on_cancel({
939
+ # catalog_id: "CatalogIdString",
940
+ # database_name: "NameString", # required
941
+ # table_name: "NameString", # required
942
+ # transaction_id: "TransactionIdString", # required
943
+ # objects: [ # required
944
+ # {
945
+ # uri: "URI", # required
946
+ # etag: "ETagString",
947
+ # },
948
+ # ],
949
+ # })
950
+ #
951
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/DeleteObjectsOnCancel AWS API Documentation
952
+ #
953
+ # @overload delete_objects_on_cancel(params = {})
954
+ # @param [Hash] params ({})
955
+ def delete_objects_on_cancel(params = {}, options = {})
956
+ req = build_request(:delete_objects_on_cancel, params)
957
+ req.send_request(options)
958
+ end
959
+
741
960
  # Deregisters the resource as managed by the Data Catalog.
742
961
  #
743
962
  # When you deregister a path, Lake Formation removes the path from the
@@ -765,7 +984,7 @@ module Aws::LakeFormation
765
984
  end
766
985
 
767
986
  # Retrieves the current data access role for the given resource
768
- # registered in AWS Lake Formation.
987
+ # registered in Lake Formation.
769
988
  #
770
989
  # @option params [required, String] :resource_arn
771
990
  # The resource ARN.
@@ -795,6 +1014,63 @@ module Aws::LakeFormation
795
1014
  req.send_request(options)
796
1015
  end
797
1016
 
1017
+ # Returns the details of a single transaction.
1018
+ #
1019
+ # @option params [required, String] :transaction_id
1020
+ # The transaction for which to return status.
1021
+ #
1022
+ # @return [Types::DescribeTransactionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1023
+ #
1024
+ # * {Types::DescribeTransactionResponse#transaction_description #transaction_description} => Types::TransactionDescription
1025
+ #
1026
+ # @example Request syntax with placeholder values
1027
+ #
1028
+ # resp = client.describe_transaction({
1029
+ # transaction_id: "TransactionIdString", # required
1030
+ # })
1031
+ #
1032
+ # @example Response structure
1033
+ #
1034
+ # resp.transaction_description.transaction_id #=> String
1035
+ # resp.transaction_description.transaction_status #=> String, one of "ACTIVE", "COMMITTED", "ABORTED", "COMMIT_IN_PROGRESS"
1036
+ # resp.transaction_description.transaction_start_time #=> Time
1037
+ # resp.transaction_description.transaction_end_time #=> Time
1038
+ #
1039
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/DescribeTransaction AWS API Documentation
1040
+ #
1041
+ # @overload describe_transaction(params = {})
1042
+ # @param [Hash] params ({})
1043
+ def describe_transaction(params = {}, options = {})
1044
+ req = build_request(:describe_transaction, params)
1045
+ req.send_request(options)
1046
+ end
1047
+
1048
+ # Indicates to the service that the specified transaction is still
1049
+ # active and should not be treated as idle and aborted.
1050
+ #
1051
+ # Write transactions that remain idle for a long period are
1052
+ # automatically aborted unless explicitly extended.
1053
+ #
1054
+ # @option params [String] :transaction_id
1055
+ # The transaction to extend.
1056
+ #
1057
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1058
+ #
1059
+ # @example Request syntax with placeholder values
1060
+ #
1061
+ # resp = client.extend_transaction({
1062
+ # transaction_id: "TransactionIdString",
1063
+ # })
1064
+ #
1065
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/ExtendTransaction AWS API Documentation
1066
+ #
1067
+ # @overload extend_transaction(params = {})
1068
+ # @param [Hash] params ({})
1069
+ def extend_transaction(params = {}, options = {})
1070
+ req = build_request(:extend_transaction, params)
1071
+ req.send_request(options)
1072
+ end
1073
+
798
1074
  # Retrieves the list of the data lake administrators of a Lake
799
1075
  # Formation-managed data lake.
800
1076
  #
@@ -802,7 +1078,7 @@ module Aws::LakeFormation
802
1078
  # The identifier for the Data Catalog. By default, the account ID. The
803
1079
  # Data Catalog is the persistent metadata store. It contains database
804
1080
  # definitions, table definitions, and other control information to
805
- # manage your AWS Lake Formation environment.
1081
+ # manage your Lake Formation environment.
806
1082
  #
807
1083
  # @return [Types::GetDataLakeSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
808
1084
  #
@@ -828,6 +1104,11 @@ module Aws::LakeFormation
828
1104
  # resp.data_lake_settings.create_table_default_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS", "CREATE_TAG", "ALTER_TAG", "DELETE_TAG", "DESCRIBE_TAG", "ASSOCIATE_TAG"
829
1105
  # resp.data_lake_settings.trusted_resource_owners #=> Array
830
1106
  # resp.data_lake_settings.trusted_resource_owners[0] #=> String
1107
+ # resp.data_lake_settings.allow_external_data_filtering #=> Boolean
1108
+ # resp.data_lake_settings.external_data_filtering_allow_list #=> Array
1109
+ # resp.data_lake_settings.external_data_filtering_allow_list[0].data_lake_principal_identifier #=> String
1110
+ # resp.data_lake_settings.authorized_session_tag_value_list #=> Array
1111
+ # resp.data_lake_settings.authorized_session_tag_value_list[0] #=> String
831
1112
  #
832
1113
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetDataLakeSettings AWS API Documentation
833
1114
  #
@@ -847,7 +1128,7 @@ module Aws::LakeFormation
847
1128
  # The identifier for the Data Catalog. By default, the account ID. The
848
1129
  # Data Catalog is the persistent metadata store. It contains database
849
1130
  # definitions, table definitions, and other control information to
850
- # manage your AWS Lake Formation environment.
1131
+ # manage your Lake Formation environment.
851
1132
  #
852
1133
  # @option params [required, String] :resource_arn
853
1134
  # The Amazon Resource Name (ARN) of the resource for which you want to
@@ -894,6 +1175,10 @@ module Aws::LakeFormation
894
1175
  # resp.permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
895
1176
  # resp.permissions[0].resource.data_location.catalog_id #=> String
896
1177
  # resp.permissions[0].resource.data_location.resource_arn #=> String
1178
+ # resp.permissions[0].resource.data_cells_filter.table_catalog_id #=> String
1179
+ # resp.permissions[0].resource.data_cells_filter.database_name #=> String
1180
+ # resp.permissions[0].resource.data_cells_filter.table_name #=> String
1181
+ # resp.permissions[0].resource.data_cells_filter.name #=> String
897
1182
  # resp.permissions[0].resource.lf_tag.catalog_id #=> String
898
1183
  # resp.permissions[0].resource.lf_tag.tag_key #=> String
899
1184
  # resp.permissions[0].resource.lf_tag.tag_values #=> Array
@@ -921,16 +1206,16 @@ module Aws::LakeFormation
921
1206
  req.send_request(options)
922
1207
  end
923
1208
 
924
- # Returns a tag definition.
1209
+ # Returns an LF-tag definition.
925
1210
  #
926
1211
  # @option params [String] :catalog_id
927
1212
  # The identifier for the Data Catalog. By default, the account ID. The
928
1213
  # Data Catalog is the persistent metadata store. It contains database
929
1214
  # definitions, table definitions, and other control information to
930
- # manage your AWS Lake Formation environment.
1215
+ # manage your Lake Formation environment.
931
1216
  #
932
1217
  # @option params [required, String] :tag_key
933
- # The key-name for the tag.
1218
+ # The key-name for the LF-tag.
934
1219
  #
935
1220
  # @return [Types::GetLFTagResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
936
1221
  #
@@ -961,19 +1246,91 @@ module Aws::LakeFormation
961
1246
  req.send_request(options)
962
1247
  end
963
1248
 
964
- # Returns the tags applied to a resource.
1249
+ # Returns the state of a query previously submitted. Clients are
1250
+ # expected to poll `GetQueryState` to monitor the current state of the
1251
+ # planning before retrieving the work units. A query state is only
1252
+ # visible to the principal that made the initial call to
1253
+ # `StartQueryPlanning`.
1254
+ #
1255
+ # @option params [required, String] :query_id
1256
+ # The ID of the plan query operation.
1257
+ #
1258
+ # @return [Types::GetQueryStateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1259
+ #
1260
+ # * {Types::GetQueryStateResponse#error #error} => String
1261
+ # * {Types::GetQueryStateResponse#state #state} => String
1262
+ #
1263
+ # @example Request syntax with placeholder values
1264
+ #
1265
+ # resp = client.get_query_state({
1266
+ # query_id: "GetQueryStateRequestQueryIdString", # required
1267
+ # })
1268
+ #
1269
+ # @example Response structure
1270
+ #
1271
+ # resp.error #=> String
1272
+ # resp.state #=> String, one of "PENDING", "WORKUNITS_AVAILABLE", "ERROR", "FINISHED", "EXPIRED"
1273
+ #
1274
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetQueryState AWS API Documentation
1275
+ #
1276
+ # @overload get_query_state(params = {})
1277
+ # @param [Hash] params ({})
1278
+ def get_query_state(params = {}, options = {})
1279
+ req = build_request(:get_query_state, params)
1280
+ req.send_request(options)
1281
+ end
1282
+
1283
+ # Retrieves statistics on the planning and execution of a query.
1284
+ #
1285
+ # @option params [required, String] :query_id
1286
+ # The ID of the plan query operation.
1287
+ #
1288
+ # @return [Types::GetQueryStatisticsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1289
+ #
1290
+ # * {Types::GetQueryStatisticsResponse#execution_statistics #execution_statistics} => Types::ExecutionStatistics
1291
+ # * {Types::GetQueryStatisticsResponse#planning_statistics #planning_statistics} => Types::PlanningStatistics
1292
+ # * {Types::GetQueryStatisticsResponse#query_submission_time #query_submission_time} => Time
1293
+ #
1294
+ # @example Request syntax with placeholder values
1295
+ #
1296
+ # resp = client.get_query_statistics({
1297
+ # query_id: "GetQueryStatisticsRequestQueryIdString", # required
1298
+ # })
1299
+ #
1300
+ # @example Response structure
1301
+ #
1302
+ # resp.execution_statistics.average_execution_time_millis #=> Integer
1303
+ # resp.execution_statistics.data_scanned_bytes #=> Integer
1304
+ # resp.execution_statistics.work_units_executed_count #=> Integer
1305
+ # resp.planning_statistics.estimated_data_to_scan_bytes #=> Integer
1306
+ # resp.planning_statistics.planning_time_millis #=> Integer
1307
+ # resp.planning_statistics.queue_time_millis #=> Integer
1308
+ # resp.planning_statistics.work_units_generated_count #=> Integer
1309
+ # resp.query_submission_time #=> Time
1310
+ #
1311
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetQueryStatistics AWS API Documentation
1312
+ #
1313
+ # @overload get_query_statistics(params = {})
1314
+ # @param [Hash] params ({})
1315
+ def get_query_statistics(params = {}, options = {})
1316
+ req = build_request(:get_query_statistics, params)
1317
+ req.send_request(options)
1318
+ end
1319
+
1320
+ # Returns the LF-tags applied to a resource.
965
1321
  #
966
1322
  # @option params [String] :catalog_id
967
1323
  # The identifier for the Data Catalog. By default, the account ID. The
968
1324
  # Data Catalog is the persistent metadata store. It contains database
969
1325
  # definitions, table definitions, and other control information to
970
- # manage your AWS Lake Formation environment.
1326
+ # manage your Lake Formation environment.
971
1327
  #
972
1328
  # @option params [required, Types::Resource] :resource
973
- # The resource for which you want to return tags.
1329
+ # The database, table, or column resource for which you want to return
1330
+ # LF-tags.
974
1331
  #
975
1332
  # @option params [Boolean] :show_assigned_lf_tags
976
- # Indicates whether to show the assigned tags.
1333
+ # Indicates whether to show the assigned LF-tags.
977
1334
  #
978
1335
  # @return [Types::GetResourceLFTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
979
1336
  #
@@ -1012,6 +1369,12 @@ module Aws::LakeFormation
1012
1369
  # catalog_id: "CatalogIdString",
1013
1370
  # resource_arn: "ResourceArnString", # required
1014
1371
  # },
1372
+ # data_cells_filter: {
1373
+ # table_catalog_id: "CatalogIdString",
1374
+ # database_name: "NameString",
1375
+ # table_name: "NameString",
1376
+ # name: "NameString",
1377
+ # },
1015
1378
  # lf_tag: {
1016
1379
  # catalog_id: "CatalogIdString",
1017
1380
  # tag_key: "NameString", # required
@@ -1060,6 +1423,308 @@ module Aws::LakeFormation
1060
1423
  req.send_request(options)
1061
1424
  end
1062
1425
 
1426
+ # Returns the set of Amazon S3 objects that make up the specified
1427
+ # governed table. A transaction ID or timestamp can be specified for
1428
+ # time-travel queries.
1429
+ #
1430
+ # @option params [String] :catalog_id
1431
+ # The catalog containing the governed table. Defaults to the caller’s
1432
+ # account.
1433
+ #
1434
+ # @option params [required, String] :database_name
1435
+ # The database containing the governed table.
1436
+ #
1437
+ # @option params [required, String] :table_name
1438
+ # The governed table for which to retrieve objects.
1439
+ #
1440
+ # @option params [String] :transaction_id
1441
+ # The transaction ID at which to read the governed table contents. If
1442
+ # this transaction has aborted, an error is returned. If not set,
1443
+ # defaults to the most recent committed transaction. Cannot be specified
1444
+ # along with `QueryAsOfTime`.
1445
+ #
1446
+ # @option params [Time,DateTime,Date,Integer,String] :query_as_of_time
1447
+ # The time as of when to read the governed table contents. If not set,
1448
+ # the most recent transaction commit time is used. Cannot be specified
1449
+ # along with `TransactionId`.
1450
+ #
1451
+ # @option params [String] :partition_predicate
1452
+ # A predicate to filter the objects returned based on the partition keys
1453
+ # defined in the governed table.
1454
+ #
1455
+ # * The comparison operators supported are: =, &gt;, &lt;, &gt;=, &lt;=
1456
+ #
1457
+ # * The logical operators supported are: AND
1458
+ #
1459
+ # * The data types supported are integer, long, date(yyyy-MM-dd),
1460
+ # timestamp(yyyy-MM-dd HH:mm:ssXXX or yyyy-MM-dd HH:mm:ss"), string
1461
+ # and decimal.
1462
+ #
1463
+ # @option params [Integer] :max_results
1464
+ # Specifies how many values to return in a page.
1465
+ #
1466
+ # @option params [String] :next_token
1467
+ # A continuation token if this is not the first call to retrieve these
1468
+ # objects.
1469
+ #
1470
+ # @return [Types::GetTableObjectsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1471
+ #
1472
+ # * {Types::GetTableObjectsResponse#objects #objects} => Array&lt;Types::PartitionObjects&gt;
1473
+ # * {Types::GetTableObjectsResponse#next_token #next_token} => String
1474
+ #
1475
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1476
+ #
1477
+ # @example Request syntax with placeholder values
1478
+ #
1479
+ # resp = client.get_table_objects({
1480
+ # catalog_id: "CatalogIdString",
1481
+ # database_name: "NameString", # required
1482
+ # table_name: "NameString", # required
1483
+ # transaction_id: "TransactionIdString",
1484
+ # query_as_of_time: Time.now,
1485
+ # partition_predicate: "PredicateString",
1486
+ # max_results: 1,
1487
+ # next_token: "TokenString",
1488
+ # })
1489
+ #
1490
+ # @example Response structure
1491
+ #
1492
+ # resp.objects #=> Array
1493
+ # resp.objects[0].partition_values #=> Array
1494
+ # resp.objects[0].partition_values[0] #=> String
1495
+ # resp.objects[0].objects #=> Array
1496
+ # resp.objects[0].objects[0].uri #=> String
1497
+ # resp.objects[0].objects[0].etag #=> String
1498
+ # resp.objects[0].objects[0].size #=> Integer
1499
+ # resp.next_token #=> String
1500
+ #
1501
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetTableObjects AWS API Documentation
1502
+ #
1503
+ # @overload get_table_objects(params = {})
1504
+ # @param [Hash] params ({})
1505
+ def get_table_objects(params = {}, options = {})
1506
+ req = build_request(:get_table_objects, params)
1507
+ req.send_request(options)
1508
+ end
1509
+
1510
+ # This API is identical to `GetTemporaryTableCredentials` except that
1511
+ # this is used when the target Data Catalog resource is of type
1512
+ # Partition. Lake Formation restricts the permission of the vended
1513
+ # credentials with the same scope down policy which restricts access to
1514
+ # a single Amazon S3 prefix.
1515
+ #
1516
+ # @option params [required, String] :table_arn
1517
+ # The ARN of the partitions' table.
1518
+ #
1519
+ # @option params [required, Types::PartitionValueList] :partition
1520
+ # A list of partition values identifying a single partition.
1521
+ #
1522
+ # @option params [Array<String>] :permissions
1523
+ # Filters the request based on the user having been granted a list of
1524
+ # specified permissions on the requested resource(s).
1525
+ #
1526
+ # @option params [Integer] :duration_seconds
1527
+ # The time period, between 900 and 21,600 seconds, for the timeout of
1528
+ # the temporary credentials.
1529
+ #
1530
+ # @option params [Types::AuditContext] :audit_context
1531
+ # A structure representing context to access a resource (column names,
1532
+ # query ID, etc).
1533
+ #
1534
+ # @option params [required, Array<String>] :supported_permission_types
1535
+ # A list of supported permission types for the partition. Valid values
1536
+ # are `COLUMN_PERMISSION` and `CELL_FILTER_PERMISSION`.
1537
+ #
1538
+ # @return [Types::GetTemporaryGluePartitionCredentialsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1539
+ #
1540
+ # * {Types::GetTemporaryGluePartitionCredentialsResponse#access_key_id #access_key_id} => String
1541
+ # * {Types::GetTemporaryGluePartitionCredentialsResponse#secret_access_key #secret_access_key} => String
1542
+ # * {Types::GetTemporaryGluePartitionCredentialsResponse#session_token #session_token} => String
1543
+ # * {Types::GetTemporaryGluePartitionCredentialsResponse#expiration #expiration} => Time
1544
+ #
1545
+ # @example Request syntax with placeholder values
1546
+ #
1547
+ # resp = client.get_temporary_glue_partition_credentials({
1548
+ # table_arn: "ResourceArnString", # required
1549
+ # partition: { # required
1550
+ # values: ["ValueString"], # required
1551
+ # },
1552
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS, CREATE_TAG, ALTER_TAG, DELETE_TAG, DESCRIBE_TAG, ASSOCIATE_TAG
1553
+ # duration_seconds: 1,
1554
+ # audit_context: {
1555
+ # additional_audit_context: "AuditContextString",
1556
+ # },
1557
+ # supported_permission_types: ["COLUMN_PERMISSION"], # required, accepts COLUMN_PERMISSION, CELL_FILTER_PERMISSION
1558
+ # })
1559
+ #
1560
+ # @example Response structure
1561
+ #
1562
+ # resp.access_key_id #=> String
1563
+ # resp.secret_access_key #=> String
1564
+ # resp.session_token #=> String
1565
+ # resp.expiration #=> Time
1566
+ #
1567
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetTemporaryGluePartitionCredentials AWS API Documentation
1568
+ #
1569
+ # @overload get_temporary_glue_partition_credentials(params = {})
1570
+ # @param [Hash] params ({})
1571
+ def get_temporary_glue_partition_credentials(params = {}, options = {})
1572
+ req = build_request(:get_temporary_glue_partition_credentials, params)
1573
+ req.send_request(options)
1574
+ end
1575
+
1576
+ # Allows a caller in a secure environment to assume a role with
1577
+ # permission to access Amazon S3. In order to vend such credentials,
1578
+ # Lake Formation assumes the role associated with a registered location,
1579
+ # for example an Amazon S3 bucket, with a scope down policy which
1580
+ # restricts the access to a single prefix.
1581
+ #
1582
+ # @option params [required, String] :table_arn
1583
+ # The ARN identifying a table in the Data Catalog for the temporary
1584
+ # credentials request.
1585
+ #
1586
+ # @option params [Array<String>] :permissions
1587
+ # Filters the request based on the user having been granted a list of
1588
+ # specified permissions on the requested resource(s).
1589
+ #
1590
+ # @option params [Integer] :duration_seconds
1591
+ # The time period, between 900 and 21,600 seconds, for the timeout of
1592
+ # the temporary credentials.
1593
+ #
1594
+ # @option params [Types::AuditContext] :audit_context
1595
+ # A structure representing context to access a resource (column names,
1596
+ # query ID, etc).
1597
+ #
1598
+ # @option params [required, Array<String>] :supported_permission_types
1599
+ # A list of supported permission types for the table. Valid values are
1600
+ # `COLUMN_PERMISSION` and `CELL_FILTER_PERMISSION`.
1601
+ #
1602
+ # @return [Types::GetTemporaryGlueTableCredentialsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1603
+ #
1604
+ # * {Types::GetTemporaryGlueTableCredentialsResponse#access_key_id #access_key_id} => String
1605
+ # * {Types::GetTemporaryGlueTableCredentialsResponse#secret_access_key #secret_access_key} => String
1606
+ # * {Types::GetTemporaryGlueTableCredentialsResponse#session_token #session_token} => String
1607
+ # * {Types::GetTemporaryGlueTableCredentialsResponse#expiration #expiration} => Time
1608
+ #
1609
+ # @example Request syntax with placeholder values
1610
+ #
1611
+ # resp = client.get_temporary_glue_table_credentials({
1612
+ # table_arn: "ResourceArnString", # required
1613
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS, CREATE_TAG, ALTER_TAG, DELETE_TAG, DESCRIBE_TAG, ASSOCIATE_TAG
1614
+ # duration_seconds: 1,
1615
+ # audit_context: {
1616
+ # additional_audit_context: "AuditContextString",
1617
+ # },
1618
+ # supported_permission_types: ["COLUMN_PERMISSION"], # required, accepts COLUMN_PERMISSION, CELL_FILTER_PERMISSION
1619
+ # })
1620
+ #
1621
+ # @example Response structure
1622
+ #
1623
+ # resp.access_key_id #=> String
1624
+ # resp.secret_access_key #=> String
1625
+ # resp.session_token #=> String
1626
+ # resp.expiration #=> Time
1627
+ #
1628
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetTemporaryGlueTableCredentials AWS API Documentation
1629
+ #
1630
+ # @overload get_temporary_glue_table_credentials(params = {})
1631
+ # @param [Hash] params ({})
1632
+ def get_temporary_glue_table_credentials(params = {}, options = {})
1633
+ req = build_request(:get_temporary_glue_table_credentials, params)
1634
+ req.send_request(options)
1635
+ end
1636
+
1637
+ # Returns the work units resulting from the query. Work units can be
1638
+ # executed in any order and in parallel.
1639
+ #
1640
+ # @option params [required, String] :query_id
1641
+ # The ID of the plan query operation for which to get results.
1642
+ #
1643
+ # @option params [required, Integer] :work_unit_id
1644
+ # The work unit ID for which to get results. Value generated by
1645
+ # enumerating `WorkUnitIdMin` to `WorkUnitIdMax` (inclusive) from the
1646
+ # `WorkUnitRange` in the output of `GetWorkUnits`.
1647
+ #
1648
+ # @option params [required, String] :work_unit_token
1649
+ # A work token used to query the execution service. Token output from
1650
+ # `GetWorkUnits`.
1651
+ #
1652
+ # @return [Types::GetWorkUnitResultsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1653
+ #
1654
+ # * {Types::GetWorkUnitResultsResponse#result_stream #result_stream} => IO
1655
+ #
1656
+ # @example Request syntax with placeholder values
1657
+ #
1658
+ # resp = client.get_work_unit_results({
1659
+ # query_id: "GetWorkUnitResultsRequestQueryIdString", # required
1660
+ # work_unit_id: 1, # required
1661
+ # work_unit_token: "SyntheticGetWorkUnitResultsRequestWorkUnitTokenString", # required
1662
+ # })
1663
+ #
1664
+ # @example Response structure
1665
+ #
1666
+ # resp.result_stream #=> IO
1667
+ #
1668
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetWorkUnitResults AWS API Documentation
1669
+ #
1670
+ # @overload get_work_unit_results(params = {})
1671
+ # @param [Hash] params ({})
1672
+ def get_work_unit_results(params = {}, options = {}, &block)
1673
+ req = build_request(:get_work_unit_results, params)
1674
+ req.send_request(options, &block)
1675
+ end
1676
+
1677
+ # Retrieves the work units generated by the `StartQueryPlanning`
1678
+ # operation.
1679
+ #
1680
+ # @option params [String] :next_token
1681
+ # A continuation token, if this is a continuation call.
1682
+ #
1683
+ # @option params [Integer] :page_size
1684
+ # The size of each page to get in the Amazon Web Services service call.
1685
+ # This does not affect the number of items returned in the command's
1686
+ # output. Setting a smaller page size results in more calls to the
1687
+ # Amazon Web Services service, retrieving fewer items in each call. This
1688
+ # can help prevent the Amazon Web Services service calls from timing
1689
+ # out.
1690
+ #
1691
+ # @option params [required, String] :query_id
1692
+ # The ID of the plan query operation.
1693
+ #
1694
+ # @return [Types::GetWorkUnitsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1695
+ #
1696
+ # * {Types::GetWorkUnitsResponse#next_token #next_token} => String
1697
+ # * {Types::GetWorkUnitsResponse#query_id #query_id} => String
1698
+ # * {Types::GetWorkUnitsResponse#work_unit_ranges #work_unit_ranges} => Array&lt;Types::WorkUnitRange&gt;
1699
+ #
1700
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1701
+ #
1702
+ # @example Request syntax with placeholder values
1703
+ #
1704
+ # resp = client.get_work_units({
1705
+ # next_token: "Token",
1706
+ # page_size: 1,
1707
+ # query_id: "GetWorkUnitsRequestQueryIdString", # required
1708
+ # })
1709
+ #
1710
+ # @example Response structure
1711
+ #
1712
+ # resp.next_token #=> String
1713
+ # resp.query_id #=> String
1714
+ # resp.work_unit_ranges #=> Array
1715
+ # resp.work_unit_ranges[0].work_unit_id_max #=> Integer
1716
+ # resp.work_unit_ranges[0].work_unit_id_min #=> Integer
1717
+ # resp.work_unit_ranges[0].work_unit_token #=> String
1718
+ #
1719
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetWorkUnits AWS API Documentation
1720
+ #
1721
+ # @overload get_work_units(params = {})
1722
+ # @param [Hash] params ({})
1723
+ def get_work_units(params = {}, options = {})
1724
+ req = build_request(:get_work_units, params)
1725
+ req.send_request(options)
1726
+ end
1727
+
1063
1728
  # Grants permissions to the principal to access metadata in the Data
1064
1729
  # Catalog and data organized in underlying data storage such as Amazon
1065
1730
  # S3.
@@ -1075,7 +1740,7 @@ module Aws::LakeFormation
1075
1740
  # The identifier for the Data Catalog. By default, the account ID. The
1076
1741
  # Data Catalog is the persistent metadata store. It contains database
1077
1742
  # definitions, table definitions, and other control information to
1078
- # manage your AWS Lake Formation environment.
1743
+ # manage your Lake Formation environment.
1079
1744
  #
1080
1745
  # @option params [required, Types::DataLakePrincipal] :principal
1081
1746
  # The principal to be granted the permissions on the resource. Supported
@@ -1087,15 +1752,15 @@ module Aws::LakeFormation
1087
1752
  # maintains the permissions already granted.
1088
1753
  #
1089
1754
  # @option params [required, Types::Resource] :resource
1090
- # The resource to which permissions are to be granted. Resources in AWS
1091
- # Lake Formation are the Data Catalog, databases, and tables.
1755
+ # The resource to which permissions are to be granted. Resources in Lake
1756
+ # Formation are the Data Catalog, databases, and tables.
1092
1757
  #
1093
1758
  # @option params [required, Array<String>] :permissions
1094
- # The permissions granted to the principal on the resource. AWS Lake
1759
+ # The permissions granted to the principal on the resource. Lake
1095
1760
  # Formation defines privileges to grant and revoke access to metadata in
1096
1761
  # the Data Catalog and data organized in underlying data storage such as
1097
- # Amazon S3. AWS Lake Formation requires that each principal be
1098
- # authorized to perform a specific task on AWS Lake Formation resources.
1762
+ # Amazon S3. Lake Formation requires that each principal be authorized
1763
+ # to perform a specific task on Lake Formation resources.
1099
1764
  #
1100
1765
  # @option params [Array<String>] :permissions_with_grant_option
1101
1766
  # Indicates a list of the granted permissions that the principal may
@@ -1138,6 +1803,12 @@ module Aws::LakeFormation
1138
1803
  # catalog_id: "CatalogIdString",
1139
1804
  # resource_arn: "ResourceArnString", # required
1140
1805
  # },
1806
+ # data_cells_filter: {
1807
+ # table_catalog_id: "CatalogIdString",
1808
+ # database_name: "NameString",
1809
+ # table_name: "NameString",
1810
+ # name: "NameString",
1811
+ # },
1141
1812
  # lf_tag: {
1142
1813
  # catalog_id: "CatalogIdString",
1143
1814
  # tag_key: "NameString", # required
@@ -1167,20 +1838,75 @@ module Aws::LakeFormation
1167
1838
  req.send_request(options)
1168
1839
  end
1169
1840
 
1170
- # Lists tags that the requester has permission to view.
1841
+ # Lists all the data cell filters on a table.
1842
+ #
1843
+ # @option params [Types::TableResource] :table
1844
+ # A table in the Glue Data Catalog.
1845
+ #
1846
+ # @option params [String] :next_token
1847
+ # A continuation token, if this is a continuation call.
1848
+ #
1849
+ # @option params [Integer] :max_results
1850
+ # The maximum size of the response.
1851
+ #
1852
+ # @return [Types::ListDataCellsFilterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1853
+ #
1854
+ # * {Types::ListDataCellsFilterResponse#data_cells_filters #data_cells_filters} => Array&lt;Types::DataCellsFilter&gt;
1855
+ # * {Types::ListDataCellsFilterResponse#next_token #next_token} => String
1856
+ #
1857
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1858
+ #
1859
+ # @example Request syntax with placeholder values
1860
+ #
1861
+ # resp = client.list_data_cells_filter({
1862
+ # table: {
1863
+ # catalog_id: "CatalogIdString",
1864
+ # database_name: "NameString", # required
1865
+ # name: "NameString",
1866
+ # table_wildcard: {
1867
+ # },
1868
+ # },
1869
+ # next_token: "Token",
1870
+ # max_results: 1,
1871
+ # })
1872
+ #
1873
+ # @example Response structure
1874
+ #
1875
+ # resp.data_cells_filters #=> Array
1876
+ # resp.data_cells_filters[0].table_catalog_id #=> String
1877
+ # resp.data_cells_filters[0].database_name #=> String
1878
+ # resp.data_cells_filters[0].table_name #=> String
1879
+ # resp.data_cells_filters[0].name #=> String
1880
+ # resp.data_cells_filters[0].row_filter.filter_expression #=> String
1881
+ # resp.data_cells_filters[0].column_names #=> Array
1882
+ # resp.data_cells_filters[0].column_names[0] #=> String
1883
+ # resp.data_cells_filters[0].column_wildcard.excluded_column_names #=> Array
1884
+ # resp.data_cells_filters[0].column_wildcard.excluded_column_names[0] #=> String
1885
+ # resp.next_token #=> String
1886
+ #
1887
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/ListDataCellsFilter AWS API Documentation
1888
+ #
1889
+ # @overload list_data_cells_filter(params = {})
1890
+ # @param [Hash] params ({})
1891
+ def list_data_cells_filter(params = {}, options = {})
1892
+ req = build_request(:list_data_cells_filter, params)
1893
+ req.send_request(options)
1894
+ end
1895
+
1896
+ # Lists LF-tags that the requester has permission to view.
1171
1897
  #
1172
1898
  # @option params [String] :catalog_id
1173
1899
  # The identifier for the Data Catalog. By default, the account ID. The
1174
1900
  # Data Catalog is the persistent metadata store. It contains database
1175
1901
  # definitions, table definitions, and other control information to
1176
- # manage your AWS Lake Formation environment.
1902
+ # manage your Lake Formation environment.
1177
1903
  #
1178
1904
  # @option params [String] :resource_share_type
1179
- # If resource share type is `ALL`, returns both in-account tags and
1180
- # shared tags that the requester has permission to view. If resource
1181
- # share type is `FOREIGN`, returns all share tags that the requester can
1182
- # view. If no resource share type is passed, lists tags in the given
1183
- # catalog ID that the requester has permission to view.
1905
+ # If resource share type is `ALL`, returns both in-account LF-tags and
1906
+ # shared LF-tags that the requester has permission to view. If resource
1907
+ # share type is `FOREIGN`, returns all share LF-tags that the requester
1908
+ # can view. If no resource share type is passed, lists LF-tags in the
1909
+ # given catalog ID that the requester has permission to view.
1184
1910
  #
1185
1911
  # @option params [Integer] :max_results
1186
1912
  # The maximum number of results to return.
@@ -1194,6 +1920,8 @@ module Aws::LakeFormation
1194
1920
  # * {Types::ListLFTagsResponse#lf_tags #lf_tags} => Array&lt;Types::LFTagPair&gt;
1195
1921
  # * {Types::ListLFTagsResponse#next_token #next_token} => String
1196
1922
  #
1923
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1924
+ #
1197
1925
  # @example Request syntax with placeholder values
1198
1926
  #
1199
1927
  # resp = client.list_lf_tags({
@@ -1240,7 +1968,7 @@ module Aws::LakeFormation
1240
1968
  # The identifier for the Data Catalog. By default, the account ID. The
1241
1969
  # Data Catalog is the persistent metadata store. It contains database
1242
1970
  # definitions, table definitions, and other control information to
1243
- # manage your AWS Lake Formation environment.
1971
+ # manage your Lake Formation environment.
1244
1972
  #
1245
1973
  # @option params [Types::DataLakePrincipal] :principal
1246
1974
  # Specifies a principal to filter the permissions returned.
@@ -1262,6 +1990,9 @@ module Aws::LakeFormation
1262
1990
  # @option params [Integer] :max_results
1263
1991
  # The maximum number of results to return.
1264
1992
  #
1993
+ # @option params [String] :include_related
1994
+ # Indicates that related permissions should be included in the results.
1995
+ #
1265
1996
  # @return [Types::ListPermissionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1266
1997
  #
1267
1998
  # * {Types::ListPermissionsResponse#principal_resource_permissions #principal_resource_permissions} => Array&lt;Types::PrincipalResourcePermissions&gt;
@@ -1304,6 +2035,12 @@ module Aws::LakeFormation
1304
2035
  # catalog_id: "CatalogIdString",
1305
2036
  # resource_arn: "ResourceArnString", # required
1306
2037
  # },
2038
+ # data_cells_filter: {
2039
+ # table_catalog_id: "CatalogIdString",
2040
+ # database_name: "NameString",
2041
+ # table_name: "NameString",
2042
+ # name: "NameString",
2043
+ # },
1307
2044
  # lf_tag: {
1308
2045
  # catalog_id: "CatalogIdString",
1309
2046
  # tag_key: "NameString", # required
@@ -1322,6 +2059,7 @@ module Aws::LakeFormation
1322
2059
  # },
1323
2060
  # next_token: "Token",
1324
2061
  # max_results: 1,
2062
+ # include_related: "TrueFalseString",
1325
2063
  # })
1326
2064
  #
1327
2065
  # @example Response structure
@@ -1342,6 +2080,10 @@ module Aws::LakeFormation
1342
2080
  # resp.principal_resource_permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
1343
2081
  # resp.principal_resource_permissions[0].resource.data_location.catalog_id #=> String
1344
2082
  # resp.principal_resource_permissions[0].resource.data_location.resource_arn #=> String
2083
+ # resp.principal_resource_permissions[0].resource.data_cells_filter.table_catalog_id #=> String
2084
+ # resp.principal_resource_permissions[0].resource.data_cells_filter.database_name #=> String
2085
+ # resp.principal_resource_permissions[0].resource.data_cells_filter.table_name #=> String
2086
+ # resp.principal_resource_permissions[0].resource.data_cells_filter.name #=> String
1345
2087
  # resp.principal_resource_permissions[0].resource.lf_tag.catalog_id #=> String
1346
2088
  # resp.principal_resource_permissions[0].resource.lf_tag.tag_key #=> String
1347
2089
  # resp.principal_resource_permissions[0].resource.lf_tag.tag_values #=> Array
@@ -1420,6 +2162,123 @@ module Aws::LakeFormation
1420
2162
  req.send_request(options)
1421
2163
  end
1422
2164
 
2165
+ # Returns the configuration of all storage optimizers associated with a
2166
+ # specified table.
2167
+ #
2168
+ # @option params [String] :catalog_id
2169
+ # The Catalog ID of the table.
2170
+ #
2171
+ # @option params [required, String] :database_name
2172
+ # Name of the database where the table is present.
2173
+ #
2174
+ # @option params [required, String] :table_name
2175
+ # Name of the table.
2176
+ #
2177
+ # @option params [String] :storage_optimizer_type
2178
+ # The specific type of storage optimizers to list. The supported value
2179
+ # is `compaction`.
2180
+ #
2181
+ # @option params [Integer] :max_results
2182
+ # The number of storage optimizers to return on each call.
2183
+ #
2184
+ # @option params [String] :next_token
2185
+ # A continuation token, if this is a continuation call.
2186
+ #
2187
+ # @return [Types::ListTableStorageOptimizersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2188
+ #
2189
+ # * {Types::ListTableStorageOptimizersResponse#storage_optimizer_list #storage_optimizer_list} => Array&lt;Types::StorageOptimizer&gt;
2190
+ # * {Types::ListTableStorageOptimizersResponse#next_token #next_token} => String
2191
+ #
2192
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2193
+ #
2194
+ # @example Request syntax with placeholder values
2195
+ #
2196
+ # resp = client.list_table_storage_optimizers({
2197
+ # catalog_id: "CatalogIdString",
2198
+ # database_name: "NameString", # required
2199
+ # table_name: "NameString", # required
2200
+ # storage_optimizer_type: "COMPACTION", # accepts COMPACTION, GARBAGE_COLLECTION, ALL
2201
+ # max_results: 1,
2202
+ # next_token: "Token",
2203
+ # })
2204
+ #
2205
+ # @example Response structure
2206
+ #
2207
+ # resp.storage_optimizer_list #=> Array
2208
+ # resp.storage_optimizer_list[0].storage_optimizer_type #=> String, one of "COMPACTION", "GARBAGE_COLLECTION", "ALL"
2209
+ # resp.storage_optimizer_list[0].config #=> Hash
2210
+ # resp.storage_optimizer_list[0].config["StorageOptimizerConfigKey"] #=> String
2211
+ # resp.storage_optimizer_list[0].error_message #=> String
2212
+ # resp.storage_optimizer_list[0].warnings #=> String
2213
+ # resp.storage_optimizer_list[0].last_run_details #=> String
2214
+ # resp.next_token #=> String
2215
+ #
2216
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/ListTableStorageOptimizers AWS API Documentation
2217
+ #
2218
+ # @overload list_table_storage_optimizers(params = {})
2219
+ # @param [Hash] params ({})
2220
+ def list_table_storage_optimizers(params = {}, options = {})
2221
+ req = build_request(:list_table_storage_optimizers, params)
2222
+ req.send_request(options)
2223
+ end
2224
+
2225
+ # Returns metadata about transactions and their status. To prevent the
2226
+ # response from growing indefinitely, only uncommitted transactions and
2227
+ # those available for time-travel queries are returned.
2228
+ #
2229
+ # This operation can help you identify uncommitted transactions or to
2230
+ # get information about transactions.
2231
+ #
2232
+ # @option params [String] :catalog_id
2233
+ # The catalog for which to list transactions. Defaults to the account ID
2234
+ # of the caller.
2235
+ #
2236
+ # @option params [String] :status_filter
2237
+ # A filter indicating the status of transactions to return. Options are
2238
+ # ALL \| COMPLETED \| COMMITTED \| ABORTED \| ACTIVE. The default is
2239
+ # `ALL`.
2240
+ #
2241
+ # @option params [Integer] :max_results
2242
+ # The maximum number of transactions to return in a single call.
2243
+ #
2244
+ # @option params [String] :next_token
2245
+ # A continuation token if this is not the first call to retrieve
2246
+ # transactions.
2247
+ #
2248
+ # @return [Types::ListTransactionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2249
+ #
2250
+ # * {Types::ListTransactionsResponse#transactions #transactions} => Array&lt;Types::TransactionDescription&gt;
2251
+ # * {Types::ListTransactionsResponse#next_token #next_token} => String
2252
+ #
2253
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2254
+ #
2255
+ # @example Request syntax with placeholder values
2256
+ #
2257
+ # resp = client.list_transactions({
2258
+ # catalog_id: "CatalogIdString",
2259
+ # status_filter: "ALL", # accepts ALL, COMPLETED, ACTIVE, COMMITTED, ABORTED
2260
+ # max_results: 1,
2261
+ # next_token: "TokenString",
2262
+ # })
2263
+ #
2264
+ # @example Response structure
2265
+ #
2266
+ # resp.transactions #=> Array
2267
+ # resp.transactions[0].transaction_id #=> String
2268
+ # resp.transactions[0].transaction_status #=> String, one of "ACTIVE", "COMMITTED", "ABORTED", "COMMIT_IN_PROGRESS"
2269
+ # resp.transactions[0].transaction_start_time #=> Time
2270
+ # resp.transactions[0].transaction_end_time #=> Time
2271
+ # resp.next_token #=> String
2272
+ #
2273
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/ListTransactions AWS API Documentation
2274
+ #
2275
+ # @overload list_transactions(params = {})
2276
+ # @param [Hash] params ({})
2277
+ def list_transactions(params = {}, options = {})
2278
+ req = build_request(:list_transactions, params)
2279
+ req.send_request(options)
2280
+ end
2281
+
1423
2282
  # Sets the list of data lake administrators who have admin privileges on
1424
2283
  # all resources managed by Lake Formation. For more information on admin
1425
2284
  # privileges, see [Granting Lake Formation Permissions][1].
@@ -1436,10 +2295,10 @@ module Aws::LakeFormation
1436
2295
  # The identifier for the Data Catalog. By default, the account ID. The
1437
2296
  # Data Catalog is the persistent metadata store. It contains database
1438
2297
  # definitions, table definitions, and other control information to
1439
- # manage your AWS Lake Formation environment.
2298
+ # manage your Lake Formation environment.
1440
2299
  #
1441
2300
  # @option params [required, Types::DataLakeSettings] :data_lake_settings
1442
- # A structure representing a list of AWS Lake Formation principals
2301
+ # A structure representing a list of Lake Formation principals
1443
2302
  # designated as data lake administrators.
1444
2303
  #
1445
2304
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1471,6 +2330,13 @@ module Aws::LakeFormation
1471
2330
  # },
1472
2331
  # ],
1473
2332
  # trusted_resource_owners: ["CatalogIdString"],
2333
+ # allow_external_data_filtering: false,
2334
+ # external_data_filtering_allow_list: [
2335
+ # {
2336
+ # data_lake_principal_identifier: "DataLakePrincipalString",
2337
+ # },
2338
+ # ],
2339
+ # authorized_session_tag_value_list: ["NameString"],
1474
2340
  # },
1475
2341
  # })
1476
2342
  #
@@ -1494,7 +2360,7 @@ module Aws::LakeFormation
1494
2360
  # attaches it to the service-linked role. When you register subsequent
1495
2361
  # paths, Lake Formation adds the path to the existing policy.
1496
2362
  #
1497
- # The following request registers a new location and gives AWS Lake
2363
+ # The following request registers a new location and gives Lake
1498
2364
  # Formation permission to use the service-linked role to access that
1499
2365
  # location.
1500
2366
  #
@@ -1510,9 +2376,9 @@ module Aws::LakeFormation
1510
2376
  # register.
1511
2377
  #
1512
2378
  # @option params [Boolean] :use_service_linked_role
1513
- # Designates an AWS Identity and Access Management (IAM) service-linked
1514
- # role by registering this role with the Data Catalog. A service-linked
1515
- # role is a unique type of IAM role that is linked directly to Lake
2379
+ # Designates an Identity and Access Management (IAM) service-linked role
2380
+ # by registering this role with the Data Catalog. A service-linked role
2381
+ # is a unique type of IAM role that is linked directly to Lake
1516
2382
  # Formation.
1517
2383
  #
1518
2384
  # For more information, see [Using Service-Linked Roles for Lake
@@ -1544,7 +2410,7 @@ module Aws::LakeFormation
1544
2410
  req.send_request(options)
1545
2411
  end
1546
2412
 
1547
- # Removes a tag from the resource. Only database, table, or
2413
+ # Removes an LF-tag from the resource. Only database, table, or
1548
2414
  # tableWithColumns resource are allowed. To tag columns, use the column
1549
2415
  # inclusion list in `tableWithColumns` to specify column input.
1550
2416
  #
@@ -1552,13 +2418,14 @@ module Aws::LakeFormation
1552
2418
  # The identifier for the Data Catalog. By default, the account ID. The
1553
2419
  # Data Catalog is the persistent metadata store. It contains database
1554
2420
  # definitions, table definitions, and other control information to
1555
- # manage your AWS Lake Formation environment.
2421
+ # manage your Lake Formation environment.
1556
2422
  #
1557
2423
  # @option params [required, Types::Resource] :resource
1558
- # The resource where you want to remove a tag.
2424
+ # The database, table, or column resource where you want to remove an
2425
+ # LF-tag.
1559
2426
  #
1560
2427
  # @option params [required, Array<Types::LFTagPair>] :lf_tags
1561
- # The tags to be removed from the resource.
2428
+ # The LF-tags to be removed from the resource.
1562
2429
  #
1563
2430
  # @return [Types::RemoveLFTagsFromResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1564
2431
  #
@@ -1595,6 +2462,12 @@ module Aws::LakeFormation
1595
2462
  # catalog_id: "CatalogIdString",
1596
2463
  # resource_arn: "ResourceArnString", # required
1597
2464
  # },
2465
+ # data_cells_filter: {
2466
+ # table_catalog_id: "CatalogIdString",
2467
+ # database_name: "NameString",
2468
+ # table_name: "NameString",
2469
+ # name: "NameString",
2470
+ # },
1598
2471
  # lf_tag: {
1599
2472
  # catalog_id: "CatalogIdString",
1600
2473
  # tag_key: "NameString", # required
@@ -1647,7 +2520,7 @@ module Aws::LakeFormation
1647
2520
  # The identifier for the Data Catalog. By default, the account ID. The
1648
2521
  # Data Catalog is the persistent metadata store. It contains database
1649
2522
  # definitions, table definitions, and other control information to
1650
- # manage your AWS Lake Formation environment.
2523
+ # manage your Lake Formation environment.
1651
2524
  #
1652
2525
  # @option params [required, Types::DataLakePrincipal] :principal
1653
2526
  # The principal to be revoked permissions on the resource.
@@ -1704,6 +2577,12 @@ module Aws::LakeFormation
1704
2577
  # catalog_id: "CatalogIdString",
1705
2578
  # resource_arn: "ResourceArnString", # required
1706
2579
  # },
2580
+ # data_cells_filter: {
2581
+ # table_catalog_id: "CatalogIdString",
2582
+ # database_name: "NameString",
2583
+ # table_name: "NameString",
2584
+ # name: "NameString",
2585
+ # },
1707
2586
  # lf_tag: {
1708
2587
  # catalog_id: "CatalogIdString",
1709
2588
  # tag_key: "NameString", # required
@@ -1751,7 +2630,7 @@ module Aws::LakeFormation
1751
2630
  # The identifier for the Data Catalog. By default, the account ID. The
1752
2631
  # Data Catalog is the persistent metadata store. It contains database
1753
2632
  # definitions, table definitions, and other control information to
1754
- # manage your AWS Lake Formation environment.
2633
+ # manage your Lake Formation environment.
1755
2634
  #
1756
2635
  # @option params [required, Array<Types::LFTag>] :expression
1757
2636
  # A list of conditions (`LFTag` structures) to search for in database
@@ -1762,6 +2641,8 @@ module Aws::LakeFormation
1762
2641
  # * {Types::SearchDatabasesByLFTagsResponse#next_token #next_token} => String
1763
2642
  # * {Types::SearchDatabasesByLFTagsResponse#database_list #database_list} => Array&lt;Types::TaggedDatabase&gt;
1764
2643
  #
2644
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2645
+ #
1765
2646
  # @example Request syntax with placeholder values
1766
2647
  #
1767
2648
  # resp = client.search_databases_by_lf_tags({
@@ -1799,7 +2680,7 @@ module Aws::LakeFormation
1799
2680
 
1800
2681
  # This operation allows a search on `TABLE` resources by `LFTag`s. This
1801
2682
  # will be used by admins who want to grant user permissions on certain
1802
- # LFTags. Before making a grant, the admin can use
2683
+ # LF-tags. Before making a grant, the admin can use
1803
2684
  # `SearchTablesByLFTags` to find all resources where the given `LFTag`s
1804
2685
  # are valid to verify whether the returned resources can be shared.
1805
2686
  #
@@ -1814,7 +2695,7 @@ module Aws::LakeFormation
1814
2695
  # The identifier for the Data Catalog. By default, the account ID. The
1815
2696
  # Data Catalog is the persistent metadata store. It contains database
1816
2697
  # definitions, table definitions, and other control information to
1817
- # manage your AWS Lake Formation environment.
2698
+ # manage your Lake Formation environment.
1818
2699
  #
1819
2700
  # @option params [required, Array<Types::LFTag>] :expression
1820
2701
  # A list of conditions (`LFTag` structures) to search for in table
@@ -1825,6 +2706,8 @@ module Aws::LakeFormation
1825
2706
  # * {Types::SearchTablesByLFTagsResponse#next_token #next_token} => String
1826
2707
  # * {Types::SearchTablesByLFTagsResponse#table_list #table_list} => Array&lt;Types::TaggedTable&gt;
1827
2708
  #
2709
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2710
+ #
1828
2711
  # @example Request syntax with placeholder values
1829
2712
  #
1830
2713
  # resp = client.search_tables_by_lf_tags({
@@ -1873,27 +2756,103 @@ module Aws::LakeFormation
1873
2756
  req.send_request(options)
1874
2757
  end
1875
2758
 
1876
- # Updates the list of possible values for the specified tag key. If the
1877
- # tag does not exist, the operation throws an EntityNotFoundException.
1878
- # The values in the delete key values will be deleted from list of
1879
- # possible values. If any value in the delete key values is attached to
1880
- # a resource, then API errors out with a 400 Exception - "Update not
1881
- # allowed". Untag the attribute before deleting the tag key's value.
2759
+ # Submits a request to process a query statement.
2760
+ #
2761
+ # This operation generates work units that can be retrieved with the
2762
+ # `GetWorkUnits` operation as soon as the query state is
2763
+ # WORKUNITS\_AVAILABLE or FINISHED.
2764
+ #
2765
+ # @option params [required, Types::QueryPlanningContext] :query_planning_context
2766
+ # A structure containing information about the query plan.
2767
+ #
2768
+ # @option params [required, String] :query_string
2769
+ # A PartiQL query statement used as an input to the planner service.
2770
+ #
2771
+ # @return [Types::StartQueryPlanningResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2772
+ #
2773
+ # * {Types::StartQueryPlanningResponse#query_id #query_id} => String
2774
+ #
2775
+ # @example Request syntax with placeholder values
2776
+ #
2777
+ # resp = client.start_query_planning({
2778
+ # query_planning_context: { # required
2779
+ # catalog_id: "CatalogIdString",
2780
+ # database_name: "QueryPlanningContextDatabaseNameString", # required
2781
+ # query_as_of_time: Time.now,
2782
+ # query_parameters: {
2783
+ # "String" => "String",
2784
+ # },
2785
+ # transaction_id: "TransactionIdString",
2786
+ # },
2787
+ # query_string: "SyntheticStartQueryPlanningRequestQueryString", # required
2788
+ # })
2789
+ #
2790
+ # @example Response structure
2791
+ #
2792
+ # resp.query_id #=> String
2793
+ #
2794
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/StartQueryPlanning AWS API Documentation
2795
+ #
2796
+ # @overload start_query_planning(params = {})
2797
+ # @param [Hash] params ({})
2798
+ def start_query_planning(params = {}, options = {})
2799
+ req = build_request(:start_query_planning, params)
2800
+ req.send_request(options)
2801
+ end
2802
+
2803
+ # Starts a new transaction and returns its transaction ID. Transaction
2804
+ # IDs are opaque objects that you can use to identify a transaction.
2805
+ #
2806
+ # @option params [String] :transaction_type
2807
+ # Indicates whether this transaction should be read only or read and
2808
+ # write. Writes made using a read-only transaction ID will be rejected.
2809
+ # Read-only transactions do not need to be committed.
2810
+ #
2811
+ # @return [Types::StartTransactionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2812
+ #
2813
+ # * {Types::StartTransactionResponse#transaction_id #transaction_id} => String
2814
+ #
2815
+ # @example Request syntax with placeholder values
2816
+ #
2817
+ # resp = client.start_transaction({
2818
+ # transaction_type: "READ_AND_WRITE", # accepts READ_AND_WRITE, READ_ONLY
2819
+ # })
2820
+ #
2821
+ # @example Response structure
2822
+ #
2823
+ # resp.transaction_id #=> String
2824
+ #
2825
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/StartTransaction AWS API Documentation
2826
+ #
2827
+ # @overload start_transaction(params = {})
2828
+ # @param [Hash] params ({})
2829
+ def start_transaction(params = {}, options = {})
2830
+ req = build_request(:start_transaction, params)
2831
+ req.send_request(options)
2832
+ end
2833
+
2834
+ # Updates the list of possible values for the specified LF-tag key. If
2835
+ # the LF-tag does not exist, the operation throws an
2836
+ # EntityNotFoundException. The values in the delete key values will be
2837
+ # deleted from list of possible values. If any value in the delete key
2838
+ # values is attached to a resource, then API errors out with a 400
2839
+ # Exception - "Update not allowed". Untag the attribute before
2840
+ # deleting the LF-tag key's value.
1882
2841
  #
1883
2842
  # @option params [String] :catalog_id
1884
2843
  # The identifier for the Data Catalog. By default, the account ID. The
1885
2844
  # Data Catalog is the persistent metadata store. It contains database
1886
2845
  # definitions, table definitions, and other control information to
1887
- # manage your AWS Lake Formation environment.
2846
+ # manage your Lake Formation environment.
1888
2847
  #
1889
2848
  # @option params [required, String] :tag_key
1890
- # The key-name for the tag for which to add or delete values.
2849
+ # The key-name for the LF-tag for which to add or delete values.
1891
2850
  #
1892
2851
  # @option params [Array<String>] :tag_values_to_delete
1893
- # A list of tag values to delete from the tag.
2852
+ # A list of LF-tag values to delete from the LF-tag.
1894
2853
  #
1895
2854
  # @option params [Array<String>] :tag_values_to_add
1896
- # A list of tag values to add from the tag.
2855
+ # A list of LF-tag values to add from the LF-tag.
1897
2856
  #
1898
2857
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1899
2858
  #
@@ -1916,10 +2875,10 @@ module Aws::LakeFormation
1916
2875
  end
1917
2876
 
1918
2877
  # Updates the data access role used for vending access to the given
1919
- # (registered) resource in AWS Lake Formation.
2878
+ # (registered) resource in Lake Formation.
1920
2879
  #
1921
2880
  # @option params [required, String] :role_arn
1922
- # The new role to use for the given resource registered in AWS Lake
2881
+ # The new role to use for the given resource registered in Lake
1923
2882
  # Formation.
1924
2883
  #
1925
2884
  # @option params [required, String] :resource_arn
@@ -1943,6 +2902,105 @@ module Aws::LakeFormation
1943
2902
  req.send_request(options)
1944
2903
  end
1945
2904
 
2905
+ # Updates the manifest of Amazon S3 objects that make up the specified
2906
+ # governed table.
2907
+ #
2908
+ # @option params [String] :catalog_id
2909
+ # The catalog containing the governed table to update. Defaults to the
2910
+ # caller’s account ID.
2911
+ #
2912
+ # @option params [required, String] :database_name
2913
+ # The database containing the governed table to update.
2914
+ #
2915
+ # @option params [required, String] :table_name
2916
+ # The governed table to update.
2917
+ #
2918
+ # @option params [required, String] :transaction_id
2919
+ # The transaction at which to do the write.
2920
+ #
2921
+ # @option params [required, Array<Types::WriteOperation>] :write_operations
2922
+ # A list of `WriteOperation` objects that define an object to add to or
2923
+ # delete from the manifest for a governed table.
2924
+ #
2925
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2926
+ #
2927
+ # @example Request syntax with placeholder values
2928
+ #
2929
+ # resp = client.update_table_objects({
2930
+ # catalog_id: "CatalogIdString",
2931
+ # database_name: "NameString", # required
2932
+ # table_name: "NameString", # required
2933
+ # transaction_id: "TransactionIdString", # required
2934
+ # write_operations: [ # required
2935
+ # {
2936
+ # add_object: {
2937
+ # uri: "URI", # required
2938
+ # etag: "ETagString", # required
2939
+ # size: 1, # required
2940
+ # partition_values: ["PartitionValueString"],
2941
+ # },
2942
+ # delete_object: {
2943
+ # uri: "URI", # required
2944
+ # etag: "ETagString",
2945
+ # partition_values: ["PartitionValueString"],
2946
+ # },
2947
+ # },
2948
+ # ],
2949
+ # })
2950
+ #
2951
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/UpdateTableObjects AWS API Documentation
2952
+ #
2953
+ # @overload update_table_objects(params = {})
2954
+ # @param [Hash] params ({})
2955
+ def update_table_objects(params = {}, options = {})
2956
+ req = build_request(:update_table_objects, params)
2957
+ req.send_request(options)
2958
+ end
2959
+
2960
+ # Updates the configuration of the storage optimizers for a table.
2961
+ #
2962
+ # @option params [String] :catalog_id
2963
+ # The Catalog ID of the table.
2964
+ #
2965
+ # @option params [required, String] :database_name
2966
+ # Name of the database where the table is present.
2967
+ #
2968
+ # @option params [required, String] :table_name
2969
+ # Name of the table for which to enable the storage optimizer.
2970
+ #
2971
+ # @option params [required, Hash<String,Hash>] :storage_optimizer_config
2972
+ # Name of the table for which to enable the storage optimizer.
2973
+ #
2974
+ # @return [Types::UpdateTableStorageOptimizerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2975
+ #
2976
+ # * {Types::UpdateTableStorageOptimizerResponse#result #result} => String
2977
+ #
2978
+ # @example Request syntax with placeholder values
2979
+ #
2980
+ # resp = client.update_table_storage_optimizer({
2981
+ # catalog_id: "CatalogIdString",
2982
+ # database_name: "NameString", # required
2983
+ # table_name: "NameString", # required
2984
+ # storage_optimizer_config: { # required
2985
+ # "COMPACTION" => {
2986
+ # "StorageOptimizerConfigKey" => "StorageOptimizerConfigValue",
2987
+ # },
2988
+ # },
2989
+ # })
2990
+ #
2991
+ # @example Response structure
2992
+ #
2993
+ # resp.result #=> String
2994
+ #
2995
+ # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/UpdateTableStorageOptimizer AWS API Documentation
2996
+ #
2997
+ # @overload update_table_storage_optimizer(params = {})
2998
+ # @param [Hash] params ({})
2999
+ def update_table_storage_optimizer(params = {}, options = {})
3000
+ req = build_request(:update_table_storage_optimizer, params)
3001
+ req.send_request(options)
3002
+ end
3003
+
1946
3004
  # @!endgroup
1947
3005
 
1948
3006
  # @param params ({})
@@ -1956,7 +3014,7 @@ module Aws::LakeFormation
1956
3014
  params: params,
1957
3015
  config: config)
1958
3016
  context[:gem_name] = 'aws-sdk-lakeformation'
1959
- context[:gem_version] = '1.18.0'
3017
+ context[:gem_version] = '1.22.0'
1960
3018
  Seahorse::Client::Request.new(handlers, context)
1961
3019
  end
1962
3020