PutItem PutItem

yaml
type: "io.kestra.plugin.aws.dynamodb.PutItem"

Put an item into a DynamoDB table. If an item with the same key already exists, the element will be updated.

Examples

Put an item in map form into a table.

yaml
id: "put_item"
type: "io.kestra.plugin.aws.dynamodb.PutItem"
accessKeyId: "<access-key>"
secretKeyId: "<secret-key>"
region: "eu-central-1"
tableName: "persons"
item:
  id: 1
  firstname: "John"
  lastname: "Doe"

Put an item in JSON string form into a table.

yaml
id: "put_item"
type: "io.kestra.plugin.aws.dynamodb.PutItem"
accessKeyId: "<access-key>"
secretKeyId: "<secret-key>"
region: "eu-central-1"
tableName: "persons"
item: "{{ outputs.task_id.data | json }}"

Properties

tableName

  • Type: string
  • Dynamic: ✔️
  • Required: ✔️

The DynamoDB table name.

accessKeyId

  • Type: string
  • Dynamic: ✔️
  • Required:

Access Key Id in order to connect to AWS. If no connection is defined, we will use the DefaultCredentialsProvider to fetch the value.

compatibilityMode

  • Type: boolean
  • Dynamic:
  • Required:

endpointOverride

  • Type: string
  • Dynamic: ✔️
  • Required:

The endpoint with which the SDK should communicate. This property should normally not be used except for local development.

item

  • Type: object
  • Dynamic: ✔️
  • Required:

The DynamoDB item. The item can be in the form of a JSON string, or a map.

region

  • Type: string
  • Dynamic: ✔️
  • Required:

AWS region with which the SDK should communicate.

secretKeyId

  • Type: string
  • Dynamic: ✔️
  • Required:

Secret Key Id in order to connect to AWS. If no connection is defined, we will use the DefaultCredentialsProvider to fetch the value.

sessionToken

  • Type: string
  • Dynamic: ✔️
  • Required:

AWS session token, retrieved from an AWS token service, used for authenticating that this user has received temporary permissions to access a given resource. If no connection is defined, we will use the DefaultCredentialsProvider to fetch the value.