/* * Copyright 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 System.Net; using Amazon.Runtime; using Amazon.Runtime.Internal; namespace Amazon.DynamoDBv2.Model { /// /// Container for the parameters to the DescribeLimits operation. /// 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. /// ///
public partial class DescribeLimitsRequest : AmazonDynamoDBRequest { } }