/* * Copyright 2010-2014 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ /* * Do not modify this file. This file is generated from the dynamodb-2012-08-10.normal.json service model. */ using System; using System.Collections.Generic; using System.Xml.Serialization; using System.Text; using System.IO; using Amazon.Runtime; using Amazon.Runtime.Internal; namespace Amazon.DynamoDBv2.Model { /// /// Container for the parameters to the DescribeLimits operation. /// Returns the current provisioned-capacity limits for your AWS 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 AWS account, the account has initial limits 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 limits that apply when /// you create a table there. For more information, see Limits /// page in the Amazon DynamoDB Developer Guide. /// /// /// /// Although you can increase these limits by filing a case at AWS /// 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 /// limits imposed by your account so that you have enough time to apply for an increase /// before you hit a limit. /// /// /// /// For example, you could use one of the AWS SDKs to do the following: /// ///
  1. /// /// Call DescribeLimits for a particular Region to obtain your current account /// limits 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 limits 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 limits. /// /// /// /// The per-table limits 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 upper limit that applies is that the aggregate /// provisioned capacity over all your tables and GSIs cannot exceed either of the per-account /// limits. /// /// /// /// 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. /// ///
public partial class DescribeLimitsRequest : AmazonDynamoDBRequest { } }