DynamoDBAction (AWS Java SDK :: Services :: IoT Events 2.17.112 API)

java.lang.Object
- software.amazon.awssdk.services.iotevents.model.DynamoDBAction

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<DynamoDBAction.Builder,DynamoDBAction>
```
@Generated(value="software.amazon.awssdk:codegen")
public final class DynamoDBAction
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<DynamoDBAction.Builder,DynamoDBAction>
```
Defines an action to write to the Amazon DynamoDB table that you created. The standard action payload contains all the information about the detector model instance and the event that triggered the action. You can customize the payload. One column of the DynamoDB table receives all attribute-value pairs in the payload that you specify.

You must use expressions for all parameters in DynamoDBAction. The expressions accept literals, operators, functions, references, and substitution templates.

Examples
- For literal values, the expressions must contain single quotes. For example, the value for the hashKeyType parameter can be 'STRING'.
- For references, you must specify either variables or input values. For example, the value for the hashKeyField parameter can be $input.GreenhouseInput.name.
- For a substitution template, you must use ${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.
  
  In the following example, the value for the hashKeyValue parameter uses a substitution template.
  
  '${$input.GreenhouseInput.temperature * 6 / 5 + 32} in Fahrenheit'
- For a string concatenation, you must use +. A string concatenation can also contain a combination of literals, operators, functions, references, and substitution templates.
  
  In the following example, the value for the tableName parameter uses a string concatenation.
  
  'GreenhouseTemperatureTable ' + $input.GreenhouseInput.date
For more information, see Expressions in the AWS IoT Events Developer Guide.

If the defined payload type is a string, DynamoDBAction writes non-JSON data to the DynamoDB table as binary data. The DynamoDB console displays the data as Base64-encoded text. The value for the payloadField parameter is <payload-field>_raw.
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface DynamoDBAction.Builder

Nested Classes
Modifier and Type	Class and Description
`static interface`	`DynamoDBAction.Builder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static DynamoDBAction.Builder`	`builder()`
`boolean`	`equals(Object obj)`
`boolean`	`equalsBySdkFields(Object obj)`
`<T> Optional<T>`	`getValueForField(String fieldName, Class<T> clazz)`
`int`	`hashCode()`
`String`	`hashKeyField()` The name of the hash key (also called the partition key).
`String`	`hashKeyType()` The data type for the hash key (also called the partition key).
`String`	`hashKeyValue()` The value of the hash key (also called the partition key).
`String`	`operation()` The type of operation to perform.
`Payload`	`payload()` Returns the value of the Payload property for this object.
`String`	`payloadField()` The name of the DynamoDB column that receives the action payload.
`String`	`rangeKeyField()` The name of the range key (also called the sort key).
`String`	`rangeKeyType()` The data type for the range key (also called the sort key), You can specify the following values:
`String`	`rangeKeyValue()` The value of the range key (also called the sort key).
`List<SdkField<?>>`	`sdkFields()`
`static Class<? extends DynamoDBAction.Builder>`	`serializableBuilderClass()`
`String`	`tableName()` The name of the DynamoDB table.
`DynamoDBAction.Builder`	`toBuilder()`
`String`	`toString()` Returns a string representation of this object.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy

- Method Detail
  - hashKeyType
```
public final String hashKeyType()
```
    The data type for the hash key (also called the partition key). You can specify the following values:
    - 'STRING' - The hash key is a string.
    - 'NUMBER' - The hash key is a number.
    If you don't specify hashKeyType, the default value is 'STRING'.
    Returns:
    The data type for the hash key (also called the partition key). You can specify the following values:
    
    'STRING' - The hash key is a string.
    
    'NUMBER' - The hash key is a number.
    
    If you don't specify hashKeyType, the default value is 'STRING'.
  - hashKeyField
```
public final String hashKeyField()
```
    The name of the hash key (also called the partition key). The hashKeyField value must match the partition key of the target DynamoDB table.
    
    Returns:
    
    The name of the hash key (also called the partition key). The hashKeyField value must match the partition key of the target DynamoDB table.
  - hashKeyValue
```
public final String hashKeyValue()
```
    The value of the hash key (also called the partition key).
    
    Returns:
    
    The value of the hash key (also called the partition key).
  - rangeKeyType
```
public final String rangeKeyType()
```
    The data type for the range key (also called the sort key), You can specify the following values:
    - 'STRING' - The range key is a string.
    - 'NUMBER' - The range key is number.
    If you don't specify rangeKeyField, the default value is 'STRING'.
    Returns:
    The data type for the range key (also called the sort key), You can specify the following values:
    
    'STRING' - The range key is a string.
    
    'NUMBER' - The range key is number.
    
    If you don't specify rangeKeyField, the default value is 'STRING'.
  - rangeKeyField
```
public final String rangeKeyField()
```
    The name of the range key (also called the sort key). The rangeKeyField value must match the sort key of the target DynamoDB table.
    
    Returns:
    
    The name of the range key (also called the sort key). The rangeKeyField value must match the sort key of the target DynamoDB table.
  - rangeKeyValue
```
public final String rangeKeyValue()
```
    The value of the range key (also called the sort key).
    
    Returns:
    
    The value of the range key (also called the sort key).
  - operation
```
public final String operation()
```
    The type of operation to perform. You can specify the following values:
    - 'INSERT' - Insert data as a new item into the DynamoDB table. This item uses the specified hash key as a partition key. If you specified a range key, the item uses the range key as a sort key.
    - 'UPDATE' - Update an existing item of the DynamoDB table with new data. This item's partition key must match the specified hash key. If you specified a range key, the range key must match the item's sort key.
    - 'DELETE' - Delete an existing item of the DynamoDB table. This item's partition key must match the specified hash key. If you specified a range key, the range key must match the item's sort key.
    If you don't specify this parameter, AWS IoT Events triggers the 'INSERT' operation.
    Returns:
    The type of operation to perform. You can specify the following values:
    
    'INSERT' - Insert data as a new item into the DynamoDB table. This item uses the specified hash key as a partition key. If you specified a range key, the item uses the range key as a sort key.
    
    'UPDATE' - Update an existing item of the DynamoDB table with new data. This item's partition key must match the specified hash key. If you specified a range key, the range key must match the item's sort key.
    
    'DELETE' - Delete an existing item of the DynamoDB table. This item's partition key must match the specified hash key. If you specified a range key, the range key must match the item's sort key.
    
    If you don't specify this parameter, AWS IoT Events triggers the 'INSERT' operation.
  - payloadField
```
public final String payloadField()
```
    The name of the DynamoDB column that receives the action payload.
    
    If you don't specify this parameter, the name of the DynamoDB column is payload.
    
    Returns:
    
    The name of the DynamoDB column that receives the action payload.
    
    If you don't specify this parameter, the name of the DynamoDB column is payload.
  - tableName
```
public final String tableName()
```
    The name of the DynamoDB table. The tableName value must match the table name of the target DynamoDB table.
    
    Returns:
    
    The name of the DynamoDB table. The tableName value must match the table name of the target DynamoDB table.
  - payload
```
public final Payload payload()
```
    Returns the value of the Payload property for this object.
    
    Returns:
    
    The value of the Payload property for this object.
  - toBuilder
```
public DynamoDBAction.Builder toBuilder()
```
    Specified by:
    
    toBuilder in interface ToCopyableBuilder<DynamoDBAction.Builder,DynamoDBAction>
  - builder
```
public static DynamoDBAction.Builder builder()
```
  - serializableBuilderClass
```
public static Class<? extends DynamoDBAction.Builder> serializableBuilderClass()
```
  - hashCode
```
public final int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public final boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - equalsBySdkFields
```
public final boolean equalsBySdkFields(Object obj)
```
    Specified by:
    
    equalsBySdkFields in interface SdkPojo
  - toString
```
public final String toString()
```
    Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
    
    Overrides:
    
    toString in class Object
  - getValueForField
```
public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)
```
  - sdkFields
```
public final List<SdkField<?>> sdkFields()
```
    Specified by:
    
    sdkFields in interface SdkPojo

Class DynamoDBAction

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

Method Detail

hashKeyType

hashKeyField

hashKeyValue

rangeKeyType

rangeKeyField

rangeKeyValue

operation

payloadField

tableName

payload

toBuilder

builder

serializableBuilderClass

hashCode

equals

equalsBySdkFields

toString

getValueForField

sdkFields