- Navigation GuideYou are on a Client landing page. Commands (operations) are listed on this page. The Client constructor type is linked at the bottom.
AppSyncClient
AppSync provides API actions for creating and interacting with data sources using GraphQL from your application.
Installation
npm install @aws-sdk/client-appsync
yarn add @aws-sdk/client-appsync
pnpm add @aws-sdk/client-appsync
AppSyncClient Operations
Command | Summary |
---|
Command | Summary |
---|---|
AssociateApiCommand | Maps an endpoint to your custom domain. |
AssociateMergedGraphqlApiCommand | Creates an association between a Merged API and source API using the source API's identifier. |
AssociateSourceGraphqlApiCommand | Creates an association between a Merged API and source API using the Merged API's identifier. |
CreateApiCacheCommand | Creates a cache for the GraphQL API. |
CreateApiCommand | Creates an |
CreateApiKeyCommand | Creates a unique key that you can distribute to clients who invoke your API. |
CreateChannelNamespaceCommand | Creates a |
CreateDataSourceCommand | Creates a |
CreateDomainNameCommand | Creates a custom |
CreateFunctionCommand | Creates a A function is a reusable entity. You can use multiple functions to compose the resolver logic. |
CreateGraphqlApiCommand | Creates a |
CreateResolverCommand | Creates a A resolver converts incoming requests into a format that a data source can understand, and converts the data source's responses into GraphQL. |
CreateTypeCommand | Creates a |
DeleteApiCacheCommand | Deletes an |
DeleteApiCommand | Deletes an |
DeleteApiKeyCommand | Deletes an API key. |
DeleteChannelNamespaceCommand | Deletes a |
DeleteDataSourceCommand | Deletes a |
DeleteDomainNameCommand | Deletes a custom |
DeleteFunctionCommand | Deletes a |
DeleteGraphqlApiCommand | Deletes a |
DeleteResolverCommand | Deletes a |
DeleteTypeCommand | Deletes a |
DisassociateApiCommand | Removes an |
DisassociateMergedGraphqlApiCommand | Deletes an association between a Merged API and source API using the source API's identifier and the association ID. |
DisassociateSourceGraphqlApiCommand | Deletes an association between a Merged API and source API using the Merged API's identifier and the association ID. |
EvaluateCodeCommand | Evaluates the given code and returns the response. The code definition requirements depend on the specified runtime. For |
EvaluateMappingTemplateCommand | Evaluates a given template and returns the response. The mapping template can be a request or response template. Request templates take the incoming request after a GraphQL operation is parsed and convert it into a request configuration for the selected data source operation. Response templates interpret responses from the data source and map it to the shape of the GraphQL field output type. Mapping templates are written in the Apache Velocity Template Language (VTL). |
FlushApiCacheCommand | Flushes an |
GetApiAssociationCommand | Retrieves an |
GetApiCacheCommand | Retrieves an |
GetApiCommand | Retrieves an |
GetChannelNamespaceCommand | Retrieves the channel namespace for a specified |
GetDataSourceCommand | Retrieves a |
GetDataSourceIntrospectionCommand | Retrieves the record of an existing introspection. If the retrieval is successful, the result of the instrospection will also be returned. If the retrieval fails the operation, an error message will be returned instead. |
GetDomainNameCommand | Retrieves a custom |
GetFunctionCommand | Get a |
GetGraphqlApiCommand | Retrieves a |
GetGraphqlApiEnvironmentVariablesCommand | Retrieves the list of environmental variable key-value pairs associated with an API by its ID value. |
GetIntrospectionSchemaCommand | Retrieves the introspection schema for a GraphQL API. |
GetResolverCommand | Retrieves a |
GetSchemaCreationStatusCommand | Retrieves the current status of a schema creation operation. |
GetSourceApiAssociationCommand | Retrieves a |
GetTypeCommand | Retrieves a |
ListApiKeysCommand | Lists the API keys for a given API. API keys are deleted automatically 60 days after they expire. However, they may still be included in the response until they have actually been deleted. You can safely call |
ListApisCommand | Lists the APIs in your AppSync account. |
ListChannelNamespacesCommand | Lists the channel namespaces for a specified |
ListDataSourcesCommand | Lists the data sources for a given API. |
ListDomainNamesCommand | Lists multiple custom domain names. |
ListFunctionsCommand | List multiple functions. |
ListGraphqlApisCommand | Lists your GraphQL APIs. |
ListResolversByFunctionCommand | List the resolvers that are associated with a specific function. |
ListResolversCommand | Lists the resolvers for a given API and type. |
ListSourceApiAssociationsCommand | Lists the |
ListTagsForResourceCommand | Lists the tags for a resource. |
ListTypesByAssociationCommand | Lists |
ListTypesCommand | Lists the types for a given API. |
PutGraphqlApiEnvironmentVariablesCommand | Creates a list of environmental variables in an API by its ID value. When creating an environmental variable, it must follow the constraints below:
When creating an environmental variable key-value pair, it must follow the additional constraints below:
You can create a list of environmental variables by adding it to the |
StartDataSourceIntrospectionCommand | Creates a new introspection. Returns the |
StartSchemaCreationCommand | Adds a new schema to your GraphQL API. This operation is asynchronous. Use to determine when it has completed. |
StartSchemaMergeCommand | Initiates a merge operation. Returns a status that shows the result of the merge operation. |
TagResourceCommand | Tags a resource with user-supplied tags. |
UntagResourceCommand | Untags a resource. |
UpdateApiCacheCommand | Updates the cache for the GraphQL API. |
UpdateApiCommand | Updates an |
UpdateApiKeyCommand | Updates an API key. You can update the key as long as it's not deleted. |
UpdateChannelNamespaceCommand | Updates a |
UpdateDataSourceCommand | Updates a |
UpdateDomainNameCommand | Updates a custom |
UpdateFunctionCommand | Updates a |
UpdateGraphqlApiCommand | Updates a |
UpdateResolverCommand | Updates a |
UpdateSourceApiAssociationCommand | Updates some of the configuration choices of a particular source API association. |
UpdateTypeCommand | Updates a |
AppSyncClient Configuration
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
defaultsMode Optional | DefaultsMode | Provider<DefaultsMode> | The @smithy/smithy-client#DefaultsMode that will be used to determine how certain default configuration options are resolved in the SDK. |
disableHostPrefix Optional | boolean | Disable dynamically changing the endpoint of the client based on the hostPrefix trait of an operation. |
extensions Optional | RuntimeExtension[] | Optional extensions |
logger Optional | Logger | Optional logger for logging debug/info/warn/error. |
maxAttempts Optional | number | Provider<number> | Value for how many times a request will be made at most in case of retry. |
profile Optional | string | Setting a client profile is similar to setting a value for the AWS_PROFILE environment variable. Setting a profile on a client in code only affects the single client instance, unlike AWS_PROFILE.When set, and only for environments where an AWS configuration file exists, fields configurable by this file will be retrieved from the specified profile within that file. Conflicting code configuration and environment variables will still have higher priority.For client credential resolution that involves checking the AWS configuration file, the client's profile (this value) will be used unless a different profile is set in the credential provider options. |
region Optional | string | Provider<string> | The AWS region to which this client will send requests |
requestHandler Optional | __HttpHandlerUserInput | The HTTP handler to use or its constructor options. Fetch in browser and Https in Nodejs. |
retryMode Optional | string | Provider<string> | Specifies which retry algorithm to use. |
useDualstackEndpoint Optional | boolean | Provider<boolean> | Enables IPv6/IPv4 dualstack endpoint. |
useFipsEndpoint Optional | boolean | Provider<boolean> | Enables FIPS compatible endpoints. |
Additional config fields are described in the full configuration type: AppSyncClientConfig