AWS SDK for .NET Documentation
DeleteItem Method (deleteItemRequest)
Amazon ► Amazon.DynamoDB ► AmazonDynamoDB ► DeleteItem(DeleteItemRequest)
Did this page help you? Yes No Tell us about it...

Deletes a single item in a table by primary key.

You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

Declaration Syntax

C#

    DeleteItemResponse DeleteItem(
    	DeleteItemRequest deleteItemRequest
    )

Parameters

deleteItemRequest (DeleteItemRequest)
  Container for the necessary parameters to execute the DeleteItem service method on AmazonDynamoDB.

Return Value
The response from the DeleteItem service method, as returned by AmazonDynamoDB.
Examples

This example shows how to delete an item in a table.

CopyDeleteItem sample

    // Create a client
    AmazonDynamoDBClient client = new AmazonDynamoDBClient();

    // Define item key
    //  Hash-key of the target item is string value "Mark Twain"
    //  Range-key of the target item is string value "The Adventures of Tom Sawyer"
    Key key = new Key
    {
        HashKeyElement = new AttributeValue { S = "Mark Twain" },
        RangeKeyElement = new AttributeValue { S = "The Adventures of Tom Sawyer" }
    };

    // Create DeleteItem request
    DeleteItemRequest request = new DeleteItemRequest
    {
        TableName = "SampleTable",
        Key = key
    };

    // Issue request
    client.DeleteItem(request);

Exceptions

Exception | Condition
--- | ---
ProvisionedThroughputExceededException |
ConditionalCheckFailedException |
InternalServerErrorException |
ResourceNotFoundException |

Assembly: AWSSDK (Module: AWSSDK) Version: 1.5.60.0 (1.5.60.0)