Actions, resources, and condition keys for AWS Lake Formation - Service Authorization Reference

Actions, resources, and condition keys for AWS Lake Formation

AWS Lake Formation (service prefix: lakeformation) provides the following service-specific resources, actions, and condition context keys for use in IAM permission policies.

References:

Actions defined by AWS Lake Formation

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

The Resource types column indicates whether each action supports resource-level permissions. If there is no value for this column, you must specify all resources ("*") in the Resource element of your policy statement. If the column includes a resource type, then you can specify an ARN of that type in a statement with that action. Required resources are indicated in the table with an asterisk (*). If you specify a resource-level permission ARN in a statement using this action, then it must be of this type. Some actions support multiple resource types. If the resource type is optional (not indicated as required), then you can choose to use one but not the other.

For details about the columns in the following table, see Actions table.

Actions Description Access level Resource types (*required) Condition keys Dependent actions
AddLFTagsToResource Grants permission to attach Lake Formation tags to catalog resources Tagging
BatchGrantPermissions Grants permission to data lake permissions to one or more principals in a batch Permissions management
BatchRevokePermissions Grants permission to revoke data lake permissions from one or more principals in a batch Permissions management
CancelTransaction Grants permission to cancel the given transaction Write
CommitTransaction Grants permission to commit the given transaction Write
CreateDataCellsFilter Grants permission to create a Lake Formation data cell filter Write
CreateLFTag Grants permission to create a Lake Formation tag Write
DeleteDataCellsFilter Grants permission to delete a Lake Formation data cell filter Write
DeleteLFTag Grants permission to delete a Lake Formation tag Write
DeleteObjectsOnCancel Grants permission to delete the specified objects if the transaction is canceled Write
DeregisterResource Grants permission to deregister a registered location Write
DescribeResource Grants permission to describe a registered location Read
DescribeTransaction Grants permission to get status of the given transaction Read
ExtendTransaction Grants permission to extend the timeout of the given transaction Write
GetDataAccess Grants permission to virtual data lake access Write
GetDataLakeSettings Grants permission to retrieve data lake settings such as the list of data lake administrators and database and table default permissions Read
GetEffectivePermissionsForPath Grants permission to retrieve permissions attached to resources in the given path Read
GetLFTag Grants permission to retrieve a Lake Formation tag Read
GetQueryState Grants permission to retrieve the state of the given query Read

lakeformation:StartQueryPlanning

GetQueryStatistics Grants permission to retrieve the statistics for the given query Read

lakeformation:StartQueryPlanning

GetResourceLFTags Grants permission to retrieve lakeformation tags on a catalog resource Read
GetTableObjects Grants permission to retrieve objects from a table Read
GetWorkUnitResults Grants permission to retrieve the results for the given work units Read

lakeformation:GetWorkUnits

lakeformation:StartQueryPlanning

GetWorkUnits Grants permission to retrieve the work units for the given query Read

lakeaformation:StartQueryPlanning

GrantPermissions Grants permission to data lake permissions to a principal Permissions management
ListDataCellsFilter Grants permission to list cell filters List
ListLFTags Grants permission to list Lake Formation tags Read
ListPermissions Grants permission to list permissions filtered by principal or resource List
ListResources Grants permission to List registered locations List
ListTableStorageOptimizers Grants permission to list all the storage optimizers for the Governed table List
ListTransactions Grants permission to list all transactions in the system List
PutDataLakeSettings Grants permission to overwrite data lake settings such as the list of data lake administrators and database and table default permissions Permissions management
RegisterResource Grants permission to register a new location to be managed by Lake Formation Write
RemoveLFTagsFromResource Grants permission to remove lakeformation tags from catalog resources Tagging
RevokePermissions Grants permission to revoke data lake permissions from a principal Permissions management
SearchDatabasesByLFTags Grants permission to list catalog databases with Lake Formation tags Read
SearchTablesByLFTags Grants permission to list catalog tables with Lake Formation tags Read
StartQueryPlanning Grants permission to initiate the planning of the given query Write
StartTransaction Grants permission to start a new transaction Write
UpdateLFTag Grants permission to update a Lake Formation tag Write
UpdateResource Grants permission to update a registered location Write
UpdateTableObjects Grants permission to add or delete the specified objects to or from a table Write
UpdateTableStorageOptimizer Grants permission to update the configuration of the storage optimizer for the Governed table Write

Resource types defined by AWS Lake Formation

AWS Lake Formation does not support specifying a resource ARN in the Resource element of an IAM policy statement. To allow access to AWS Lake Formation, specify “Resource”: “*” in your policy.

Condition keys for AWS Lake Formation

Lake Formation has no service-specific context keys that can be used in the Condition element of policy statements. For the list of the global context keys that are available to all services, see Available keys for conditions.