aws-sdk-lakeformation 1.2.0 → 1.7.0

Sign up to get free protection for your applications and to get access to all the features.
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