class HttpDataSource (construct)

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

Implements IConstruct, IDependable, IGrantable

An AppSync datasource backed by a http endpoint.

Example

const api = new appsync.GraphqlApi(this, 'api', {
  name: 'api',
  definition: appsync.Definition.fromFile(path.join(__dirname, 'schema.graphql')),
});

const httpDs = api.addHttpDataSource(
  'ds',
  'https://states.amazonaws.com',
  {
    name: 'httpDsWithStepF',
    description: 'from appsync to StepFunctions Workflow',
    authorizationConfig: {
      signingRegion: 'us-east-1',
      signingServiceName: 'states',
    },
  },
);

httpDs.createResolver('MutationCallStepFunctionResolver', {
  typeName: 'Mutation',
  fieldName: 'callStepFunction',
  requestMappingTemplate: appsync.MappingTemplate.fromFile('request.vtl'),
  responseMappingTemplate: appsync.MappingTemplate.fromFile('response.vtl'),
});

Initializer

new HttpDataSource(scope: Construct, id: string, props: HttpDataSourceProps)

Parameters

• scope Construct
• id string
• props HttpDataSourceProps

Construct Props

Name	Type	Description
api	IGraphqlApi	The API to attach this data source to.
endpoint	string	The http endpoint.
authorizationConfig?	AwsIamConfig	The authorization config in case the HTTP endpoint requires authorization.
description?	string	the description of the data source.
name?	string	The name of the data source.
serviceRole?	IRole	The IAM service role to be assumed by AppSync to interact with the data source.

---

api

Type: IGraphqlApi

The API to attach this data source to.

---

endpoint

Type: string

The http endpoint.

---

authorizationConfig?

Type: AwsIamConfig (optional, default: none)

The authorization config in case the HTTP endpoint requires authorization.

---

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.

---

serviceRole?

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

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

Properties

Name	Type	Description
ds	CfnDataSource	the underlying CFN data source resource.
grantPrincipal	IPrincipal	the principal of the data source to be IGrantable.
name	string	the name of the data source.
node	Node	The tree node.
static PROPERTY_INJECTION_ID	string	Uniquely identifies this class.

---

ds

Type: 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.

---

static PROPERTY_INJECTION_ID

Type: string

Uniquely identifies this class.

Methods

Name	Description
createFunction(id, props)	creates a new appsync function for this datasource and API using the given properties.
createResolver(id, props)	creates a new resolver for this datasource and API using the given properties.
toString()	Returns a string representation of this construct.

---

createFunction(id, props)

public createFunction(id: string, props: BaseAppsyncFunctionProps): AppsyncFunction

Parameters

• id string
• props BaseAppsyncFunctionProps

Returns

• AppsyncFunction

creates a new appsync function for this datasource and API using the given properties.

---

createResolver(id, props)

public createResolver(id: string, props: BaseResolverProps): Resolver

Parameters

• id string
• props BaseResolverProps

Returns

• Resolver

creates a new resolver for this datasource and API using the given properties.

---

toString()

public toString(): string

Returns

• string

Returns a string representation of this construct.