DataSources

All the DataSources in your AppSync API can be found in serverless.yml under the appSync.dataSources property. DataSources are defined as key-value objects, the key being the name of the DataSource.

DynamoDB

Quick start

appSync:
  dataSources:
    myTableDs:
      type: AMAZON_DYNAMODB
      description: 'My table'
      config:
        tableName: my-table

config

tableName: the name of the DynamoDB table
region: the region of the table. Defaults to the stack's region
useCallerCredentials: Set to true to use AWS Identity and Access Management with this data source
serviceRoleArn: The service role ARN for this DataSource. If not provided, a new one will be created.
iamRoleStatements: Statements to use for the generated IAM Role. If not provided, default statements will be used.
versioned: Set to true to use Conflict Detection and Resolution with this data source.
deltaSyncConfig:
- deltaSyncTableName: The Delta Sync table name.
- baseTableTTL: The number of minutes that an Item is stored in the data source. Defaults to 43200
- deltaSyncTableTTL: The number of minutes that a Delta Sync log entry is stored in the Delta Sync table. Defaults to 1440

AWS Lambda

Quick start

appSync:
  dataSources:
    myFunction:
      type: 'AWS_LAMBDA'
      config:
        function:
          timeout: 30
          handler: 'functions/myFunction.handler'

config

serviceRoleArn: The service role ARN for this DataSource. If not provided, a new one will be created.
iamRoleStatements: Statements to use for the generated IAM Role. If not provided, default statements will be used.
function: A Lambda function definition as you would define it under the functions section of your serverless.yml file.
functionName: The name of the function as defined under the functions section of the serverless.yml file
functionAlias: A specific function alias to use
functionArn: The function ARN to use for this DataSource.

OpenSearch (ElasticSearch)

Quick start

appSync:
  dataSources:
    search:
      type: 'AMAZON_OPENSEARCH_SERVICE'
      config:
        endpoint: https://abcdefgh.us-east-1.es.amazonaws.com

config

endpoint: The endpoint url to the OpenSearch domain
region: The region of the OpenSearch domain. Defaults to the stack's region.
serviceRoleArn: The service role ARN for this DataSource. If not provided, a new one will be created.
iamRoleStatements: Statements to use for the generated IAM Role. If not provided, default statements will be used.

HTTP

Quick start

appSync:
  dataSources:
    api:
      type: 'HTTP'
      config:
        endpoint: https://api.example.com

config

endpoint: The url of the HTTP endpoint.
serviceRoleArn: The service role ARN for this DataSource. If not provided, a new one will be created.
iamRoleStatements: Statements to use for the generated IAM Role. If not provided, default statements will be used.
authorizationConfig:
- authorizationType: The authorization type that the HTTP endpoint requires.
  - AWS_IAM: The authorization type is Signature Version 4 (SigV4).
- awsIamConfig:
  - signingRegion: The signing Region for AWS Identity and Access Management authorization. Defaults to the region of the stack.
  - signingServiceName: The signing service name for AWS Identity and Access Management authorization.

Relational Database

Quick start

appSync:
  dataSources:
    myDatabase:
      type: 'RELATIONAL_DATABASE'
      config:
        databaseName: myDatabase
        dbClusterIdentifier: Ref: RDSCluster
        awsSecretStoreArn: Ref: RDSClusterSecret
        serviceRoleArn: !GetAtt RelationalDbServiceRole.Arn

config

databaseName: The name of the database
region: The region of the RDS HTTP endpoint. Defaults to the region of the stack.
awsSecretStoreArn: The ARN for database credentials stored in AWS Secrets Manager.
dbClusterIdentifier: Amazon RDS cluster Amazon Resource Name (ARN).
schema: Logical schema name.
serviceRoleArn: The service role ARN for this DataSource. If not provided, a new one will be created.
iamRoleStatements: Statements to use for the generated IAM Role. If not provided, default statements will be used.

EventBridge

appSync:
  dataSources:
    myEventBus:
      type: 'AMAZON_EVENTBRIDGE'
      config:
        eventBusArn: !GetAtt MyEventBus.Arn

config

eventBusArn: The ARN of the event bus

NONE

appSync:
  dataSources:
    api:
      type: 'NONE'

Organize your data sources

You can define your data sources into several files for organizational reasons. You can pass each file into the dataSources attribute as an array.

dataSources:
  - ${file(appsync/dataSources/users.yml)}
  - ${file(appsync/dataSources/posts.yml)}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!