aws/dist/awscli/examples/ddb/put.rst

**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