RedshiftServerless / Client / create_usage_limit

create_usage_limit#

RedshiftServerless.Client.create_usage_limit(**kwargs)#

Creates a usage limit for a specified Amazon Redshift Serverless usage type. The usage limit is identified by the returned usage limit identifier.

See also: AWS API Documentation

Request Syntax

response = client.create_usage_limit(
    amount=123,
    breachAction='log'|'emit-metric'|'deactivate',
    period='daily'|'weekly'|'monthly',
    resourceArn='string',
    usageType='serverless-compute'|'cross-region-datasharing'
)
Parameters:

  • amount (integer) –

    [REQUIRED]

    The 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 action that Amazon Redshift Serverless takes when the limit is reached. The default is log.

  • period (string) – The time period that the amount applies to. A weekly period begins on Sunday. The default is monthly.

  • resourceArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the Amazon Redshift Serverless resource to create the usage limit for.

  • usageType (string) –

    [REQUIRED]

    The type of Amazon Redshift Serverless usage to create a usage limit for.

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 returned 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

  • RedshiftServerless.Client.exceptions.ServiceQuotaExceededException