RedshiftServerless / Client / update_usage_limit

update_usage_limit#

RedshiftServerless.Client.update_usage_limit(**kwargs)#

Update a usage limit in Amazon Redshift Serverless. You can’t update the usage type or period of a usage limit.

See also: AWS API Documentation

Request Syntax

response = client.update_usage_limit(
    amount=123,
    breachAction='log'|'emit-metric'|'deactivate',
    usageLimitId='string'
)
Parameters:

  • amount (integer) – The new limit amount. If time-based, this amount is in Redshift Processing Units (RPU) consumed per hour. If data-based, this amount is in terabytes (TB) of data transferred between Regions in cross-account sharing. The value must be a positive number.

  • breachAction (string) – The new action that Amazon Redshift Serverless takes when the limit is reached.

  • usageLimitId (string) –

    [REQUIRED]

    The identifier of the usage limit to update.

Return type:

dict

Returns:

Response Syntax

{
    'usageLimit': {
        'amount': 123,
        'breachAction': 'log'|'emit-metric'|'deactivate',
        'period': 'daily'|'weekly'|'monthly',
        'resourceArn': 'string',
        'usageLimitArn': 'string',
        'usageLimitId': 'string',
        'usageType': 'serverless-compute'|'cross-region-datasharing'
    }
}

Response Structure

  • (dict) –

    • usageLimit (dict) –

      The updated usage limit object.

      • amount (integer) –

        The limit amount. If time-based, this amount is in RPUs consumed per hour. If data-based, this amount is in terabytes (TB). The value must be a positive number.

      • breachAction (string) –

        The action that Amazon Redshift Serverless takes when the limit is reached.

      • period (string) –

        The time period that the amount applies to. A weekly period begins on Sunday. The default is monthly.

      • resourceArn (string) –

        The Amazon Resource Name (ARN) that identifies the Amazon Redshift Serverless resource.

      • usageLimitArn (string) –

        The Amazon Resource Name (ARN) of the resource associated with the usage limit.

      • usageLimitId (string) –

        The identifier of the usage limit.

      • usageType (string) –

        The Amazon Redshift Serverless feature to limit.

Exceptions

  • RedshiftServerless.Client.exceptions.InternalServerException

  • RedshiftServerless.Client.exceptions.ResourceNotFoundException

  • RedshiftServerless.Client.exceptions.ConflictException

  • RedshiftServerless.Client.exceptions.ValidationException