:doc:`LakeFormation <../../lakeformation>` / Client / update_lf_tag

*************
update_lf_tag
*************



.. py:method:: LakeFormation.Client.update_lf_tag(**kwargs)

  

  Updates the list of possible values for the specified LF-tag key. If the LF-tag does not exist, the operation throws an EntityNotFoundException. The values in the delete key values will be deleted from list of possible values. If any value in the delete key values is attached to a resource, then API errors out with a 400 Exception - "Update not allowed". Untag the attribute before deleting the LF-tag key's value.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/UpdateLFTag>`_  


  **Request Syntax**
  ::

    response = client.update_lf_tag(
        CatalogId='string',
        TagKey='string',
        TagValuesToDelete=[
            'string',
        ],
        TagValuesToAdd=[
            'string',
        ]
    )
    
  :type CatalogId: string
  :param CatalogId: 

    The identifier for the Data Catalog. By default, the account ID. The Data Catalog is the persistent metadata store. It contains database definitions, table definitions, and other control information to manage your Lake Formation environment.

    

  
  :type TagKey: string
  :param TagKey: **[REQUIRED]** 

    The key-name for the LF-tag for which to add or delete values.

    

  
  :type TagValuesToDelete: list
  :param TagValuesToDelete: 

    A list of LF-tag values to delete from the LF-tag.

    

  
    - *(string) --* 

    

  :type TagValuesToAdd: list
  :param TagValuesToAdd: 

    A list of LF-tag values to add from the LF-tag.

    

  
    - *(string) --* 

    

  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`LakeFormation.Client.exceptions.EntityNotFoundException`

  
  *   :py:class:`LakeFormation.Client.exceptions.InvalidInputException`

  
  *   :py:class:`LakeFormation.Client.exceptions.InternalServiceException`

  
  *   :py:class:`LakeFormation.Client.exceptions.OperationTimeoutException`

  
  *   :py:class:`LakeFormation.Client.exceptions.ConcurrentModificationException`

  
  *   :py:class:`LakeFormation.Client.exceptions.AccessDeniedException`

  