[ aws . ddb ]

put

Description

put puts one or more items into a table.

See ‘aws help’ for descriptions of global parameters.

Synopsis

  put
<table-name>
<items>
[--condition <value> [<value>...]]

Options

table_name (string)

The name of your DynamoDB table.

items (string)

One or more items to put into the table, in YAML format.

--condition (string)

A condition that must be satisfied in order for a conditional put operation to succeed.

For more information, see Comparison Operator and Function Reference in the Amazon DynamoDB Developer Guide

For CLI specific syntax see aws help ddb-expressions

See ‘aws help’ for descriptions of global parameters.

Examples

Note

To use the following examples, you must have the AWS CLI installed and configured. See the Getting started guide in the AWS CLI User Guide for more information.

Unless otherwise stated, all examples have unix-like quotation rules. These examples will need to be adapted to your terminal’s quoting rules. See Using quotation marks with strings in the AWS CLI User Guide .

To add an item to a table

This example adds a new item to the MusicCollection table.

Command:

aws ddb put MusicCollection '{Artist: "No One You Know", SongTitle: "Call Me Today", AlbumTitle: "Somewhat Famous"}'

To add items to a table from a file

This example adds two new items from a file to the MusicCollection table.

Command:

aws ddb put MusicCollection file://items.json

The items to add to the table are in a JSON file, items.json. Here are the contents of that file:

[
    {
        "Artist": "No One You Know",
        "SongTitle": "Call Me Today",
        "AlbumTitle": "Somewhat Famous"
    },
    {
        "Artist": "No One You Know",
        "SongTitle": "Scared of My Shadow",
        "AlbumTitle": "Blue Sky Blues"
    }
]

To add items to a table from stdin

This example adds a new item to the MusicCollection table by reading it from stdin.

Command:

echo '{Artist: "No One You Know", SongTitle: "Call Me Today"}' \
    | aws ddb put MusicCollection -

Conditional Expressions

This example shows how to perform a one-line conditional operation. This put call to the table MusicCollection table will only succeed if the artist “Obscure Indie Band” does not exist in the table.

Command:

aws ddb put MusicCollection '{Artist: "Obscure Indie Band", SongTitle: "Atlas"}' \
    --condition 'attribute_not_exists(Artist)'

If the key already exists, you should see:

Output:

A client error (ConditionalCheckFailedException) occurred when calling the PutItem operation: The conditional request failed