Redshift / Client / modify_usage_limit

modify_usage_limit#

Redshift.Client.modify_usage_limit(**kwargs)#

Modifies a usage limit in a cluster. You can’t modify the feature type or period of a usage limit.

See also: AWS API Documentation

Request Syntax

response = client.modify_usage_limit(
    UsageLimitId='string',
    Amount=123,
    BreachAction='log'|'emit-metric'|'disable'
)
Parameters:
  • UsageLimitId (string) –

    [REQUIRED]

    The identifier of the usage limit to modify.

  • Amount (integer) – The new limit amount. For more information about this parameter, see UsageLimit.

  • BreachAction (string) – The new action that Amazon Redshift takes when the limit is reached. For more information about this parameter, see UsageLimit.

Return type:

dict

Returns:

Response Syntax

{
    'UsageLimitId': 'string',
    'ClusterIdentifier': 'string',
    'FeatureType': 'spectrum'|'concurrency-scaling'|'cross-region-datasharing',
    'LimitType': 'time'|'data-scanned',
    'Amount': 123,
    'Period': 'daily'|'weekly'|'monthly',
    'BreachAction': 'log'|'emit-metric'|'disable',
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    Describes a usage limit object for a cluster.

    • UsageLimitId (string) –

      The identifier of the usage limit.

    • ClusterIdentifier (string) –

      The identifier of the cluster with a usage limit.

    • FeatureType (string) –

      The Amazon Redshift feature to which the limit applies.

    • LimitType (string) –

      The type of limit. Depending on the feature type, this can be based on a time duration or data size.

    • Amount (integer) –

      The limit amount. If time-based, this amount is in minutes. If data-based, this amount is in terabytes (TB).

    • Period (string) –

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

    • BreachAction (string) –

      The action that Amazon Redshift takes when the limit is reached. Possible values are:

      • log - To log an event in a system table. The default is log.

      • emit-metric - To emit CloudWatch metrics.

      • disable - To disable the feature until the next usage period begins.

    • Tags (list) –

      A list of tag instances.

      • (dict) –

        A tag consisting of a name/value pair for a resource.

        • Key (string) –

          The key, or name, for the resource tag.

        • Value (string) –

          The value for the resource tag.

Exceptions

  • Redshift.Client.exceptions.InvalidUsageLimitFault

  • Redshift.Client.exceptions.UsageLimitNotFoundFault

  • Redshift.Client.exceptions.UnsupportedOperationFault