This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::AppSync::FunctionConfiguration
<a name="aws-resource-appsync-functionconfiguration"></a>

The `AWS::AppSync::FunctionConfiguration` resource defines the functions in GraphQL APIs to perform certain operations. You can use pipeline resolvers to attach functions. For more information, see [Pipeline Resolvers](https://docs.aws.amazon.com/appsync/latest/devguide/pipeline-resolvers.html) in the *AWS AppSync Developer Guide*. 

**Note**  
When you submit an update, AWS CloudFormation updates resources based on differences between what you submit and the stack's current template. To cause this resource to be updated you must change a property value for this resource in the CloudFormation template. Changing the Amazon S3 file content without changing a property value will not result in an update operation.  
See [Update Behaviors of Stack Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html) in the *AWS CloudFormation User Guide*.

## Syntax
<a name="aws-resource-appsync-functionconfiguration-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-appsync-functionconfiguration-syntax.json"></a>

```
{
  "Type" : "AWS::AppSync::FunctionConfiguration",
  "Properties" : {
      "[ApiId](#cfn-appsync-functionconfiguration-apiid)" : String,
      "[Code](#cfn-appsync-functionconfiguration-code)" : String,
      "[CodeS3Location](#cfn-appsync-functionconfiguration-codes3location)" : String,
      "[DataSourceName](#cfn-appsync-functionconfiguration-datasourcename)" : String,
      "[Description](#cfn-appsync-functionconfiguration-description)" : String,
      "[FunctionVersion](#cfn-appsync-functionconfiguration-functionversion)" : String,
      "[MaxBatchSize](#cfn-appsync-functionconfiguration-maxbatchsize)" : Integer,
      "[Name](#cfn-appsync-functionconfiguration-name)" : String,
      "[RequestMappingTemplate](#cfn-appsync-functionconfiguration-requestmappingtemplate)" : String,
      "[RequestMappingTemplateS3Location](#cfn-appsync-functionconfiguration-requestmappingtemplates3location)" : String,
      "[ResponseMappingTemplate](#cfn-appsync-functionconfiguration-responsemappingtemplate)" : String,
      "[ResponseMappingTemplateS3Location](#cfn-appsync-functionconfiguration-responsemappingtemplates3location)" : String,
      "[Runtime](#cfn-appsync-functionconfiguration-runtime)" : AppSyncRuntime,
      "[SyncConfig](#cfn-appsync-functionconfiguration-syncconfig)" : SyncConfig
    }
}
```

### YAML
<a name="aws-resource-appsync-functionconfiguration-syntax.yaml"></a>

```
Type: AWS::AppSync::FunctionConfiguration
Properties:
  [ApiId](#cfn-appsync-functionconfiguration-apiid): String
  [Code](#cfn-appsync-functionconfiguration-code): String
  [CodeS3Location](#cfn-appsync-functionconfiguration-codes3location): String
  [DataSourceName](#cfn-appsync-functionconfiguration-datasourcename): String
  [Description](#cfn-appsync-functionconfiguration-description): String
  [FunctionVersion](#cfn-appsync-functionconfiguration-functionversion): String
  [MaxBatchSize](#cfn-appsync-functionconfiguration-maxbatchsize): Integer
  [Name](#cfn-appsync-functionconfiguration-name): String
  [RequestMappingTemplate](#cfn-appsync-functionconfiguration-requestmappingtemplate): String
  [RequestMappingTemplateS3Location](#cfn-appsync-functionconfiguration-requestmappingtemplates3location): String
  [ResponseMappingTemplate](#cfn-appsync-functionconfiguration-responsemappingtemplate): String
  [ResponseMappingTemplateS3Location](#cfn-appsync-functionconfiguration-responsemappingtemplates3location): String
  [Runtime](#cfn-appsync-functionconfiguration-runtime): 
    AppSyncRuntime
  [SyncConfig](#cfn-appsync-functionconfiguration-syncconfig): 
    SyncConfig
```

## Properties
<a name="aws-resource-appsync-functionconfiguration-properties"></a>

`ApiId`  <a name="cfn-appsync-functionconfiguration-apiid"></a>
The AWS AppSync GraphQL API that you want to attach using this function.  
*Required*: Yes  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Code`  <a name="cfn-appsync-functionconfiguration-code"></a>
The `resolver` code that contains the request and response functions. When code is used, the `runtime` is required. The runtime value must be `APPSYNC_JS`.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CodeS3Location`  <a name="cfn-appsync-functionconfiguration-codes3location"></a>
 The Amazon S3 endpoint.   
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DataSourceName`  <a name="cfn-appsync-functionconfiguration-datasourcename"></a>
The name of data source this function will attach.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Description`  <a name="cfn-appsync-functionconfiguration-description"></a>
The `Function` description.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`FunctionVersion`  <a name="cfn-appsync-functionconfiguration-functionversion"></a>
The version of the request mapping template. Currently, only the 2018-05-29 version of the template is supported.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`MaxBatchSize`  <a name="cfn-appsync-functionconfiguration-maxbatchsize"></a>
The maximum number of resolver request inputs that will be sent to a single AWS Lambda function in a `BatchInvoke` operation.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-appsync-functionconfiguration-name"></a>
The name of the function.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RequestMappingTemplate`  <a name="cfn-appsync-functionconfiguration-requestmappingtemplate"></a>
The `Function` request mapping template. Functions support only the 2018-05-29 version of the request mapping template.  
*Required*: No  
*Type*: String  
*Pattern*: `^.*$`  
*Minimum*: `1`  
*Maximum*: `65536`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RequestMappingTemplateS3Location`  <a name="cfn-appsync-functionconfiguration-requestmappingtemplates3location"></a>
Describes a Sync configuration for a resolver.  
Contains information on which Conflict Detection, as well as Resolution strategy, should be performed when the resolver is invoked.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ResponseMappingTemplate`  <a name="cfn-appsync-functionconfiguration-responsemappingtemplate"></a>
The `Function` response mapping template.  
*Required*: No  
*Type*: String  
*Pattern*: `^.*$`  
*Minimum*: `1`  
*Maximum*: `65536`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ResponseMappingTemplateS3Location`  <a name="cfn-appsync-functionconfiguration-responsemappingtemplates3location"></a>
The location of a response mapping template in an Amazon S3 bucket. Use this if you want to provision with a template file in Amazon S3 rather than embedding it in your CloudFormation template.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Runtime`  <a name="cfn-appsync-functionconfiguration-runtime"></a>
Describes a runtime used by an AWS AppSync resolver or AWS AppSync function. Specifies the name and version of the runtime to use. Note that if a runtime is specified, code must also be specified.  
*Required*: No  
*Type*: [AppSyncRuntime](aws-properties-appsync-functionconfiguration-appsyncruntime.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SyncConfig`  <a name="cfn-appsync-functionconfiguration-syncconfig"></a>
Describes a Sync configuration for a resolver.  
Specifies which Conflict Detection strategy and Resolution strategy to use when the resolver is invoked.  
*Required*: No  
*Type*: [SyncConfig](aws-properties-appsync-functionconfiguration-syncconfig.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-appsync-functionconfiguration-return-values"></a>

### Ref
<a name="aws-resource-appsync-functionconfiguration-return-values-ref"></a>

When you pass the logical ID of an `AWS::AppSync::FunctionConfiguration` resource to the intrinsic `Ref` function, the function returns the ARN of the FunctionConfiguration, such as `arn:aws:appsync:us-east-1:123456789012:apis/graphqlapiid/functions/functionid`. 

For more information about using the `Ref` function, see [Ref](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref).

### Fn::GetAtt
<a name="aws-resource-appsync-functionconfiguration-return-values-fn--getatt"></a>

`Fn::GetAtt` returns a value for a specified attribute of this type. The following are the available attributes and sample return values. 

For more information about using `Fn::GetAtt`, see [Fn::GetAtt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt). 

#### 
<a name="aws-resource-appsync-functionconfiguration-return-values-fn--getatt-fn--getatt"></a>

`DataSourceName`  <a name="DataSourceName-fn::getatt"></a>
The name of data source this function will attach.

`FunctionArn`  <a name="FunctionArn-fn::getatt"></a>
ARN of the function, such as `arn:aws:appsync:us-east-1:123456789012:apis/graphqlapiid/functions/functionId`.

`FunctionId`  <a name="FunctionId-fn::getatt"></a>
The unique ID of this function.

`Name`  <a name="Name-fn::getatt"></a>
The name of the function.

## Examples
<a name="aws-resource-appsync-functionconfiguration--examples"></a>



### Function Creation Example
<a name="aws-resource-appsync-functionconfiguration--examples--Function_Creation_Example"></a>

The following example creates a function and associates it with an existing GraphQL API and a data source by passing the GraphQL API ID and data source name as a parameter.

#### YAML
<a name="aws-resource-appsync-functionconfiguration--examples--Function_Creation_Example--yaml"></a>

```
Parameters:
  graphQlApiId:
    Type: String
  dataSourceName:
    Type: String
  name:
    Type: String
  description:
    Type: String
  functionVersion:
    Type: String
  requestMappingTemplateS3LocationInput:
    Type: String
  responseMappingTemplateS3LocationInput:
    Type: String
Resources:
  FunctionConfiguration:
    Type: AWS::AppSync::FunctionConfiguration
    Properties:
      ApiId:
	Ref: graphQlApiId
      Name:
        Ref: name
      Description:
        Ref: description
      DataSourceName:
        Ref: dataSourceName
      FunctionVersion:
        Ref: functionVersion
      RequestMappingTemplateS3Location:
        Ref: requestMappingTemplateS3LocationInput
      ResponseMappingTemplateS3Location:
        Ref: responseMappingTemplateS3LocationInput
```

#### JSON
<a name="aws-resource-appsync-functionconfiguration--examples--Function_Creation_Example--json"></a>

```
{
  "Parameters": {
    "graphQlApiId": {
      "Type": "String"
    },
    "name": {
      "Type": "String"
    },
    "description": {
      "Type": "String"
    },
    "dataSourceName": {
      "Type": "String"
    },
    "functionVersion": {
      "Type": "String"
    },
    "requestMappingTemplateS3LocationInput": {
      "Type": "String"
    },
    "responseMappingTemplateS3LocationInput": {
      "Type": "String"
    }
  },
  "Resources": {
    "FunctionConfiguration": {
      "Type": "AWS::AppSync::FunctionConfiguration",
      "Properties": {
        "ApiId": {
          "Ref": "graphQlApiId"
        },
        "Name": {
          "Ref": "name"
        },
        "Description": {
          "Ref": "description"
        },
        "FunctionVersion": {
          "Ref": "functionVersion"
        },
        "DataSourceName": {
          "Ref": "dataSourceName"
        },
        "RequestMappingTemplateS3Location": {
          "Ref": "requestMappingTemplateS3LocationInput"
        },
        "ResponseMappingTemplateS3Location": {
          "Ref": "responseMappingTemplateS3LocationInput"
        }
      }
    }
  }
}
```

## See also
<a name="aws-resource-appsync-functionconfiguration--seealso"></a>
+ [CreateFunction](https://docs.aws.amazon.com/appsync/latest/APIReference/API_CreateFunction.html) operation in the *AWS AppSync API Reference*.



# AWS::AppSync::FunctionConfiguration AppSyncRuntime
<a name="aws-properties-appsync-functionconfiguration-appsyncruntime"></a>

Describes a runtime used by an AWS AppSync resolver or AWS AppSync function. Specifies the name and version of the runtime to use. Note that if a runtime is specified, code must also be specified.

## Syntax
<a name="aws-properties-appsync-functionconfiguration-appsyncruntime-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-appsync-functionconfiguration-appsyncruntime-syntax.json"></a>

```
{
  "[Name](#cfn-appsync-functionconfiguration-appsyncruntime-name)" : String,
  "[RuntimeVersion](#cfn-appsync-functionconfiguration-appsyncruntime-runtimeversion)" : String
}
```

### YAML
<a name="aws-properties-appsync-functionconfiguration-appsyncruntime-syntax.yaml"></a>

```
  [Name](#cfn-appsync-functionconfiguration-appsyncruntime-name): String
  [RuntimeVersion](#cfn-appsync-functionconfiguration-appsyncruntime-runtimeversion): String
```

## Properties
<a name="aws-properties-appsync-functionconfiguration-appsyncruntime-properties"></a>

`Name`  <a name="cfn-appsync-functionconfiguration-appsyncruntime-name"></a>
The `name` of the runtime to use. Currently, the only allowed value is `APPSYNC_JS`.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RuntimeVersion`  <a name="cfn-appsync-functionconfiguration-appsyncruntime-runtimeversion"></a>
The `version` of the runtime to use. Currently, the only allowed version is `1.0.0`.  
*Required*: Yes  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::AppSync::FunctionConfiguration LambdaConflictHandlerConfig
<a name="aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig"></a>

The `LambdaConflictHandlerConfig` object when configuring `LAMBDA` as the Conflict Handler.

## Syntax
<a name="aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig-syntax.json"></a>

```
{
  "[LambdaConflictHandlerArn](#cfn-appsync-functionconfiguration-lambdaconflicthandlerconfig-lambdaconflicthandlerarn)" : String
}
```

### YAML
<a name="aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig-syntax.yaml"></a>

```
  [LambdaConflictHandlerArn](#cfn-appsync-functionconfiguration-lambdaconflicthandlerconfig-lambdaconflicthandlerarn): String
```

## Properties
<a name="aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig-properties"></a>

`LambdaConflictHandlerArn`  <a name="cfn-appsync-functionconfiguration-lambdaconflicthandlerconfig-lambdaconflicthandlerarn"></a>
The Amazon Resource Name (ARN) for the Lambda function to use as the Conflict Handler.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::AppSync::FunctionConfiguration SyncConfig
<a name="aws-properties-appsync-functionconfiguration-syncconfig"></a>

Describes a Sync configuration for a resolver.

Specifies which Conflict Detection strategy and Resolution strategy to use when the resolver is invoked.

## Syntax
<a name="aws-properties-appsync-functionconfiguration-syncconfig-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-appsync-functionconfiguration-syncconfig-syntax.json"></a>

```
{
  "[ConflictDetection](#cfn-appsync-functionconfiguration-syncconfig-conflictdetection)" : String,
  "[ConflictHandler](#cfn-appsync-functionconfiguration-syncconfig-conflicthandler)" : String,
  "[LambdaConflictHandlerConfig](#cfn-appsync-functionconfiguration-syncconfig-lambdaconflicthandlerconfig)" : LambdaConflictHandlerConfig
}
```

### YAML
<a name="aws-properties-appsync-functionconfiguration-syncconfig-syntax.yaml"></a>

```
  [ConflictDetection](#cfn-appsync-functionconfiguration-syncconfig-conflictdetection): String
  [ConflictHandler](#cfn-appsync-functionconfiguration-syncconfig-conflicthandler): String
  [LambdaConflictHandlerConfig](#cfn-appsync-functionconfiguration-syncconfig-lambdaconflicthandlerconfig): 
    LambdaConflictHandlerConfig
```

## Properties
<a name="aws-properties-appsync-functionconfiguration-syncconfig-properties"></a>

`ConflictDetection`  <a name="cfn-appsync-functionconfiguration-syncconfig-conflictdetection"></a>
The Conflict Detection strategy to use.  
+ **VERSION**: Detect conflicts based on object versions for this resolver.
+ **NONE**: Do not detect conflicts when invoking this resolver.
*Required*: Yes  
*Type*: String  
*Allowed values*: `VERSION | NONE`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ConflictHandler`  <a name="cfn-appsync-functionconfiguration-syncconfig-conflicthandler"></a>
The Conflict Resolution strategy to perform in the event of a conflict.  
+ **OPTIMISTIC\$1CONCURRENCY**: Resolve conflicts by rejecting mutations when versions don't match the latest version at the server.
+ **AUTOMERGE**: Resolve conflicts with the Automerge conflict resolution strategy.
+ **LAMBDA**: Resolve conflicts with an AWS Lambda function supplied in the `LambdaConflictHandlerConfig`.
*Required*: No  
*Type*: String  
*Allowed values*: `OPTIMISTIC_CONCURRENCY | LAMBDA | AUTOMERGE | NONE`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LambdaConflictHandlerConfig`  <a name="cfn-appsync-functionconfiguration-syncconfig-lambdaconflicthandlerconfig"></a>
The `LambdaConflictHandlerConfig` when configuring `LAMBDA` as the Conflict Handler.  
*Required*: No  
*Type*: [LambdaConflictHandlerConfig](aws-properties-appsync-functionconfiguration-lambdaconflicthandlerconfig.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)