Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given table.
You can only perform one of the following operations at once:
- Modify the provisioned throughput settings of the table.
- Enable or disable Streams on the table.
- Remove a global secondary index from the table.
- Create a new global secondary index on the table. Once the index begins backfilling, you can use
UpdateTable
to perform other operations.
UpdateTable
is an asynchronous operation; while it is executing, the table status changes from ACTIVE
to UPDATING
. While it is UPDATING
, you cannot issue another UpdateTable
request. When the table returns to the ACTIVE
state, the UpdateTable
operation is complete.
Synopsis
- updateTable :: Text -> UpdateTable
- data UpdateTable
- utAttributeDefinitions :: Lens' UpdateTable [AttributeDefinition]
- utProvisionedThroughput :: Lens' UpdateTable (Maybe ProvisionedThroughput)
- utGlobalSecondaryIndexUpdates :: Lens' UpdateTable [GlobalSecondaryIndexUpdate]
- utStreamSpecification :: Lens' UpdateTable (Maybe StreamSpecification)
- utTableName :: Lens' UpdateTable Text
- updateTableResponse :: Int -> UpdateTableResponse
- data UpdateTableResponse
- utrsTableDescription :: Lens' UpdateTableResponse (Maybe TableDescription)
- utrsResponseStatus :: Lens' UpdateTableResponse Int
Creating a Request
Creates a value of UpdateTable
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
utAttributeDefinitions
- An array of attributes that describe the key schema for the table and indexes. If you are adding a new global secondary index to the table,AttributeDefinitions
must include the key element(s) of the new index.utProvisionedThroughput
- The new provisioned throughput settings for the specified table or index.utGlobalSecondaryIndexUpdates
- An array of one or more global secondary indexes for the table. For each index in the array, you can request one action: *Create
- add a new global secondary index to the table. *Update
- modify the provisioned throughput settings of an existing global secondary index. *Delete
- remove a global secondary index from the table. For more information, see Managing Global Secondary Indexes in the Amazon DynamoDB Developer Guide .utStreamSpecification
- Represents the DynamoDB Streams configuration for the table.utTableName
- The name of the table to be updated.
data UpdateTable Source #
Represents the input of an UpdateTable
operation.
See: updateTable
smart constructor.
Instances
Request Lenses
utAttributeDefinitions :: Lens' UpdateTable [AttributeDefinition] Source #
An array of attributes that describe the key schema for the table and indexes. If you are adding a new global secondary index to the table, AttributeDefinitions
must include the key element(s) of the new index.
utProvisionedThroughput :: Lens' UpdateTable (Maybe ProvisionedThroughput) Source #
The new provisioned throughput settings for the specified table or index.
utGlobalSecondaryIndexUpdates :: Lens' UpdateTable [GlobalSecondaryIndexUpdate] Source #
An array of one or more global secondary indexes for the table. For each index in the array, you can request one action: * Create
- add a new global secondary index to the table. * Update
- modify the provisioned throughput settings of an existing global secondary index. * Delete
- remove a global secondary index from the table. For more information, see Managing Global Secondary Indexes in the Amazon DynamoDB Developer Guide .
utStreamSpecification :: Lens' UpdateTable (Maybe StreamSpecification) Source #
Represents the DynamoDB Streams configuration for the table.
utTableName :: Lens' UpdateTable Text Source #
The name of the table to be updated.
Destructuring the Response
Creates a value of UpdateTableResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
utrsTableDescription
- Represents the properties of the table.utrsResponseStatus
- -- | The response status code.
data UpdateTableResponse Source #
Represents the output of an UpdateTable
operation.
See: updateTableResponse
smart constructor.
Instances
Response Lenses
utrsTableDescription :: Lens' UpdateTableResponse (Maybe TableDescription) Source #
Represents the properties of the table.
utrsResponseStatus :: Lens' UpdateTableResponse Int Source #
- - | The response status code.