CloudWatchLogs / Client / update_lookup_table

update_lookup_table

CloudWatchLogs.Client.update_lookup_table(**kwargs)

Updates an existing lookup table by replacing all of its content with new CSV data or CloudWatch Logs query results. After the update completes, queries that use this table use the new data.

This is a full replacement operation. All existing content is replaced. You must specify either tableBody or queryId, but not both.

See also: AWS API Documentation

Request Syntax

response = client.update_lookup_table(
    lookupTableArn='string',
    description='string',
    tableBody='string',
    queryId='string',
    kmsKeyId='string'
)
Parameters:

  • lookupTableArn (string) –

    [REQUIRED]

    The ARN of the lookup table to update.

  • description (string) – An updated description of the lookup table.

  • tableBody (string) –

    The new CSV content to replace the existing data. The first row must be a header row with column names. The content must use UTF-8 encoding and not exceed 10 MB.

    You must specify either tableBody or queryId, but not both.

  • queryId (string) –

    The ID of a completed or cancelled CloudWatch Logs query whose results replace the lookup table content. A cancelled query replaces the content with the partial results that were available when the query was stopped.

    You must specify either tableBody or queryId, but not both.

  • kmsKeyId (string) – The ARN of the KMS key to use to encrypt the lookup table data. You can use this parameter to add, update, or remove the KMS key. To remove the KMS key and use an Amazon Web Services-owned key instead, specify an empty string.

Return type:

dict

Returns:

Response Syntax

{
    'lookupTableArn': 'string',
    'lastUpdatedTime': 123
}

Response Structure

  • (dict) –

    • lookupTableArn (string) –

      The ARN of the lookup table that was updated.

    • lastUpdatedTime (integer) –

      The time when the lookup table was last updated, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

Exceptions

  • CloudWatchLogs.Client.exceptions.InvalidParameterException

  • CloudWatchLogs.Client.exceptions.ResourceNotFoundException

  • CloudWatchLogs.Client.exceptions.AccessDeniedException

  • CloudWatchLogs.Client.exceptions.ValidationException

  • CloudWatchLogs.Client.exceptions.ServiceUnavailableException