Amazonka.DynamoDB.DescribeLimits

Returns the current provisioned-capacity quotas for your Amazon Web Services account in a Region, both for the Region as a whole and for any one DynamoDB table that you create there.

When you establish an Amazon Web Services account, the account has initial quotas on the maximum read capacity units and write capacity units that you can provision across all of your DynamoDB tables in a given Region. Also, there are per-table quotas that apply when you create a table there. For more information, see Service, Account, and Table Quotas page in the Amazon DynamoDB Developer Guide.

Although you can increase these quotas by filing a case at Amazon Web Services Support Center, obtaining the increase is not instantaneous. The DescribeLimits action lets you write code to compare the capacity you are currently using to those quotas imposed by your account so that you have enough time to apply for an increase before you hit a quota.

For example, you could use one of the Amazon Web Services SDKs to do the following:

1. Call DescribeLimits for a particular Region to obtain your current account quotas on provisioned capacity there.
2. Create a variable to hold the aggregate read capacity units provisioned for all your tables in that Region, and one to hold the aggregate write capacity units. Zero them both.
3. Call ListTables to obtain a list of all your DynamoDB tables.

4. For each table name listed by ListTables, do the following:

   • Call DescribeTable with the table name.
   • Use the data returned by DescribeTable to add the read capacity units and write capacity units provisioned for the table itself to your variables.
   • If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned capacity values to your variables as well.
5. Report the account quotas for that Region returned by DescribeLimits, along with the total current provisioned capacity levels you have calculated.

This will let you see whether you are getting close to your account-level quotas.

The per-table quotas apply only when you are creating a new table. They restrict the sum of the provisioned capacity of the new table itself and all its global secondary indexes.

For existing tables and their GSIs, DynamoDB doesn't let you increase provisioned capacity extremely rapidly, but the only quota that applies is that the aggregate provisioned capacity over all your tables and GSIs cannot exceed either of the per-account quotas.

DescribeLimits should only be called periodically. You can expect throttling errors if you call it more than once in a minute.

The DescribeLimits Request element has no content.

Creating a Request

data DescribeLimits

Represents the input of a DescribeLimits operation. Has no content.

See: newDescribeLimits smart constructor.

Constructors

DescribeLimits'

Instances

ToJSON DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

toJSON :: DescribeLimits -> Value

toEncoding :: DescribeLimits -> Encoding

toJSONList :: [DescribeLimits] -> Value

toEncodingList :: [DescribeLimits] -> Encoding

ToHeaders DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

toHeaders :: DescribeLimits -> [Header]

ToPath DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

toPath :: DescribeLimits -> ByteString

ToQuery DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

toQuery :: DescribeLimits -> QueryString

AWSRequest DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Associated Types

type AWSResponse DescribeLimits

Methods

request :: (Service -> Service) -> DescribeLimits -> Request DescribeLimits

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DescribeLimits -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeLimits)))

Generic DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Associated Types

type Rep DescribeLimits :: Type -> Type

Methods

from :: DescribeLimits -> Rep DescribeLimits x

to :: Rep DescribeLimits x -> DescribeLimits

Read DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

readsPrec :: Int -> ReadS DescribeLimits

readList :: ReadS [DescribeLimits]

readPrec :: ReadPrec DescribeLimits

readListPrec :: ReadPrec [DescribeLimits]

Show DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

showsPrec :: Int -> DescribeLimits -> ShowS

show :: DescribeLimits -> String

showList :: [DescribeLimits] -> ShowS

NFData DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

rnf :: DescribeLimits -> ()

Eq DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

(==) :: DescribeLimits -> DescribeLimits -> Bool

(/=) :: DescribeLimits -> DescribeLimits -> Bool

Hashable DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

hashWithSalt :: Int -> DescribeLimits -> Int

hash :: DescribeLimits -> Int

type AWSResponse DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

type AWSResponse DescribeLimits = DescribeLimitsResponse

type Rep DescribeLimits

Defined in Amazonka.DynamoDB.DescribeLimits

