Package software.amazon.awscdk.services.appsync

Class GraphqlApiBase

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.Resource
software.amazon.awscdk.services.appsync.GraphqlApiBase
All Implemented Interfaces:
IEnvironmentAware, IResource, IGraphqlApi, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
Direct Known Subclasses:
GraphqlApi
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-12-01T16:02:14.494Z") @Stability(Stable) public abstract class GraphqlApiBase extends Resource implements IGraphqlApi
Base Class for GraphQL API.

  • Constructor Details

    • GraphqlApiBase

      protected GraphqlApiBase(software.amazon.jsii.JsiiObjectRef objRef)

    • GraphqlApiBase

      protected GraphqlApiBase(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • GraphqlApiBase

      @Stability(Stable) protected GraphqlApiBase(@NotNull software.constructs.Construct scope, @NotNull String id, @Nullable ResourceProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props -

    • GraphqlApiBase

      @Stability(Stable) protected GraphqlApiBase(@NotNull software.constructs.Construct scope, @NotNull String id)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.

  • Method Details

    • addDynamoDbDataSource

      @Stability(Stable) @NotNull public DynamoDbDataSource addDynamoDbDataSource(@NotNull String id, @NotNull ITable table, @Nullable DataSourceOptions options)
      add a new DynamoDB data source to this API.

      Specified by:
      addDynamoDbDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      table - The DynamoDB table backing this data source. This parameter is required.
      options - The optional configuration for this data source.

    • addDynamoDbDataSource

      @Stability(Stable) @NotNull public DynamoDbDataSource addDynamoDbDataSource(@NotNull String id, @NotNull ITable table)
      add a new DynamoDB data source to this API.

      Specified by:
      addDynamoDbDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      table - The DynamoDB table backing this data source. This parameter is required.

    • addElasticsearchDataSource

      @Stability(Deprecated) @Deprecated @NotNull public ElasticsearchDataSource addElasticsearchDataSource(@NotNull String id, @NotNull IDomain domain, @Nullable DataSourceOptions options)
      Deprecated.
      • use addOpenSearchDataSource
      (deprecated) add a new elasticsearch data source to this API.

      Specified by:
      addElasticsearchDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      domain - The elasticsearch domain for this data source. This parameter is required.
      options - The optional configuration for this data source.

    • addElasticsearchDataSource

      @Stability(Deprecated) @Deprecated @NotNull public ElasticsearchDataSource addElasticsearchDataSource(@NotNull String id, @NotNull IDomain domain)
      Deprecated.
      • use addOpenSearchDataSource
      (deprecated) add a new elasticsearch data source to this API.

      Specified by:
      addElasticsearchDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      domain - The elasticsearch domain for this data source. This parameter is required.

    • addEventBridgeDataSource

      @Stability(Stable) @NotNull public EventBridgeDataSource addEventBridgeDataSource(@NotNull String id, @NotNull IEventBus eventBus, @Nullable DataSourceOptions options)
      Add an EventBridge data source to this api.

      Specified by:
      addEventBridgeDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      eventBus - The EventBridge EventBus on which to put events. This parameter is required.
      options - The optional configuration for this data source.

    • addEventBridgeDataSource

      @Stability(Stable) @NotNull public EventBridgeDataSource addEventBridgeDataSource(@NotNull String id, @NotNull IEventBus eventBus)
      Add an EventBridge data source to this api.

      Specified by:
      addEventBridgeDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      eventBus - The EventBridge EventBus on which to put events. This parameter is required.

    • addHttpDataSource

      @Stability(Stable) @NotNull public HttpDataSource addHttpDataSource(@NotNull String id, @NotNull String endpoint, @Nullable HttpDataSourceOptions options)
      add a new http data source to this API.

      Specified by:
      addHttpDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      endpoint - The http endpoint. This parameter is required.
      options - The optional configuration for this data source.

    • addHttpDataSource

      @Stability(Stable) @NotNull public HttpDataSource addHttpDataSource(@NotNull String id, @NotNull String endpoint)
      add a new http data source to this API.

      Specified by:
      addHttpDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      endpoint - The http endpoint. This parameter is required.

    • addLambdaDataSource

      @Stability(Stable) @NotNull public LambdaDataSource addLambdaDataSource(@NotNull String id, @NotNull IFunction lambdaFunction, @Nullable DataSourceOptions options)
      add a new Lambda data source to this API.

      Specified by:
      addLambdaDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      lambdaFunction - The Lambda function to call to interact with this data source. This parameter is required.
      options - The optional configuration for this data source.

    • addLambdaDataSource

      @Stability(Stable) @NotNull public LambdaDataSource addLambdaDataSource(@NotNull String id, @NotNull IFunction lambdaFunction)
      add a new Lambda data source to this API.

      Specified by:
      addLambdaDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      lambdaFunction - The Lambda function to call to interact with this data source. This parameter is required.

    • addNoneDataSource

      @Stability(Stable) @NotNull public NoneDataSource addNoneDataSource(@NotNull String id, @Nullable DataSourceOptions options)
      add a new dummy data source to this API.

      Useful for pipeline resolvers and for backend changes that don't require a data source.

      Specified by:
      addNoneDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      options - The optional configuration for this data source.

    • addNoneDataSource

      @Stability(Stable) @NotNull public NoneDataSource addNoneDataSource(@NotNull String id)
      add a new dummy data source to this API.

      Useful for pipeline resolvers and for backend changes that don't require a data source.

      Specified by:
      addNoneDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.

    • addOpenSearchDataSource

      @Stability(Stable) @NotNull public OpenSearchDataSource addOpenSearchDataSource(@NotNull String id, @NotNull IDomain domain, @Nullable DataSourceOptions options)
      add a new OpenSearch data source to this API.

      Specified by:
      addOpenSearchDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      domain - The OpenSearch domain for this data source. This parameter is required.
      options - The optional configuration for this data source.

    • addOpenSearchDataSource

      @Stability(Stable) @NotNull public OpenSearchDataSource addOpenSearchDataSource(@NotNull String id, @NotNull IDomain domain)
      add a new OpenSearch data source to this API.

      Specified by:
      addOpenSearchDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      domain - The OpenSearch domain for this data source. This parameter is required.

    • addRdsDataSource

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSource(@NotNull String id, @NotNull IServerlessCluster serverlessCluster, @NotNull ISecret secretStore, @Nullable String databaseName, @Nullable DataSourceOptions options)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.
      databaseName - The optional name of the database to use within the cluster.
      options - The optional configuration for this data source.

    • addRdsDataSource

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSource(@NotNull String id, @NotNull IServerlessCluster serverlessCluster, @NotNull ISecret secretStore, @Nullable String databaseName)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.
      databaseName - The optional name of the database to use within the cluster.

    • addRdsDataSource

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSource(@NotNull String id, @NotNull IServerlessCluster serverlessCluster, @NotNull ISecret secretStore)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSource in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.

    • addRdsDataSourceV2

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSourceV2(@NotNull String id, @NotNull IDatabaseCluster serverlessCluster, @NotNull ISecret secretStore, @Nullable String databaseName, @Nullable DataSourceOptions options)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSourceV2 in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless V2 cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.
      databaseName - The optional name of the database to use within the cluster.
      options - The optional configuration for this data source.

    • addRdsDataSourceV2

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSourceV2(@NotNull String id, @NotNull IDatabaseCluster serverlessCluster, @NotNull ISecret secretStore, @Nullable String databaseName)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSourceV2 in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless V2 cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.
      databaseName - The optional name of the database to use within the cluster.

    • addRdsDataSourceV2

      @Stability(Stable) @NotNull public RdsDataSource addRdsDataSourceV2(@NotNull String id, @NotNull IDatabaseCluster serverlessCluster, @NotNull ISecret secretStore)
      add a new Rds data source to this API.

      Specified by:
      addRdsDataSourceV2 in interface IGraphqlApi
      Parameters:
      id - The data source's id. This parameter is required.
      serverlessCluster - The serverless V2 cluster to interact with this data source. This parameter is required.
      secretStore - The secret store that contains the username and password for the serverless cluster. This parameter is required.

    • addSchemaDependency

      @Stability(Stable) @NotNull public Boolean addSchemaDependency(@NotNull CfnResource construct)
      Add schema dependency if not imported.

      Specified by:
      addSchemaDependency in interface IGraphqlApi
      Parameters:
      construct - the dependee. This parameter is required.

    • createResolver

      @Stability(Stable) @NotNull public Resolver createResolver(@NotNull String id, @NotNull ExtendedResolverProps props)
      creates a new resolver for this datasource and API using the given properties.

      Specified by:
      createResolver in interface IGraphqlApi
      Parameters:
      id - This parameter is required.
      props - This parameter is required.

    • grant

      @Stability(Stable) @NotNull public Grant grant(@NotNull IGrantable grantee, @NotNull IamResource resources, @NotNull String... actions)
      Adds an IAM policy statement associated with this GraphQLApi to an IAM principal's policy.

      Specified by:
      grant in interface IGraphqlApi
      Parameters:
      grantee - The principal. This parameter is required.
      resources - The set of resources to allow (i.e. ...:[region]:[accountId]:apis/GraphQLId/...). This parameter is required.
      actions - The actions that should be granted to the principal (i.e. appsync:graphql ). This parameter is required.

    • grantMutation

      @Stability(Stable) @NotNull public Grant grantMutation(@NotNull IGrantable grantee, @NotNull String... fields)
      Adds an IAM policy statement for Mutation access to this GraphQLApi to an IAM principal's policy.

      Specified by:
      grantMutation in interface IGraphqlApi
      Parameters:
      grantee - The principal. This parameter is required.
      fields - The fields to grant access to that are Mutations (leave blank for all). This parameter is required.

    • grantQuery

      @Stability(Stable) @NotNull public Grant grantQuery(@NotNull IGrantable grantee, @NotNull String... fields)
      Adds an IAM policy statement for Query access to this GraphQLApi to an IAM principal's policy.

      Specified by:
      grantQuery in interface IGraphqlApi
      Parameters:
      grantee - The principal. This parameter is required.
      fields - The fields to grant access to that are Queries (leave blank for all). This parameter is required.

    • grantSubscription

      @Stability(Stable) @NotNull public Grant grantSubscription(@NotNull IGrantable grantee, @NotNull String... fields)
      Adds an IAM policy statement for Subscription access to this GraphQLApi to an IAM principal's policy.

      Specified by:
      grantSubscription in interface IGraphqlApi
      Parameters:
      grantee - The principal. This parameter is required.
      fields - The fields to grant access to that are Subscriptions (leave blank for all). This parameter is required.

    • getApiId

      @Stability(Stable) @NotNull public abstract String getApiId()
      an unique AWS AppSync GraphQL API identifier i.e. 'lxz775lwdrgcndgz3nurvac7oa'.
      Specified by:
      getApiId in interface IGraphqlApi

    • getArn

      @Stability(Stable) @NotNull public abstract String getArn()
      the ARN of the API.
      Specified by:
      getArn in interface IGraphqlApi

    • getGraphQLEndpointArn

      @Stability(Stable) @NotNull public abstract String getGraphQLEndpointArn()
      The GraphQL endpoint ARN.
      Specified by:
      getGraphQLEndpointArn in interface IGraphqlApi

    • getModes

      @Stability(Stable) @NotNull public abstract List<AuthorizationType> getModes()
      The Authorization Types for this GraphQL Api.
      Specified by:
      getModes in interface IGraphqlApi

    • getVisibility

      @Stability(Stable) @NotNull public abstract Visibility getVisibility()
      The visibility of the API.
      Specified by:
      getVisibility in interface IGraphqlApi