class AppSyncDynamoDbDataSource (construct)

Language	Type name
.NET	Amazon.CDK.AWS.AppSync.AppSyncDynamoDbDataSource
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsappsync#AppSyncDynamoDbDataSource
Java	software.amazon.awscdk.services.appsync.AppSyncDynamoDbDataSource
Python	aws_cdk.aws_appsync.AppSyncDynamoDbDataSource
TypeScript (source)	aws-cdk-lib » aws_appsync » AppSyncDynamoDbDataSource

Implements IConstruct, IDependable, IGrantable

An AppSync datasource backed by a DynamoDB table.

Example

const api = new appsync.EventApi(this, 'EventApiDynamoDB', {
  apiName: 'DynamoDBEventApi',
});

const table = new dynamodb.Table(this, 'table', {
  tableName: 'event-messages',
  partitionKey: {
    name: 'id',
    type: dynamodb.AttributeType.STRING,
  },
});

const dataSource = api.addDynamoDbDataSource('ddbsource', table);

Initializer

new AppSyncDynamoDbDataSource(scope: Construct, id: string, props: AppSyncDynamoDbDataSourceProps)

Parameters

• scope Construct
• id string
• props AppSyncDynamoDbDataSourceProps

Construct Props

Name	Type	Description
api	IApi	The API to attach this data source to.
table	ITable	The DynamoDB table backing this data source.
description?	string	The description of the data source.
name?	string	The name of the data source.
readOnlyAccess?	boolean	Specify whether this Data Source is read only or has read and write permissions to the DynamoDB table.
serviceRole?	IRole	The IAM service role to be assumed by AppSync to interact with the data source.
useCallerCredentials?	boolean	Use credentials of caller to access DynamoDB.

---

api

Type: IApi

The API to attach this data source to.

---

table

Type: ITable

The DynamoDB table backing this data source.

---

description?

Type: string (optional, default: None)

The description of the data source.

---

name?

Type: string (optional, default: id of data source)

The name of the data source.

The only allowed pattern is: {[_A-Za-z][_0-9A-Za-z]*}. Any invalid characters will be automatically removed.

---

readOnlyAccess?

Type: boolean (optional, default: false)

Specify whether this Data Source is read only or has read and write permissions to the DynamoDB table.

---

serviceRole?

Type: IRole (optional, default: Create a new role)

The IAM service role to be assumed by AppSync to interact with the data source.

---

useCallerCredentials?

Type: boolean (optional, default: false)

Use credentials of caller to access DynamoDB.

Properties

Name	Type	Description
grantPrincipal	IPrincipal	The principal of the data source to be IGrantable.
name	string	The name of the data source.
node	Node	The tree node.
resource	CfnDataSource	The underlying CFN data source resource.

---

grantPrincipal

Type: IPrincipal

The principal of the data source to be IGrantable.

---

name

Type: string

The name of the data source.

---

node

Type: Node

The tree node.

---

resource

Type: CfnDataSource

The underlying CFN data source resource.

Methods

Name	Description
toString()	Returns a string representation of this construct.

---

toString()

public toString(): string

Returns

• string

Returns a string representation of this construct.