type Rep DescribeLimits = D1 ('MetaData "DescribeLimits" "Amazonka.DynamoDB.DescribeLimits" "amazonka-dynamodb-2.0-GNxlseyeFiu302JKQwQrUS" 'False) (C1 ('MetaCons "DescribeLimits'" 'PrefixI 'False) (U1 :: Type -> Type))

newDescribeLimits :: DescribeLimits

Create a value of DescribeLimits with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

Destructuring the Response

data DescribeLimitsResponse

Represents the output of a DescribeLimits operation.

See: newDescribeLimitsResponse smart constructor.

Constructors

DescribeLimitsResponse'

Fields

• accountMaxReadCapacityUnits :: Maybe Natural

  The maximum total read capacity units that your account allows you to provision across all of your tables in this Region.

• accountMaxWriteCapacityUnits :: Maybe Natural

  The maximum total write capacity units that your account allows you to provision across all of your tables in this Region.

• tableMaxReadCapacityUnits :: Maybe Natural

  The maximum read capacity units that your account allows you to provision for a new table that you are creating in this Region, including the read capacity units provisioned for its global secondary indexes (GSIs).

• tableMaxWriteCapacityUnits :: Maybe Natural

  The maximum write capacity units that your account allows you to provision for a new table that you are creating in this Region, including the write capacity units provisioned for its global secondary indexes (GSIs).

• httpStatus :: Int

  The response's http status code.

Instances

Generic DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

Associated Types

type Rep DescribeLimitsResponse :: Type -> Type

Methods

from :: DescribeLimitsResponse -> Rep DescribeLimitsResponse x

to :: Rep DescribeLimitsResponse x -> DescribeLimitsResponse

Read DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

readsPrec :: Int -> ReadS DescribeLimitsResponse

readList :: ReadS [DescribeLimitsResponse]

readPrec :: ReadPrec DescribeLimitsResponse

readListPrec :: ReadPrec [DescribeLimitsResponse]

Show DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

showsPrec :: Int -> DescribeLimitsResponse -> ShowS

show :: DescribeLimitsResponse -> String

showList :: [DescribeLimitsResponse] -> ShowS

NFData DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

rnf :: DescribeLimitsResponse -> ()

Eq DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

Methods

(==) :: DescribeLimitsResponse -> DescribeLimitsResponse -> Bool

(/=) :: DescribeLimitsResponse -> DescribeLimitsResponse -> Bool

type Rep DescribeLimitsResponse

Defined in Amazonka.DynamoDB.DescribeLimits

type Rep DescribeLimitsResponse = D1 ('MetaData "DescribeLimitsResponse" "Amazonka.DynamoDB.DescribeLimits" "amazonka-dynamodb-2.0-GNxlseyeFiu302JKQwQrUS" 'False) (C1 ('MetaCons "DescribeLimitsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "accountMaxReadCapacityUnits") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "accountMaxWriteCapacityUnits") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))) :*: (S1 ('MetaSel ('Just "tableMaxReadCapacityUnits") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "tableMaxWriteCapacityUnits") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newDescribeLimitsResponse

Arguments

:: Int

$sel:httpStatus:DescribeLimitsResponse'

-> DescribeLimitsResponse

Create a value of DescribeLimitsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:accountMaxReadCapacityUnits:DescribeLimitsResponse', describeLimitsResponse_accountMaxReadCapacityUnits - The maximum total read capacity units that your account allows you to provision across all of your tables in this Region.

$sel:accountMaxWriteCapacityUnits:DescribeLimitsResponse', describeLimitsResponse_accountMaxWriteCapacityUnits - The maximum total write capacity units that your account allows you to provision across all of your tables in this Region.

$sel:tableMaxReadCapacityUnits:DescribeLimitsResponse', describeLimitsResponse_tableMaxReadCapacityUnits - The maximum read capacity units that your account allows you to provision for a new table that you are creating in this Region, including the read capacity units provisioned for its global secondary indexes (GSIs).

$sel:tableMaxWriteCapacityUnits:DescribeLimitsResponse', describeLimitsResponse_tableMaxWriteCapacityUnits - The maximum write capacity units that your account allows you to provision for a new table that you are creating in this Region, including the write capacity units provisioned for its global secondary indexes (GSIs).

$sel:httpStatus:DescribeLimitsResponse', describeLimitsResponse_httpStatus - The response's http status code.

Response Lenses

describeLimitsResponse_accountMaxReadCapacityUnits :: Lens' DescribeLimitsResponse (Maybe Natural)

The maximum total read capacity units that your account allows you to provision across all of your tables in this Region.

describeLimitsResponse_accountMaxWriteCapacityUnits :: Lens' DescribeLimitsResponse (Maybe Natural)

The maximum total write capacity units that your account allows you to provision across all of your tables in this Region.

describeLimitsResponse_tableMaxReadCapacityUnits :: Lens' DescribeLimitsResponse (Maybe Natural)

The maximum read capacity units that your account allows you to provision for a new table that you are creating in this Region, including the read capacity units provisioned for its global secondary indexes (GSIs).

describeLimitsResponse_tableMaxWriteCapacityUnits :: Lens' DescribeLimitsResponse (Maybe Natural)

The maximum write capacity units that your account allows you to provision for a new table that you are creating in this Region, including the write capacity units provisioned for its global secondary indexes (GSIs).

describeLimitsResponse_httpStatus :: Lens' DescribeLimitsResponse Int

The response's http status code.