aws-sdk-lakeformation 1.2.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: 31864ad7214b0f6497dac562593ea7486d1faa27
4
- data.tar.gz: 7c5b56a05f62a593cd3b0f9c6ca005dbd8a2f2f5
2
+ SHA256:
3
+ metadata.gz: 2e13171b1878aaab8a87f18b45292807c7529d9a81f4f6049ba102a0b5b7983c
4
+ data.tar.gz: fe2892b97fbfdfbe2638479f54810873851d3d331031f814cdee4f79c1d24670
5
5
  SHA512:
6
- metadata.gz: 5fd60688fed89e1e078f07d7bb7165f23be8b3821fd811b36773a51bed9a67b7dae0c443f3d33ccf3e3c3be2555b7f9611cff8fbe6393ae517f1c6d6c44f6a82
7
- data.tar.gz: e327e8644f4d2fbe0445ef8a7b90b54f88a8f1e880a3b8243a83a236a3bff8abc0dca941b4cdf2744c8d67f572de44922340f90d99f9f847da6ef566b4434783
6
+ metadata.gz: a981a892f375c416ad0731527c4dfc5bff2e1e8098474a069df9086d18bf8c9eb8c1bae6e745c1ad6d5f2c741afdb701847bdf7c986f7fcbdf0ef21bcc9221e6
7
+ data.tar.gz: b46100b9f6788aee043fa892047f1172cba752d2a5756ab79da745d5efadf30f4fc6ef7a8e83260a6a897fe7c856de6ab2d2a7b693551529d350da1ea39b7845
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-lakeformation/customizations'
45
47
  # @service
46
48
  module Aws::LakeFormation
47
49
 
48
- GEM_VERSION = '1.2.0'
50
+ GEM_VERSION = '1.7.0'
49
51
 
50
52
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
26
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
26
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
27
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
31
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
29
32
 
@@ -32,11 +35,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:lakeformation)
32
35
  module Aws::LakeFormation
33
36
  # An API client for LakeFormation. To construct a client, you need to configure a `:region` and `:credentials`.
34
37
  #
35
- # client = Aws::LakeFormation::Client.new(
36
- # region: region_name,
37
- # credentials: credentials,
38
- # # ...
39
- # )
38
+ # client = Aws::LakeFormation::Client.new(
39
+ # region: region_name,
40
+ # credentials: credentials,
41
+ # # ...
42
+ # )
40
43
  #
41
44
  # For details on configuring region and credentials see
42
45
  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -69,6 +72,7 @@ module Aws::LakeFormation
69
72
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
70
73
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
71
74
  add_plugin(Aws::Plugins::TransferEncoding)
75
+ add_plugin(Aws::Plugins::HttpChecksum)
72
76
  add_plugin(Aws::Plugins::SignatureV4)
73
77
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
74
78
 
@@ -105,7 +109,7 @@ module Aws::LakeFormation
105
109
  # @option options [required, String] :region
106
110
  # The AWS region to connect to. The configured `:region` is
107
111
  # used to determine the service `:endpoint`. When not passed,
108
- # a default `:region` is search for in the following locations:
112
+ # a default `:region` is searched for in the following locations:
109
113
  #
110
114
  # * `Aws.config[:region]`
111
115
  # * `ENV['AWS_REGION']`
@@ -161,7 +165,7 @@ module Aws::LakeFormation
161
165
  # @option options [String] :endpoint
162
166
  # The client endpoint is normally constructed from the `:region`
163
167
  # option. You should only configure an `:endpoint` when connecting
164
- # to test endpoints. This should be avalid HTTP(S) URI.
168
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
165
169
  #
166
170
  # @option options [Integer] :endpoint_cache_max_entries (1000)
167
171
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::LakeFormation
176
180
  # requests fetching endpoints information. Defaults to 60 sec.
177
181
  #
178
182
  # @option options [Boolean] :endpoint_discovery (false)
179
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
183
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
180
184
  #
181
185
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
182
186
  # The log formatter.
@@ -229,15 +233,19 @@ module Aws::LakeFormation
229
233
  #
230
234
  # @option options [String] :retry_mode ("legacy")
231
235
  # Specifies which retry algorithm to use. Values are:
232
- # * `legacy` - The pre-existing retry behavior. This is default value if
233
- # no retry mode is provided.
234
- # * `standard` - A standardized set of retry rules across the AWS SDKs.
235
- # This includes support for retry quotas, which limit the number of
236
- # unsuccessful retries a client can make.
237
- # * `adaptive` - An experimental retry mode that includes all the
238
- # functionality of `standard` mode along with automatic client side
239
- # throttling. This is a provisional mode that may change behavior
240
- # in the future.
236
+ #
237
+ # * `legacy` - The pre-existing retry behavior. This is default value if
238
+ # no retry mode is provided.
239
+ #
240
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
241
+ # This includes support for retry quotas, which limit the number of
242
+ # unsuccessful retries a client can make.
243
+ #
244
+ # * `adaptive` - An experimental retry mode that includes all the
245
+ # functionality of `standard` mode along with automatic client side
246
+ # throttling. This is a provisional mode that may change behavior
247
+ # in the future.
248
+ #
241
249
  #
242
250
  # @option options [String] :secret_access_key
243
251
  #
@@ -275,8 +283,7 @@ module Aws::LakeFormation
275
283
  #
276
284
  # @option options [Integer] :http_read_timeout (60) The default
277
285
  # number of seconds to wait for response data. This value can
278
- # safely be set
279
- # per-request on the session yielded by {#session_for}.
286
+ # safely be set per-request on the session.
280
287
  #
281
288
  # @option options [Float] :http_idle_timeout (5) The number of
282
289
  # seconds a connection is allowed to sit idle before it is
@@ -288,7 +295,7 @@ module Aws::LakeFormation
288
295
  # request body. This option has no effect unless the request has
289
296
  # "Expect" header set to "100-continue". Defaults to `nil` which
290
297
  # disables this behaviour. This value can safely be set per
291
- # request on the session yielded by {#session_for}.
298
+ # request on the session.
292
299
  #
293
300
  # @option options [Boolean] :http_wire_trace (false) When `true`,
294
301
  # HTTP debug output will be sent to the `:logger`.
@@ -345,26 +352,32 @@ module Aws::LakeFormation
345
352
  # catalog: {
346
353
  # },
347
354
  # database: {
355
+ # catalog_id: "CatalogIdString",
348
356
  # name: "NameString", # required
349
357
  # },
350
358
  # table: {
359
+ # catalog_id: "CatalogIdString",
351
360
  # database_name: "NameString", # required
352
- # name: "NameString", # required
361
+ # name: "NameString",
362
+ # table_wildcard: {
363
+ # },
353
364
  # },
354
365
  # table_with_columns: {
355
- # database_name: "NameString",
356
- # name: "NameString",
366
+ # catalog_id: "CatalogIdString",
367
+ # database_name: "NameString", # required
368
+ # name: "NameString", # required
357
369
  # column_names: ["NameString"],
358
370
  # column_wildcard: {
359
371
  # excluded_column_names: ["NameString"],
360
372
  # },
361
373
  # },
362
374
  # data_location: {
375
+ # catalog_id: "CatalogIdString",
363
376
  # resource_arn: "ResourceArnString", # required
364
377
  # },
365
378
  # },
366
- # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
367
- # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
379
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
380
+ # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
368
381
  # },
369
382
  # ],
370
383
  # })
@@ -374,20 +387,24 @@ module Aws::LakeFormation
374
387
  # resp.failures #=> Array
375
388
  # resp.failures[0].request_entry.id #=> String
376
389
  # resp.failures[0].request_entry.principal.data_lake_principal_identifier #=> String
390
+ # resp.failures[0].request_entry.resource.database.catalog_id #=> String
377
391
  # resp.failures[0].request_entry.resource.database.name #=> String
392
+ # resp.failures[0].request_entry.resource.table.catalog_id #=> String
378
393
  # resp.failures[0].request_entry.resource.table.database_name #=> String
379
394
  # resp.failures[0].request_entry.resource.table.name #=> String
395
+ # resp.failures[0].request_entry.resource.table_with_columns.catalog_id #=> String
380
396
  # resp.failures[0].request_entry.resource.table_with_columns.database_name #=> String
381
397
  # resp.failures[0].request_entry.resource.table_with_columns.name #=> String
382
398
  # resp.failures[0].request_entry.resource.table_with_columns.column_names #=> Array
