[ 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

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