@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSAppSync
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSAppSync
instead.
AppSync provides API actions for creating and interacting with data sources using GraphQL from your application.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AssociateApiResult |
associateApi(AssociateApiRequest associateApiRequest)
Maps an endpoint to your custom domain.
|
AssociateMergedGraphqlApiResult |
associateMergedGraphqlApi(AssociateMergedGraphqlApiRequest associateMergedGraphqlApiRequest)
Creates an association between a Merged API and source API using the source API's identifier.
|
AssociateSourceGraphqlApiResult |
associateSourceGraphqlApi(AssociateSourceGraphqlApiRequest associateSourceGraphqlApiRequest)
Creates an association between a Merged API and source API using the Merged API's identifier.
|
CreateApiCacheResult |
createApiCache(CreateApiCacheRequest createApiCacheRequest)
Creates a cache for the GraphQL API.
|
CreateApiKeyResult |
createApiKey(CreateApiKeyRequest createApiKeyRequest)
Creates a unique key that you can distribute to clients who invoke your API.
|
CreateDataSourceResult |
createDataSource(CreateDataSourceRequest createDataSourceRequest)
Creates a
DataSource object. |
CreateDomainNameResult |
createDomainName(CreateDomainNameRequest createDomainNameRequest)
Creates a custom
DomainName object. |
CreateFunctionResult |
createFunction(CreateFunctionRequest createFunctionRequest)
Creates a
Function object. |
CreateGraphqlApiResult |
createGraphqlApi(CreateGraphqlApiRequest createGraphqlApiRequest)
Creates a
GraphqlApi object. |
CreateResolverResult |
createResolver(CreateResolverRequest createResolverRequest)
Creates a
Resolver object. |
CreateTypeResult |
createType(CreateTypeRequest createTypeRequest)
Creates a
Type object. |
DeleteApiCacheResult |
deleteApiCache(DeleteApiCacheRequest deleteApiCacheRequest)
Deletes an
ApiCache object. |
DeleteApiKeyResult |
deleteApiKey(DeleteApiKeyRequest deleteApiKeyRequest)
Deletes an API key.
|
DeleteDataSourceResult |
deleteDataSource(DeleteDataSourceRequest deleteDataSourceRequest)
Deletes a
DataSource object. |
DeleteDomainNameResult |
deleteDomainName(DeleteDomainNameRequest deleteDomainNameRequest)
Deletes a custom
DomainName object. |
DeleteFunctionResult |
deleteFunction(DeleteFunctionRequest deleteFunctionRequest)
Deletes a
Function . |
DeleteGraphqlApiResult |
deleteGraphqlApi(DeleteGraphqlApiRequest deleteGraphqlApiRequest)
Deletes a
GraphqlApi object. |
DeleteResolverResult |
deleteResolver(DeleteResolverRequest deleteResolverRequest)
Deletes a
Resolver object. |
DeleteTypeResult |
deleteType(DeleteTypeRequest deleteTypeRequest)
Deletes a
Type object. |
DisassociateApiResult |
disassociateApi(DisassociateApiRequest disassociateApiRequest)
Removes an
ApiAssociation object from a custom domain. |
DisassociateMergedGraphqlApiResult |
disassociateMergedGraphqlApi(DisassociateMergedGraphqlApiRequest disassociateMergedGraphqlApiRequest)
Deletes an association between a Merged API and source API using the source API's identifier and the association
ID.
|
DisassociateSourceGraphqlApiResult |
disassociateSourceGraphqlApi(DisassociateSourceGraphqlApiRequest disassociateSourceGraphqlApiRequest)
Deletes an association between a Merged API and source API using the Merged API's identifier and the association
ID.
|
EvaluateCodeResult |
evaluateCode(EvaluateCodeRequest evaluateCodeRequest)
Evaluates the given code and returns the response.
|
EvaluateMappingTemplateResult |
evaluateMappingTemplate(EvaluateMappingTemplateRequest evaluateMappingTemplateRequest)
Evaluates a given template and returns the response.
|
FlushApiCacheResult |
flushApiCache(FlushApiCacheRequest flushApiCacheRequest)
Flushes an
ApiCache object. |
GetApiAssociationResult |
getApiAssociation(GetApiAssociationRequest getApiAssociationRequest)
Retrieves an
ApiAssociation object. |
GetApiCacheResult |
getApiCache(GetApiCacheRequest getApiCacheRequest)
Retrieves an
ApiCache object. |
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetDataSourceResult |
getDataSource(GetDataSourceRequest getDataSourceRequest)
Retrieves a
DataSource object. |
GetDataSourceIntrospectionResult |
getDataSourceIntrospection(GetDataSourceIntrospectionRequest getDataSourceIntrospectionRequest)
Retrieves the record of an existing introspection.
|
GetDomainNameResult |
getDomainName(GetDomainNameRequest getDomainNameRequest)
Retrieves a custom
DomainName object. |
GetFunctionResult |
getFunction(GetFunctionRequest getFunctionRequest)
Get a
Function . |
GetGraphqlApiResult |
getGraphqlApi(GetGraphqlApiRequest getGraphqlApiRequest)
Retrieves a
GraphqlApi object. |
GetGraphqlApiEnvironmentVariablesResult |
getGraphqlApiEnvironmentVariables(GetGraphqlApiEnvironmentVariablesRequest getGraphqlApiEnvironmentVariablesRequest)
Retrieves the list of environmental variable key-value pairs associated with an API by its ID value.
|
GetIntrospectionSchemaResult |
getIntrospectionSchema(GetIntrospectionSchemaRequest getIntrospectionSchemaRequest)
Retrieves the introspection schema for a GraphQL API.
|
GetResolverResult |
getResolver(GetResolverRequest getResolverRequest)
Retrieves a
Resolver object. |
GetSchemaCreationStatusResult |
getSchemaCreationStatus(GetSchemaCreationStatusRequest getSchemaCreationStatusRequest)
Retrieves the current status of a schema creation operation.
|
GetSourceApiAssociationResult |
getSourceApiAssociation(GetSourceApiAssociationRequest getSourceApiAssociationRequest)
Retrieves a
SourceApiAssociation object. |
GetTypeResult |
getType(GetTypeRequest getTypeRequest)
Retrieves a
Type object. |
ListApiKeysResult |
listApiKeys(ListApiKeysRequest listApiKeysRequest)
Lists the API keys for a given API.
|
ListDataSourcesResult |
listDataSources(ListDataSourcesRequest listDataSourcesRequest)
Lists the data sources for a given API.
|
ListDomainNamesResult |
listDomainNames(ListDomainNamesRequest listDomainNamesRequest)
Lists multiple custom domain names.
|
ListFunctionsResult |
listFunctions(ListFunctionsRequest listFunctionsRequest)
List multiple functions.
|
ListGraphqlApisResult |
listGraphqlApis(ListGraphqlApisRequest listGraphqlApisRequest)
Lists your GraphQL APIs.
|
ListResolversResult |
listResolvers(ListResolversRequest listResolversRequest)
Lists the resolvers for a given API and type.
|
ListResolversByFunctionResult |
listResolversByFunction(ListResolversByFunctionRequest listResolversByFunctionRequest)
List the resolvers that are associated with a specific function.
|
ListSourceApiAssociationsResult |
listSourceApiAssociations(ListSourceApiAssociationsRequest listSourceApiAssociationsRequest)
Lists the
SourceApiAssociationSummary data. |
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags for a resource.
|
ListTypesResult |
listTypes(ListTypesRequest listTypesRequest)
Lists the types for a given API.
|
ListTypesByAssociationResult |
listTypesByAssociation(ListTypesByAssociationRequest listTypesByAssociationRequest)
Lists
Type objects by the source API association ID. |
PutGraphqlApiEnvironmentVariablesResult |
putGraphqlApiEnvironmentVariables(PutGraphqlApiEnvironmentVariablesRequest putGraphqlApiEnvironmentVariablesRequest)
Creates a list of environmental variables in an API by its ID value.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartDataSourceIntrospectionResult |
startDataSourceIntrospection(StartDataSourceIntrospectionRequest startDataSourceIntrospectionRequest)
Creates a new introspection.
|
StartSchemaCreationResult |
startSchemaCreation(StartSchemaCreationRequest startSchemaCreationRequest)
Adds a new schema to your GraphQL API.
|
StartSchemaMergeResult |
startSchemaMerge(StartSchemaMergeRequest startSchemaMergeRequest)
Initiates a merge operation.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Tags a resource with user-supplied tags.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Untags a resource.
|
UpdateApiCacheResult |
updateApiCache(UpdateApiCacheRequest updateApiCacheRequest)
Updates the cache for the GraphQL API.
|
UpdateApiKeyResult |
updateApiKey(UpdateApiKeyRequest updateApiKeyRequest)
Updates an API key.
|
UpdateDataSourceResult |
updateDataSource(UpdateDataSourceRequest updateDataSourceRequest)
Updates a
DataSource object. |
UpdateDomainNameResult |
updateDomainName(UpdateDomainNameRequest updateDomainNameRequest)
Updates a custom
DomainName object. |
UpdateFunctionResult |
updateFunction(UpdateFunctionRequest updateFunctionRequest)
Updates a
Function object. |
UpdateGraphqlApiResult |
updateGraphqlApi(UpdateGraphqlApiRequest updateGraphqlApiRequest)
Updates a
GraphqlApi object. |
UpdateResolverResult |
updateResolver(UpdateResolverRequest updateResolverRequest)
Updates a
Resolver object. |
UpdateSourceApiAssociationResult |
updateSourceApiAssociation(UpdateSourceApiAssociationRequest updateSourceApiAssociationRequest)
Updates some of the configuration choices of a particular source API association.
|
UpdateTypeResult |
updateType(UpdateTypeRequest updateTypeRequest)
Updates a
Type object. |
static final String ENDPOINT_PREFIX
AssociateApiResult associateApi(AssociateApiRequest associateApiRequest)
Maps an endpoint to your custom domain.
associateApiRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.AssociateMergedGraphqlApiResult associateMergedGraphqlApi(AssociateMergedGraphqlApiRequest associateMergedGraphqlApiRequest)
Creates an association between a Merged API and source API using the source API's identifier.
associateMergedGraphqlApiRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.AssociateSourceGraphqlApiResult associateSourceGraphqlApi(AssociateSourceGraphqlApiRequest associateSourceGraphqlApiRequest)
Creates an association between a Merged API and source API using the Merged API's identifier.
associateSourceGraphqlApiRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.CreateApiCacheResult createApiCache(CreateApiCacheRequest createApiCacheRequest)
Creates a cache for the GraphQL API.
createApiCacheRequest
- Represents the input of a CreateApiCache
operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.CreateApiKeyResult createApiKey(CreateApiKeyRequest createApiKeyRequest)
Creates a unique key that you can distribute to clients who invoke your API.
createApiKeyRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.UnauthorizedException
- You aren't authorized to perform this operation.LimitExceededException
- The request exceeded a limit. Try your request again.InternalFailureException
- An internal AppSync error occurred. Try your request again.ApiKeyLimitExceededException
- The API key exceeded a limit. Try your request again.ApiKeyValidityOutOfBoundsException
- The API key expiration must be set to a value between 1 and 365 days from creation (for
CreateApiKey
) or from update (for UpdateApiKey
).CreateDataSourceResult createDataSource(CreateDataSourceRequest createDataSourceRequest)
Creates a DataSource
object.
createDataSourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.CreateDomainNameResult createDomainName(CreateDomainNameRequest createDomainNameRequest)
Creates a custom DomainName
object.
createDomainNameRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.CreateFunctionResult createFunction(CreateFunctionRequest createFunctionRequest)
Creates a Function
object.
A function is a reusable entity. You can use multiple functions to compose the resolver logic.
createFunctionRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.CreateGraphqlApiResult createGraphqlApi(CreateGraphqlApiRequest createGraphqlApiRequest)
Creates a GraphqlApi
object.
createGraphqlApiRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ApiLimitExceededException
- The GraphQL API exceeded a limit. Try your request again.CreateResolverResult createResolver(CreateResolverRequest createResolverRequest)
Creates a Resolver
object.
A resolver converts incoming requests into a format that a data source can understand, and converts the data source's responses into GraphQL.
createResolverRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.CreateTypeResult createType(CreateTypeRequest createTypeRequest)
Creates a Type
object.
createTypeRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.DeleteApiCacheResult deleteApiCache(DeleteApiCacheRequest deleteApiCacheRequest)
Deletes an ApiCache
object.
deleteApiCacheRequest
- Represents the input of a DeleteApiCache
operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.DeleteApiKeyResult deleteApiKey(DeleteApiKeyRequest deleteApiKeyRequest)
Deletes an API key.
deleteApiKeyRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.DeleteDataSourceResult deleteDataSource(DeleteDataSourceRequest deleteDataSourceRequest)
Deletes a DataSource
object.
deleteDataSourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.DeleteDomainNameResult deleteDomainName(DeleteDomainNameRequest deleteDomainNameRequest)
Deletes a custom DomainName
object.
deleteDomainNameRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.DeleteFunctionResult deleteFunction(DeleteFunctionRequest deleteFunctionRequest)
Deletes a Function
.
deleteFunctionRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.DeleteGraphqlApiResult deleteGraphqlApi(DeleteGraphqlApiRequest deleteGraphqlApiRequest)
Deletes a GraphqlApi
object.
deleteGraphqlApiRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.DeleteResolverResult deleteResolver(DeleteResolverRequest deleteResolverRequest)
Deletes a Resolver
object.
deleteResolverRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.DeleteTypeResult deleteType(DeleteTypeRequest deleteTypeRequest)
Deletes a Type
object.
deleteTypeRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.DisassociateApiResult disassociateApi(DisassociateApiRequest disassociateApiRequest)
Removes an ApiAssociation
object from a custom domain.
disassociateApiRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.DisassociateMergedGraphqlApiResult disassociateMergedGraphqlApi(DisassociateMergedGraphqlApiRequest disassociateMergedGraphqlApiRequest)
Deletes an association between a Merged API and source API using the source API's identifier and the association ID.
disassociateMergedGraphqlApiRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.DisassociateSourceGraphqlApiResult disassociateSourceGraphqlApi(DisassociateSourceGraphqlApiRequest disassociateSourceGraphqlApiRequest)
Deletes an association between a Merged API and source API using the Merged API's identifier and the association ID.
disassociateSourceGraphqlApiRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.EvaluateCodeResult evaluateCode(EvaluateCodeRequest evaluateCodeRequest)
Evaluates the given code and returns the response. The code definition requirements depend on the specified
runtime. For APPSYNC_JS
runtimes, the code defines the request and response functions. The request
function takes the incoming request after a GraphQL operation is parsed and converts it into a request
configuration for the selected data source operation. The response function interprets responses from the data
source and maps it to the shape of the GraphQL field output type.
evaluateCodeRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.EvaluateMappingTemplateResult evaluateMappingTemplate(EvaluateMappingTemplateRequest evaluateMappingTemplateRequest)
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).
evaluateMappingTemplateRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.FlushApiCacheResult flushApiCache(FlushApiCacheRequest flushApiCacheRequest)
Flushes an ApiCache
object.
flushApiCacheRequest
- Represents the input of a FlushApiCache
operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetApiAssociationResult getApiAssociation(GetApiAssociationRequest getApiAssociationRequest)
Retrieves an ApiAssociation
object.
getApiAssociationRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.GetApiCacheResult getApiCache(GetApiCacheRequest getApiCacheRequest)
Retrieves an ApiCache
object.
getApiCacheRequest
- Represents the input of a GetApiCache
operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetDataSourceResult getDataSource(GetDataSourceRequest getDataSourceRequest)
Retrieves a DataSource
object.
getDataSourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetDataSourceIntrospectionResult getDataSourceIntrospection(GetDataSourceIntrospectionRequest getDataSourceIntrospectionRequest)
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.
getDataSourceIntrospectionRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetDomainNameResult getDomainName(GetDomainNameRequest getDomainNameRequest)
Retrieves a custom DomainName
object.
getDomainNameRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.GetFunctionResult getFunction(GetFunctionRequest getFunctionRequest)
Get a Function
.
getFunctionRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.GetGraphqlApiResult getGraphqlApi(GetGraphqlApiRequest getGraphqlApiRequest)
Retrieves a GraphqlApi
object.
getGraphqlApiRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.GetGraphqlApiEnvironmentVariablesResult getGraphqlApiEnvironmentVariables(GetGraphqlApiEnvironmentVariablesRequest getGraphqlApiEnvironmentVariablesRequest)
Retrieves the list of environmental variable key-value pairs associated with an API by its ID value.
getGraphqlApiEnvironmentVariablesRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.GetIntrospectionSchemaResult getIntrospectionSchema(GetIntrospectionSchemaRequest getIntrospectionSchemaRequest)
Retrieves the introspection schema for a GraphQL API.
getIntrospectionSchemaRequest
- GraphQLSchemaException
- The GraphQL schema is not valid.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetResolverResult getResolver(GetResolverRequest getResolverRequest)
Retrieves a Resolver
object.
getResolverRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.GetSchemaCreationStatusResult getSchemaCreationStatus(GetSchemaCreationStatusRequest getSchemaCreationStatusRequest)
Retrieves the current status of a schema creation operation.
getSchemaCreationStatusRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.GetSourceApiAssociationResult getSourceApiAssociation(GetSourceApiAssociationRequest getSourceApiAssociationRequest)
Retrieves a SourceApiAssociation
object.
getSourceApiAssociationRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.GetTypeResult getType(GetTypeRequest getTypeRequest)
Retrieves a Type
object.
getTypeRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListApiKeysResult listApiKeys(ListApiKeysRequest listApiKeysRequest)
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 DeleteApiKey
to manually delete a key
before it's automatically deleted.
listApiKeysRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListDataSourcesResult listDataSources(ListDataSourcesRequest listDataSourcesRequest)
Lists the data sources for a given API.
listDataSourcesRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListDomainNamesResult listDomainNames(ListDomainNamesRequest listDomainNamesRequest)
Lists multiple custom domain names.
listDomainNamesRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListFunctionsResult listFunctions(ListFunctionsRequest listFunctionsRequest)
List multiple functions.
listFunctionsRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListGraphqlApisResult listGraphqlApis(ListGraphqlApisRequest listGraphqlApisRequest)
Lists your GraphQL APIs.
listGraphqlApisRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListResolversResult listResolvers(ListResolversRequest listResolversRequest)
Lists the resolvers for a given API and type.
listResolversRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListResolversByFunctionResult listResolversByFunction(ListResolversByFunctionRequest listResolversByFunctionRequest)
List the resolvers that are associated with a specific function.
listResolversByFunctionRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListSourceApiAssociationsResult listSourceApiAssociations(ListSourceApiAssociationsRequest listSourceApiAssociationsRequest)
Lists the SourceApiAssociationSummary
data.
listSourceApiAssociationsRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags for a resource.
listTagsForResourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.ListTypesResult listTypes(ListTypesRequest listTypesRequest)
Lists the types for a given API.
listTypesRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.ListTypesByAssociationResult listTypesByAssociation(ListTypesByAssociationRequest listTypesByAssociationRequest)
Lists Type
objects by the source API association ID.
listTypesByAssociationRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.PutGraphqlApiEnvironmentVariablesResult putGraphqlApiEnvironmentVariables(PutGraphqlApiEnvironmentVariablesRequest putGraphqlApiEnvironmentVariablesRequest)
Creates a list of environmental variables in an API by its ID value.
When creating an environmental variable, it must follow the constraints below:
Both JavaScript and VTL templates support environmental variables.
Environmental variables are not evaluated before function invocation.
Environmental variables only support string values.
Any defined value in an environmental variable is considered a string literal and not expanded.
Variable evaluations should ideally be performed in the function code.
When creating an environmental variable key-value pair, it must follow the additional constraints below:
Keys must begin with a letter.
Keys must be at least two characters long.
Keys can only contain letters, numbers, and the underscore character (_).
Values can be up to 512 characters long.
You can configure up to 50 key-value pairs in a GraphQL API.
You can create a list of environmental variables by adding it to the environmentVariables
payload as
a list in the format {"key1":"value1","key2":"value2", …}
. Note that each call of the
PutGraphqlApiEnvironmentVariables
action will result in the overwriting of the existing
environmental variable list of that API. This means the existing environmental variables will be lost. To avoid
this, you must include all existing and new environmental variables in the list each time you call this action.
putGraphqlApiEnvironmentVariablesRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.StartDataSourceIntrospectionResult startDataSourceIntrospection(StartDataSourceIntrospectionRequest startDataSourceIntrospectionRequest)
Creates a new introspection. Returns the introspectionId
of the new introspection after its
creation.
startDataSourceIntrospectionRequest
- NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.StartSchemaCreationResult startSchemaCreation(StartSchemaCreationRequest startSchemaCreationRequest)
Adds a new schema to your GraphQL API.
This operation is asynchronous. Use to determine when it has completed.
startSchemaCreationRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.StartSchemaMergeResult startSchemaMerge(StartSchemaMergeRequest startSchemaMergeRequest)
Initiates a merge operation. Returns a status that shows the result of the merge operation.
startSchemaMergeRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Tags a resource with user-supplied tags.
tagResourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Untags a resource.
untagResourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.LimitExceededException
- The request exceeded a limit. Try your request again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.UpdateApiCacheResult updateApiCache(UpdateApiCacheRequest updateApiCacheRequest)
Updates the cache for the GraphQL API.
updateApiCacheRequest
- Represents the input of a UpdateApiCache
operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.UpdateApiKeyResult updateApiKey(UpdateApiKeyRequest updateApiKeyRequest)
Updates an API key. You can update the key as long as it's not deleted.
updateApiKeyRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.LimitExceededException
- The request exceeded a limit. Try your request again.InternalFailureException
- An internal AppSync error occurred. Try your request again.ApiKeyValidityOutOfBoundsException
- The API key expiration must be set to a value between 1 and 365 days from creation (for
CreateApiKey
) or from update (for UpdateApiKey
).UpdateDataSourceResult updateDataSource(UpdateDataSourceRequest updateDataSourceRequest)
Updates a DataSource
object.
updateDataSourceRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.UpdateDomainNameResult updateDomainName(UpdateDomainNameRequest updateDomainNameRequest)
Updates a custom DomainName
object.
updateDomainNameRequest
- AccessDeniedException
- You don't have access to perform this operation on this resource.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UpdateFunctionResult updateFunction(UpdateFunctionRequest updateFunctionRequest)
Updates a Function
object.
updateFunctionRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.UpdateGraphqlApiResult updateGraphqlApi(UpdateGraphqlApiRequest updateGraphqlApiRequest)
Updates a GraphqlApi
object.
updateGraphqlApiRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.AccessDeniedException
- You don't have access to perform this operation on this resource.UpdateResolverResult updateResolver(UpdateResolverRequest updateResolverRequest)
Updates a Resolver
object.
updateResolverRequest
- ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.UpdateSourceApiAssociationResult updateSourceApiAssociation(UpdateSourceApiAssociationRequest updateSourceApiAssociationRequest)
Updates some of the configuration choices of a particular source API association.
updateSourceApiAssociationRequest
- UnauthorizedException
- You aren't authorized to perform this operation.BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.InternalFailureException
- An internal AppSync error occurred. Try your request again.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.UpdateTypeResult updateType(UpdateTypeRequest updateTypeRequest)
Updates a Type
object.
updateTypeRequest
- BadRequestException
- The request is not well formed. For example, a value is invalid or a required field is missing. Check the
field values, and then try again.ConcurrentModificationException
- Another modification is in progress at this time and it must complete before you can make your change.NotFoundException
- The resource specified in the request was not found. Check the resource, and then try again.UnauthorizedException
- You aren't authorized to perform this operation.InternalFailureException
- An internal AppSync error occurred. Try your request again.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.