383
399
  # resp.failures[0].request_entry.resource.table_with_columns.column_names[0] #=> String
384
400
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names #=> Array
385
401
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
402
+ # resp.failures[0].request_entry.resource.data_location.catalog_id #=> String
386
403
  # resp.failures[0].request_entry.resource.data_location.resource_arn #=> String
387
404
  # resp.failures[0].request_entry.permissions #=> Array
388
- # resp.failures[0].request_entry.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
405
+ # resp.failures[0].request_entry.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
389
406
  # resp.failures[0].request_entry.permissions_with_grant_option #=> Array
390
- # resp.failures[0].request_entry.permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
407
+ # resp.failures[0].request_entry.permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
391
408
  # resp.failures[0].error.error_code #=> String
392
409
  # resp.failures[0].error.error_message #=> String
393
410
  #
@@ -430,26 +447,32 @@ module Aws::LakeFormation
430
447
  # catalog: {
431
448
  # },
432
449
  # database: {
450
+ # catalog_id: "CatalogIdString",
433
451
  # name: "NameString", # required
434
452
  # },
435
453
  # table: {
454
+ # catalog_id: "CatalogIdString",
436
455
  # database_name: "NameString", # required
437
- # name: "NameString", # required
456
+ # name: "NameString",
457
+ # table_wildcard: {
458
+ # },
438
459
  # },
439
460
  # table_with_columns: {
440
- # database_name: "NameString",
441
- # name: "NameString",
461
+ # catalog_id: "CatalogIdString",
462
+ # database_name: "NameString", # required
463
+ # name: "NameString", # required
442
464
  # column_names: ["NameString"],
443
465
  # column_wildcard: {
444
466
  # excluded_column_names: ["NameString"],
445
467
  # },
446
468
  # },
447
469
  # data_location: {
470
+ # catalog_id: "CatalogIdString",
448
471
  # resource_arn: "ResourceArnString", # required
449
472
  # },
450
473
  # },
451
- # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
452
- # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
474
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
475
+ # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
453
476
  # },
454
477
  # ],
455
478
  # })
@@ -459,20 +482,24 @@ module Aws::LakeFormation
459
482
  # resp.failures #=> Array
460
483
  # resp.failures[0].request_entry.id #=> String
461
484
  # resp.failures[0].request_entry.principal.data_lake_principal_identifier #=> String
485
+ # resp.failures[0].request_entry.resource.database.catalog_id #=> String
462
486
  # resp.failures[0].request_entry.resource.database.name #=> String
487
+ # resp.failures[0].request_entry.resource.table.catalog_id #=> String
463
488
  # resp.failures[0].request_entry.resource.table.database_name #=> String
464
489
  # resp.failures[0].request_entry.resource.table.name #=> String
490
+ # resp.failures[0].request_entry.resource.table_with_columns.catalog_id #=> String
465
491
  # resp.failures[0].request_entry.resource.table_with_columns.database_name #=> String
466
492
  # resp.failures[0].request_entry.resource.table_with_columns.name #=> String
467
493
  # resp.failures[0].request_entry.resource.table_with_columns.column_names #=> Array
468
494
  # resp.failures[0].request_entry.resource.table_with_columns.column_names[0] #=> String
469
495
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names #=> Array
470
496
  # resp.failures[0].request_entry.resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
497
+ # resp.failures[0].request_entry.resource.data_location.catalog_id #=> String
471
498
  # resp.failures[0].request_entry.resource.data_location.resource_arn #=> String
472
499
  # resp.failures[0].request_entry.permissions #=> Array
473
- # resp.failures[0].request_entry.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
500
+ # resp.failures[0].request_entry.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
474
501
  # resp.failures[0].request_entry.permissions_with_grant_option #=> Array
475
- # resp.failures[0].request_entry.permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
502
+ # resp.failures[0].request_entry.permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
476
503
  # resp.failures[0].error.error_code #=> String
477
504
  # resp.failures[0].error.error_message #=> String
478
505
  #
@@ -542,7 +569,8 @@ module Aws::LakeFormation
542
569
  req.send_request(options)
543
570
  end
544
571
 
545
- # The AWS Lake Formation principal.
572
+ # Retrieves the list of the data lake administrators of a Lake
573
+ # Formation-managed data lake.
546
574
  #
547
575
  # @option params [String] :catalog_id
548
576
  # The identifier for the Data Catalog. By default, the account ID. The
@@ -567,11 +595,13 @@ module Aws::LakeFormation
567
595
  # resp.data_lake_settings.create_database_default_permissions #=> Array
568
596
  # resp.data_lake_settings.create_database_default_permissions[0].principal.data_lake_principal_identifier #=> String
569
597
  # resp.data_lake_settings.create_database_default_permissions[0].permissions #=> Array
570
- # resp.data_lake_settings.create_database_default_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
598
+ # resp.data_lake_settings.create_database_default_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
571
599
  # resp.data_lake_settings.create_table_default_permissions #=> Array
572
600
  # resp.data_lake_settings.create_table_default_permissions[0].principal.data_lake_principal_identifier #=> String
573
601
  # resp.data_lake_settings.create_table_default_permissions[0].permissions #=> Array
574
- # resp.data_lake_settings.create_table_default_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
602
+ # 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"
603
+ # resp.data_lake_settings.trusted_resource_owners #=> Array
604
+ # resp.data_lake_settings.trusted_resource_owners[0] #=> String
575
605
  #
576
606
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetDataLakeSettings AWS API Documentation
577
607
  #
@@ -582,8 +612,10 @@ module Aws::LakeFormation
582
612
  req.send_request(options)
583
613
  end
584
614
 
585
- # Returns the permissions for a specified table or database resource
586
- # located at a path in Amazon S3.
615
+ # Returns the Lake Formation permissions for a specified table or
616
+ # database resource located at a path in Amazon S3.
617
+ # `GetEffectivePermissionsForPath` will not return databases and tables
618
+ # if the catalog is encrypted.
587
619
  #
588
620
  # @option params [String] :catalog_id
589
621
  # The identifier for the Data Catalog. By default, the account ID. The
@@ -607,6 +639,8 @@ module Aws::LakeFormation
607
639
  # * {Types::GetEffectivePermissionsForPathResponse#permissions #permissions} => Array<Types::PrincipalResourcePermissions>
608
640
  # * {Types::GetEffectivePermissionsForPathResponse#next_token #next_token} => String
609
641
  #
642
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
643
+ #
610
644
  # @example Request syntax with placeholder values
611
645
  #
612
646
  # resp = client.get_effective_permissions_for_path({
@@ -620,20 +654,24 @@ module Aws::LakeFormation
620
654
  #
621
655
  # resp.permissions #=> Array
622
656
  # resp.permissions[0].principal.data_lake_principal_identifier #=> String
657
+ # resp.permissions[0].resource.database.catalog_id #=> String
623
658
  # resp.permissions[0].resource.database.name #=> String
659
+ # resp.permissions[0].resource.table.catalog_id #=> String
624
660
  # resp.permissions[0].resource.table.database_name #=> String
625
661
  # resp.permissions[0].resource.table.name #=> String
662
+ # resp.permissions[0].resource.table_with_columns.catalog_id #=> String
626
663
  # resp.permissions[0].resource.table_with_columns.database_name #=> String
627
664
  # resp.permissions[0].resource.table_with_columns.name #=> String
628
665
  # resp.permissions[0].resource.table_with_columns.column_names #=> Array
629
666
  # resp.permissions[0].resource.table_with_columns.column_names[0] #=> String
630
667
  # resp.permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names #=> Array
631
668
  # resp.permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
669
+ # resp.permissions[0].resource.data_location.catalog_id #=> String
632
670
  # resp.permissions[0].resource.data_location.resource_arn #=> String
633
671
  # resp.permissions[0].permissions #=> Array
634
- # resp.permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
672
+ # resp.permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
635
673
  # resp.permissions[0].permissions_with_grant_option #=> Array
636
- # resp.permissions[0].permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
674
+ # resp.permissions[0].permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
637
675
  # resp.next_token #=> String
638
676
  #
639
677
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GetEffectivePermissionsForPath AWS API Documentation
@@ -654,7 +692,7 @@ module Aws::LakeFormation
654
692
  #
655
693
  #
656
694
  #
657
- # [1]: https://docs-aws.amazon.com/michigan/latest/dg/security-data-access.html
695
+ # [1]: https://docs-aws.amazon.com/lake-formation/latest/dg/security-data-access.html
658
696
  #
659
697
  # @option params [String] :catalog_id
660
698
  # The identifier for the Data Catalog. By default, the account ID. The
@@ -700,26 +738,32 @@ module Aws::LakeFormation
700
738
  # catalog: {
701
739
  # },
702
740
  # database: {
741
+ # catalog_id: "CatalogIdString",
703
742
  # name: "NameString", # required
704
743
  # },
705
744
  # table: {
745
+ # catalog_id: "CatalogIdString",
706
746
  # database_name: "NameString", # required
707
- # name: "NameString", # required
747
+ # name: "NameString",
748
+ # table_wildcard: {
749
+ # },
708
750
  # },
709
751
  # table_with_columns: {
710
- # database_name: "NameString",
711
- # name: "NameString",
752
+ # catalog_id: "CatalogIdString",
753
+ # database_name: "NameString", # required
754
+ # name: "NameString", # required
712
755
  # column_names: ["NameString"],
713
756
  # column_wildcard: {
714
757
  # excluded_column_names: ["NameString"],
715
758
  # },
716
759
  # },
717
760
  # data_location: {
761
+ # catalog_id: "CatalogIdString",
718
762
  # resource_arn: "ResourceArnString", # required
719
763
  # },
720
764
  # },
721
- # permissions: ["ALL"], # required, accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
722
- # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
765
+ # permissions: ["ALL"], # required, accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
766
+ # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
723
767
  # })
724
768
  #
725
769
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/GrantPermissions AWS API Documentation
@@ -744,7 +788,7 @@ module Aws::LakeFormation
744
788
  #
745
789
  #
746
790
  #
747
- # [1]: https://docs-aws.amazon.com/michigan/latest/dg/security-data-access.html
791
+ # [1]: https://docs-aws.amazon.com/lake-formation/latest/dg/security-data-access.html
748
792
  #
749
793
  # @option params [String] :catalog_id
750
794
  # The identifier for the Data Catalog. By default, the account ID. The
@@ -777,6 +821,8 @@ module Aws::LakeFormation
777
821
  # * {Types::ListPermissionsResponse#principal_resource_permissions #principal_resource_permissions} => Array<Types::PrincipalResourcePermissions>
778
822
  # * {Types::ListPermissionsResponse#next_token #next_token} => String
779
823
  #
824
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
825
+ #
780
826
  # @example Request syntax with placeholder values
781
827
  #
782
828
  # resp = client.list_permissions({
@@ -789,21 +835,27 @@ module Aws::LakeFormation
789
835
  # catalog: {
790
836
  # },
791
837
  # database: {
838
+ # catalog_id: "CatalogIdString",
792
839
  # name: "NameString", # required
793
840
  # },
794
841
  # table: {
842
+ # catalog_id: "CatalogIdString",
795
843
  # database_name: "NameString", # required
796
- # name: "NameString", # required
844
+ # name: "NameString",
845
+ # table_wildcard: {
846
+ # },
797
847
  # },
798
848
  # table_with_columns: {
799
- # database_name: "NameString",
800
- # name: "NameString",
849
+ # catalog_id: "CatalogIdString",
850
+ # database_name: "NameString", # required
851
+ # name: "NameString", # required
801
852
  # column_names: ["NameString"],
802
853
  # column_wildcard: {
803
854
  # excluded_column_names: ["NameString"],
804
855
  # },
805
856
  # },
806
857
  # data_location: {
858
+ # catalog_id: "CatalogIdString",
807
859
  # resource_arn: "ResourceArnString", # required
808
860
  # },
809
861
  # },
@@ -815,20 +867,24 @@ module Aws::LakeFormation
815
867
  #
816
868
  # resp.principal_resource_permissions #=> Array
817
869
  # resp.principal_resource_permissions[0].principal.data_lake_principal_identifier #=> String
870
+ # resp.principal_resource_permissions[0].resource.database.catalog_id #=> String
818
871
  # resp.principal_resource_permissions[0].resource.database.name #=> String
872
+ # resp.principal_resource_permissions[0].resource.table.catalog_id #=> String
819
873
  # resp.principal_resource_permissions[0].resource.table.database_name #=> String
