v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14238527879.4 KB

Creates a usage limit for a specified Amazon Redshift feature on a cluster. The usage limit is identified by the returned usage limit identifier.

get/#Action=CreateUsageLimit

Query parameters

ClusterIdentifierstring required

The identifier of the cluster that you want to limit usage.

FeatureType'spectrum' | 'concurrency-scaling' | 'cross-region-datasharing' required

The Amazon Redshift feature that you want to limit.

LimitType'time' | 'data-scanned' required

The type of limit. Depending on the feature type, this can be based on a time duration or data size. If <code>FeatureType</code> is <code>spectrum</code>, then <code>LimitType</code> must be <code>data-scanned</code>. If <code>FeatureType</code> is <code>concurrency-scaling</code>, then <code>LimitType</code> must be <code>time</code>. If <code>FeatureType</code> is <code>cross-region-datasharing</code>, then <code>LimitType</code> must be <code>data-scanned</code>.

Amountinteger required

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

Period'daily' | 'weekly' | 'monthly'

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

BreachAction'log' | 'emit-metric' | 'disable'

The action that Amazon Redshift takes when the limit is reached. The default is log. For more information about this parameter, see <a>UsageLimit</a>.

Keystring

The key, or name, for the resource tag.

Valuestring

The value for the resource tag.

A list of tag instances.

Action'CreateUsageLimit' required
Version'2012-12-01' required

Response

Success