Skip to content
Proud to collaborate with Microsoft for Startups

aws.dynamodb.update_table ​

Call AWS DynamoDB UpdateTable using a CloudConnection UUID.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryBase-aws
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidYes—Authenticated organization UUID used for field resolution and connection scoping.
connection_uuiduuidYes—AWS CloudConnection UUID for the target DynamoDB account, scoped to the caller organization.
workflow_run_idstringNo—Engine DAG run ID stamped onto child steps.
regionstringNo—AWS API endpoint region override; omit to use the connection or SDK default.
attribute_definitionslistNo—An array of attributes that describe the key schema for the table and indexes. If you are adding a new global secondary index to the table, AttributeDefinitions must include the key element(s) of t...
table_namestringYes—The name of the table to be updated. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.
billing_modestringNo—Controls how you are charged for read and write throughput and how you manage capacity. When switching from pay-per-request to provisioned capacity, initial provisioned capacity values must be set....
provisioned_throughputjsonNo—The new provisioned throughput settings for the specified table or index.
global_secondary_index_updateslistNo—An array of one or more global secondary indexes for the table. For each index in the array, you can request one action: Create - add a new global secondary index to the table. Update - modify the...
stream_specificationjsonNo—Represents the DynamoDB Streams configuration for the table. You receive a ValidationException if you try to enable a stream on a table that already has a stream, or if you try to disable a stream...
sse_specificationjsonNo—The new server-side encryption settings for the specified table.
replica_updateslistNo—A list of replica update actions (create, delete, or update) for the table.
table_classstringNo—The table class of the table to be updated. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.
deletion_protection_enabledbooleanNo—Indicates whether deletion protection is to be enabled (true) or disabled (false) on the table.
multi_region_consistencystringNo—Specifies the consistency mode for a new global table. This parameter is only valid when you create a global table by specifying one or more Create actions in the ReplicaUpdates action list. You ca...
global_table_witness_updateslistNo—A list of witness updates for a MRSC global table. A witness provides a cost-effective alternative to a full replica in a MRSC global table by maintaining replicated change data written to global t...
on_demand_throughputjsonNo—Updates the maximum number of read and write units for the specified table in on-demand capacity mode. If you use this parameter, you must specify MaxReadRequestUnits, MaxWriteRequestUnits, or both.
warm_throughputjsonNo—Represents the warm throughput (in read units per second and write units per second) for updating a table.
global_table_settings_replication_modestringNo—Controls the settings replication mode for a global table replica. This attribute can be defined using UpdateTable operation only on a regional table with values: ENABLED: Defines settings replicat...
provider_native_requestjsonNo—Optional provider-native request overrides for AWS parameters not yet promoted to first-class fields.

Output Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidNo—Organization UUID echoed from input.
connection_uuiduuidNo—AWS CloudConnection UUID echoed from input.
regionstringNo—AWS API endpoint region used.
servicestringNo—AWS boto3 service/client name.
operationstringNo—AWS API operation invoked.
request_idstringNo—AWS request ID when available.
responsejsonNo—Sanitized provider response object.
itemslistNo—Primary response item list when the API returns a collection.
result_countintegerNo—Count of primary response items.
next_page_tokenstringNo—Pagination token for the next page.
failure_reasonstringNo—Human-readable failure reason.
failed_stepstringNo—Failed logical step.
failed_layerjsonNo—Failed DAG layer if engine supplies one.
failed_at_statestringNo—State where failure occurred.
errorstringNo—Error message.
error_typestringNo—Error class.
failed_atstringNo—ISO failure timestamp.

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "aws.dynamodb.update_table",
  "initial_data": {
    "organization_uuid": "value",
    "connection_uuid": "value",
    "table_name": "value"
  }
}