EnableKinesisStreamingDestination
Starts table data replication to the specified Kinesis data stream at a timestamp chosen during the enable workflow. If this operation doesn't return results immediately, use DescribeKinesisStreamingDestination to check if streaming to the Kinesis data stream is ACTIVE.
Request Syntax
{
"StreamArn": "string
",
"TableName": "string
"
}
Request Parameters
The request accepts the following data in JSON format.
In the following list, the required parameters are described first.
Response Syntax
{
"DestinationStatus": "string",
"StreamArn": "string",
"TableName": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- DestinationStatus
-
The current status of the replication.
Type: String
Valid Values:
ENABLING | ACTIVE | DISABLING | DISABLED | ENABLE_FAILED
- StreamArn
-
The ARN for the specific Kinesis data stream.
Type: String
Length Constraints: Minimum length of 37. Maximum length of 1024.
- TableName
-
The name of the table being modified.
Type: String
Length Constraints: Minimum length of 3. Maximum length of 255.
Pattern:
[a-zA-Z0-9_.-]+
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerError
-
An error occurred on the server side.
HTTP Status Code: 500
- LimitExceededException
-
There is no limit to the number of daily on-demand backups that can be taken.
Up to 50 simultaneous table operations are allowed per account. These operations include
CreateTable
,UpdateTable
,DeleteTable
,UpdateTimeToLive
,RestoreTableFromBackup
, andRestoreTableToPointInTime
.The only exception is when you are creating a table with one or more secondary indexes. You can have up to 25 such requests running at a time; however, if the table or index specifications are complex, DynamoDB might temporarily reduce the number of concurrent operations.
There is a soft account quota of 256 tables.
HTTP Status Code: 400
- ResourceInUseException
-
The operation conflicts with the resource's availability. For example, you attempted to recreate an existing table, or tried to delete a table currently in the
CREATING
state.HTTP Status Code: 400
- ResourceNotFoundException
-
The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be
ACTIVE
.HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: