Creates a new item, or replaces an old item with a new item (including all the attributes).
If an item already exists in the specified table with the same primary key, the new item completely replaces the existing item. You can perform a conditional put (insert a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values.
Declaration Syntax
C# |
PutItemResponse PutItem( PutItemRequest putItemRequest )
Parameters
- putItemRequest (PutItemRequest)
- Container for the necessary parameters to execute the PutItem service method on AmazonDynamoDB.
Return Value
The response from the PutItem service method, as returned by AmazonDynamoDB.
Examples
This example shows how to put an item in a table.
CopyPutItem sample
// Create a client AmazonDynamoDBClient client = new AmazonDynamoDBClient(); // Define item attributes Dictionary<string, AttributeValue> attributes = new Dictionary<string, AttributeValue>(); // Author is hash-key attributes["Author"] = new AttributeValue { S = "Mark Twain" }; // Title is range-key attributes["Title"] = new AttributeValue { S = "The Adventures of Tom Sawyer" }; // Other attributes attributes["Year"] = new AttributeValue { N = "1876" }; attributes["Setting"] = new AttributeValue { S = "Missouri" }; attributes["Pages"] = new AttributeValue { N = "275" }; attributes["Genres"] = new AttributeValue { SS = new List<string> { "Satire", "Folk", "Children's Novel" } }; // Create PutItem request PutItemRequest request = new PutItemRequest { TableName = "SampleTable", Item = attributes }; // Issue PutItem request client.PutItem(request);
Exceptions