820
874
  # resp.principal_resource_permissions[0].resource.table.name #=> String
875
+ # resp.principal_resource_permissions[0].resource.table_with_columns.catalog_id #=> String
821
876
  # resp.principal_resource_permissions[0].resource.table_with_columns.database_name #=> String
822
877
  # resp.principal_resource_permissions[0].resource.table_with_columns.name #=> String
823
878
  # resp.principal_resource_permissions[0].resource.table_with_columns.column_names #=> Array
824
879
  # resp.principal_resource_permissions[0].resource.table_with_columns.column_names[0] #=> String
825
880
  # resp.principal_resource_permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names #=> Array
826
881
  # resp.principal_resource_permissions[0].resource.table_with_columns.column_wildcard.excluded_column_names[0] #=> String
882
+ # resp.principal_resource_permissions[0].resource.data_location.catalog_id #=> String
827
883
  # resp.principal_resource_permissions[0].resource.data_location.resource_arn #=> String
828
884
  # resp.principal_resource_permissions[0].permissions #=> Array
829
- # resp.principal_resource_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
885
+ # resp.principal_resource_permissions[0].permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
830
886
  # resp.principal_resource_permissions[0].permissions_with_grant_option #=> Array
831
- # resp.principal_resource_permissions[0].permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
887
+ # resp.principal_resource_permissions[0].permissions_with_grant_option[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "DESCRIBE", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
832
888
  # resp.next_token #=> String
833
889
  #
834
890
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/ListPermissions AWS API Documentation
@@ -858,6 +914,8 @@ module Aws::LakeFormation
858
914
  # * {Types::ListResourcesResponse#resource_info_list #resource_info_list} => Array<Types::ResourceInfo>
859
915
  # * {Types::ListResourcesResponse#next_token #next_token} => String
860
916
  #
917
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
918
+ #
861
919
  # @example Request syntax with placeholder values
862
920
  #
863
921
  # resp = client.list_resources({
@@ -889,7 +947,17 @@ module Aws::LakeFormation
889
947
  req.send_request(options)
890
948
  end
891
949
 
892
- # The AWS Lake Formation principal.
950
+ # Sets the list of data lake administrators who have admin privileges on
951
+ # all resources managed by Lake Formation. For more information on admin
952
+ # privileges, see [Granting Lake Formation Permissions][1].
953
+ #
954
+ # This API replaces the current list of data lake admins with the new
955
+ # list being passed. To add an admin, fetch the current list and add the
956
+ # new admin to that list and pass that list in this API.
957
+ #
958
+ #
959
+ #
960
+ # [1]: https://docs.aws.amazon.com/lake-formation/latest/dg/lake-formation-permissions.html
893
961
  #
894
962
  # @option params [String] :catalog_id
895
963
  # The identifier for the Data Catalog. By default, the account ID. The
@@ -898,7 +966,8 @@ module Aws::LakeFormation
898
966
  # manage your AWS Lake Formation environment.
899
967
  #
900
968
  # @option params [required, Types::DataLakeSettings] :data_lake_settings
901
- # A list of AWS Lake Formation principals.
969
+ # A structure representing a list of AWS Lake Formation principals
970
+ # designated as data lake administrators.
902
971
  #
903
972
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
904
973
  #
@@ -917,7 +986,7 @@ module Aws::LakeFormation
917
986
  # principal: {
918
987
  # data_lake_principal_identifier: "DataLakePrincipalString",
919
988
  # },
920
- # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
989
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
921
990
  # },
922
991
  # ],
923
992
  # create_table_default_permissions: [
@@ -925,9 +994,10 @@ module Aws::LakeFormation
925
994
  # principal: {
926
995
  # data_lake_principal_identifier: "DataLakePrincipalString",
927
996
  # },
928
- # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
997
+ # permissions: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
929
998
  # },
930
999
  # ],
1000
+ # trusted_resource_owners: ["CatalogIdString"],
931
1001
  # },
932
1002
  # })
933
1003
  #
@@ -951,16 +1021,36 @@ module Aws::LakeFormation
951
1021
  # attaches it to the service-linked role. When you register subsequent
952
1022
  # paths, Lake Formation adds the path to the existing policy.
953
1023
  #
