View a markdown version of this page

Tagging DynamoDB Streams - Amazon DynamoDB
Tagging existing streams (Amazon Web Services Management Console)Tagging existing streams (Amazon CLI)
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Tagging DynamoDB Streams

Tagging on creation not supported

DynamoDB Streams does not currently support tagging on creation. You can only add tags to existing streams.

You can use the Amazon DynamoDB console, Amazon Command Line Interface (Amazon CLI), or Amazon SDK to manage tags on existing DynamoDB Streams. You can then activate these user-defined tags so that they appear on the Amazon Billing and Cost Management console for cost allocation tracking. For more information, see Using DynamoDB tags to create cost allocation reports.

Tagging existing streams (Amazon Web Services Management Console)

You can use the DynamoDB console to add, edit, or delete tags for existing streams.

To tag an existing stream (console)

Open the DynamoDB console at https://console.amazonaws.cn/dynamodb/.

  1. In the navigation pane, choose Tables.

  2. Choose the table whose stream you want to tag.

  3. Choose the Exports and streams tab.

  4. In the DynamoDB stream details section, choose Manage tags.

  5. Add the tags you want and choose Save.

    For information about tag structure, see Tagging restrictions in DynamoDB.

The following screenshot shows the Manage tags page for a DynamoDB stream, where you add key-value tag pairs and then choose Save changes.

The Manage tags page in the DynamoDB console for a stream on the Movies table, showing empty Key and Value fields, an Add new tag button, and a Save changes button.

Tagging existing streams (Amazon CLI)

The following examples show how to use the Amazon CLI to tag existing streams and list tags for a stream.

To tag an existing stream (Amazon CLI)

  • The following example adds the Owner tag with a value of blueTeam to an existing stream on the Movies table:

    aws dynamodb tag-resource \
    --resource-arn arn:aws:dynamodb:us-east-1:111122223333:table/Movies/stream/2024-01-01T00:00:00.000 \
    --tags Key=Owner,Value=blueTeam
To list all tags for a stream (Amazon CLI)

  • The following example lists all the tags that are associated with a stream on the Movies table:

    aws dynamodb list-tags-of-resource \
    --resource-arn arn:aws:dynamodb:us-east-1:111122223333:table/Movies/stream/2024-01-01T00:00:00.000