Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Updating LF-Tag expressions
Only data lake administrators, the LF-Tag expression creator, and principals that have
Alter
or Super
permission on the LF-Tag expression can
update an LF-Tag expression. In addition to Alter
permission, you also
need the lakeformation:UpdateLFTagExpression
IAM permission and Grant
with LF-Tag
permission on all underlying keys-values on the new expression body to
update expressions.
You update an LF-Tag expression by updating the description, expression body and
permissions granted on the expression. You can't change the name of the LF-Tag
expression. To change the name, delete the LF-Tag expression and add one with the
required parameters.
You can update an LF-Tag expression by using the Amazon Lake Formation console, the API, or the
Amazon Command Line Interface (Amazon CLI).
- Console
-
To update an LF-Tag expression
-
Open the Lake Formation console at
https://console.amazonaws.cn/lakeformation/.
Sign in as a data lake administrator, the LF-Tag creator or a principal
with Alter
permission on the LF-Tag.
-
In the navigation pane, under permissions, choose LF-Tags and permissions.
-
Choose LF-Tag expressions tab.
-
On the LF-Tag expressions section, select an
LF-Tag expression, and then choose Edit.
-
In the Edit LF-Tag expression dialog box, update
the description and update the expression body by adding or removing keys and
values.
To add multiple values, in the Values field, choose the values from the drop down.
-
Choose Save.
- Amazon CLI
-
The update-lf-tag-expression command in Lake Formation allows you to update an existing LF-Tag expression.
aws lakeformation update-lf-tag-expression \
-- name expression_name
\
-- description new_description
\
-- catalog-id catalog_id
\
-- expression '{"Expression": [{"TagKey": "tag_key
", "TagValues": ["tag_value1
", "tag_value2
", ...]}]}'
Here's what the parameters in the provided command mean:
-
name – The name of the existing named tag expression that you want to
update.
description – A new description for the expression.
catalog-id – The ID of the Data Catalog where the named tag expression
resides.
expression – The new tag expression string that you want to update the
expression with.