1024
+ # The following request registers a new location and gives AWS Lake
1025
+ # Formation permission to use the service-linked role to access that
1026
+ # location.
1027
+ #
1028
+ # `ResourceArn = arn:aws:s3:::my-bucket UseServiceLinkedRole = true`
1029
+ #
1030
+ # If `UseServiceLinkedRole` is not set to true, you must provide or set
1031
+ # the `RoleArn`\:
1032
+ #
1033
+ # `arn:aws:iam::12345:role/my-data-access-role`
1034
+ #
954
1035
  # @option params [required, String] :resource_arn
955
1036
  # The Amazon Resource Name (ARN) of the resource that you want to
956
1037
  # register.
957
1038
  #
958
1039
  # @option params [Boolean] :use_service_linked_role
959
- # Designates a trusted caller, an IAM principal, by registering this
960
- # caller with the Data Catalog.
1040
+ # Designates an AWS Identity and Access Management (IAM) service-linked
1041
+ # role by registering this role with the Data Catalog. A service-linked
1042
+ # role is a unique type of IAM role that is linked directly to Lake
1043
+ # Formation.
1044
+ #
1045
+ # For more information, see [Using Service-Linked Roles for Lake
1046
+ # Formation][1].
1047
+ #
1048
+ #
1049
+ #
1050
+ # [1]: https://docs-aws.amazon.com/lake-formation/latest/dg/service-linked-roles.html
961
1051
  #
962
1052
  # @option params [String] :role_arn
963
- # The identifier for the role.
1053
+ # The identifier for the role that registers the resource.
964
1054
  #
965
1055
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
966
1056
  #
@@ -1004,7 +1094,7 @@ module Aws::LakeFormation
1004
1094
  #
1005
1095
  #
1006
1096
  #
1007
- # [1]: https://docs-aws.amazon.com/michigan/latest/dg/security-data-access.html
1097
+ # [1]: https://docs-aws.amazon.com/lake-formation/latest/dg/security-data-access.html
1008
1098
  #
1009
1099
  # @option params [Array<String>] :permissions_with_grant_option
1010
1100
  # Indicates a list of permissions for which to revoke the grant option
@@ -1023,26 +1113,32 @@ module Aws::LakeFormation
1023
1113
  # catalog: {
1024
1114
  # },
1025
1115
  # database: {
1116
+ # catalog_id: "CatalogIdString",
1026
1117
  # name: "NameString", # required
1027
1118
  # },
1028
1119
  # table: {
1120
+ # catalog_id: "CatalogIdString",
1029
1121
  # database_name: "NameString", # required
1030
- # name: "NameString", # required
1122
+ # name: "NameString",
1123
+ # table_wildcard: {
1124
+ # },
1031
1125
  # },
1032
1126
  # table_with_columns: {
1033
- # database_name: "NameString",
1034
- # name: "NameString",
1127
+ # catalog_id: "CatalogIdString",
1128
+ # database_name: "NameString", # required
1129
+ # name: "NameString", # required
1035
1130
  # column_names: ["NameString"],
1036
1131
  # column_wildcard: {
1037
1132
  # excluded_column_names: ["NameString"],
1038
1133
  # },
1039
1134
  # },
1040
1135
  # data_location: {
1136
+ # catalog_id: "CatalogIdString",
1041
1137
  # resource_arn: "ResourceArnString", # required
1042
1138
  # },
1043
1139
  # },
1044
- # permissions: ["ALL"], # required, accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
1045
- # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
1140
+ # permissions: ["ALL"], # required, accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
1141
+ # permissions_with_grant_option: ["ALL"], # accepts ALL, SELECT, ALTER, DROP, DELETE, INSERT, DESCRIBE, CREATE_DATABASE, CREATE_TABLE, DATA_LOCATION_ACCESS
1046
1142
  # })
1047
1143
  #
1048
1144
  # @see http://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/RevokePermissions AWS API Documentation
@@ -1095,7 +1191,7 @@ module Aws::LakeFormation
1095
1191
  params: params,
1096
1192
  config: config)
1097
1193
  context[:gem_name] = 'aws-sdk-lakeformation'
1098
- context[:gem_version] = '1.2.0'
1194
+ context[:gem_version] = '1.7.0'
1099
1195
  Seahorse::Client::Request.new(handlers, context)
1100
1196
  end
1101
1197