ConnectionFunction class

Manages an AWS CloudFront Connection Function.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudfront.ConnectionFunction("example", {
    connectionFunctionConfig: {
        runtime: "cloudfront-js-2.0",
        comment: "Example connection function",
    },
    name: "example-connection-function",
    connectionFunctionCode: "function handler(event) { return event.request; }",
});

import pulumi
import pulumi_aws as aws

example = aws.cloudfront.ConnectionFunction("example",
    connection_function_config={
        "runtime": "cloudfront-js-2.0",
        "comment": "Example connection function",
    },
    name="example-connection-function",
    connection_function_code="function handler(event) { return event.request; }")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.CloudFront.ConnectionFunction("example", new()
    {
        ConnectionFunctionConfig = new Aws.CloudFront.Inputs.ConnectionFunctionConnectionFunctionConfigArgs
        {
            Runtime = "cloudfront-js-2.0",
            Comment = "Example connection function",
        },
        Name = "example-connection-function",
        ConnectionFunctionCode = "function handler(event) { return event.request; }",
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloudfront"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudfront.NewConnectionFunction(ctx, "example", &cloudfront.ConnectionFunctionArgs{
			ConnectionFunctionConfig: &cloudfront.ConnectionFunctionConnectionFunctionConfigArgs{
				Runtime: pulumi.String("cloudfront-js-2.0"),
				Comment: pulumi.String("Example connection function"),
			},
			Name:                   pulumi.String("example-connection-function"),
			ConnectionFunctionCode: pulumi.String("function handler(event) { return event.request; }"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_cloudfront_connectionfunction" "example" {
  connection_function_config = {
    runtime = "cloudfront-js-2.0"
    comment = "Example connection function"
  }
  name                     = "example-connection-function"
  connection_function_code = "function handler(event) { return event.request; }"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudfront.ConnectionFunction;
import com.pulumi.aws.cloudfront.ConnectionFunctionArgs;
import com.pulumi.aws.cloudfront.inputs.ConnectionFunctionConnectionFunctionConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new ConnectionFunction("example", ConnectionFunctionArgs.builder()
            .connectionFunctionConfig(ConnectionFunctionConnectionFunctionConfigArgs.builder()
                .runtime("cloudfront-js-2.0")
                .comment("Example connection function")
                .build())
            .name("example-connection-function")
            .connectionFunctionCode("function handler(event) { return event.request; }")
            .build());

    }
}

resources:
  example:
    type: aws:cloudfront:ConnectionFunction
    properties:
      connectionFunctionConfig:
        runtime: cloudfront-js-2.0
        comment: Example connection function
      name: example-connection-function
      connectionFunctionCode: function handler(event) { return event.request; }

With Publish Enabled

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudfront.ConnectionFunction("example", {
    connectionFunctionConfig: {
        runtime: "cloudfront-js-2.0",
        comment: "Example connection function",
    },
    name: "example-connection-function",
    connectionFunctionCode: "function handler(event) { return event.request; }",
    publish: true,
});

import pulumi
import pulumi_aws as aws

example = aws.cloudfront.ConnectionFunction("example",
    connection_function_config={
        "runtime": "cloudfront-js-2.0",
        "comment": "Example connection function",
    },
    name="example-connection-function",
    connection_function_code="function handler(event) { return event.request; }",
    publish=True)

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.CloudFront.ConnectionFunction("example", new()
    {
        ConnectionFunctionConfig = new Aws.CloudFront.Inputs.ConnectionFunctionConnectionFunctionConfigArgs
        {
            Runtime = "cloudfront-js-2.0",
            Comment = "Example connection function",
        },
        Name = "example-connection-function",
        ConnectionFunctionCode = "function handler(event) { return event.request; }",
        Publish = true,
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloudfront"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudfront.NewConnectionFunction(ctx, "example", &cloudfront.ConnectionFunctionArgs{
			ConnectionFunctionConfig: &cloudfront.ConnectionFunctionConnectionFunctionConfigArgs{
				Runtime: pulumi.String("cloudfront-js-2.0"),
				Comment: pulumi.String("Example connection function"),
			},
			Name:                   pulumi.String("example-connection-function"),
			ConnectionFunctionCode: pulumi.String("function handler(event) { return event.request; }"),
			Publish:                pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_cloudfront_connectionfunction" "example" {
  connection_function_config = {
    runtime = "cloudfront-js-2.0"
    comment = "Example connection function"
  }
  name                     = "example-connection-function"
  connection_function_code = "function handler(event) { return event.request; }"
  publish                  = true
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudfront.ConnectionFunction;
import com.pulumi.aws.cloudfront.ConnectionFunctionArgs;
import com.pulumi.aws.cloudfront.inputs.ConnectionFunctionConnectionFunctionConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new ConnectionFunction("example", ConnectionFunctionArgs.builder()
            .connectionFunctionConfig(ConnectionFunctionConnectionFunctionConfigArgs.builder()
                .runtime("cloudfront-js-2.0")
                .comment("Example connection function")
                .build())
            .name("example-connection-function")
            .connectionFunctionCode("function handler(event) { return event.request; }")
            .publish(true)
            .build());

    }
}

resources:
  example:
    type: aws:cloudfront:ConnectionFunction
    properties:
      connectionFunctionConfig:
        runtime: cloudfront-js-2.0
        comment: Example connection function
      name: example-connection-function
      connectionFunctionCode: function handler(event) { return event.request; }
      publish: true

With Key Value Store Associations

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudfront.KeyValueStore("example", {
    name: "example-kvs",
    comment: "Example key value store",
});
const exampleConnectionFunction = new aws.cloudfront.ConnectionFunction("example", {
    connectionFunctionConfig: {
        keyValueStoreAssociation: {
            keyValueStoreArn: example.arn,
        },
        runtime: "cloudfront-js-2.0",
        comment: "Example connection function",
    },
    name: "example-connection-function",
    connectionFunctionCode: "function handler(event) { return event.request; }",
});

import pulumi
import pulumi_aws as aws

example = aws.cloudfront.KeyValueStore("example",
    name="example-kvs",
    comment="Example key value store")
example_connection_function = aws.cloudfront.ConnectionFunction("example",
    connection_function_config={
        "key_value_store_association": {
            "key_value_store_arn": example.arn,
        },
        "runtime": "cloudfront-js-2.0",
        "comment": "Example connection function",
    },
    name="example-connection-function",
    connection_function_code="function handler(event) { return event.request; }")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.CloudFront.KeyValueStore("example", new()
    {
        Name = "example-kvs",
        Comment = "Example key value store",
    });

    var exampleConnectionFunction = new Aws.CloudFront.ConnectionFunction("example", new()
    {
        ConnectionFunctionConfig = new Aws.CloudFront.Inputs.ConnectionFunctionConnectionFunctionConfigArgs
        {
            KeyValueStoreAssociation = new Aws.CloudFront.Inputs.ConnectionFunctionConnectionFunctionConfigKeyValueStoreAssociationArgs
            {
                KeyValueStoreArn = example.Arn,
            },
            Runtime = "cloudfront-js-2.0",
            Comment = "Example connection function",
        },
        Name = "example-connection-function",
        ConnectionFunctionCode = "function handler(event) { return event.request; }",
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloudfront"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := cloudfront.NewKeyValueStore(ctx, "example", &cloudfront.KeyValueStoreArgs{
			Name:    pulumi.String("example-kvs"),
			Comment: pulumi.String("Example key value store"),
		})
		if err != nil {
			return err
		}
		_, err = cloudfront.NewConnectionFunction(ctx, "example", &cloudfront.ConnectionFunctionArgs{
			ConnectionFunctionConfig: &cloudfront.ConnectionFunctionConnectionFunctionConfigArgs{
				KeyValueStoreAssociation: &cloudfront.ConnectionFunctionConnectionFunctionConfigKeyValueStoreAssociationArgs{
					KeyValueStoreArn: example.Arn,
				},
				Runtime: pulumi.String("cloudfront-js-2.0"),
				Comment: pulumi.String("Example connection function"),
			},
			Name:                   pulumi.String("example-connection-function"),
			ConnectionFunctionCode: pulumi.String("function handler(event) { return event.request; }"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_cloudfront_keyvaluestore" "example" {
  name    = "example-kvs"
  comment = "Example key value store"
}
resource "aws_cloudfront_connectionfunction" "example" {
  connection_function_config = {
    key_value_store_association = {
      key_value_store_arn = aws_cloudfront_keyvaluestore.example.arn
    }
    runtime = "cloudfront-js-2.0"
    comment = "Example connection function"
  }
  name                     = "example-connection-function"
  connection_function_code = "function handler(event) { return event.request; }"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudfront.KeyValueStore;
import com.pulumi.aws.cloudfront.KeyValueStoreArgs;
import com.pulumi.aws.cloudfront.ConnectionFunction;
import com.pulumi.aws.cloudfront.ConnectionFunctionArgs;
import com.pulumi.aws.cloudfront.inputs.ConnectionFunctionConnectionFunctionConfigArgs;
import com.pulumi.aws.cloudfront.inputs.ConnectionFunctionConnectionFunctionConfigKeyValueStoreAssociationArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new KeyValueStore("example", KeyValueStoreArgs.builder()
            .name("example-kvs")
            .comment("Example key value store")
            .build());

        var exampleConnectionFunction = new ConnectionFunction("exampleConnectionFunction", ConnectionFunctionArgs.builder()
            .connectionFunctionConfig(ConnectionFunctionConnectionFunctionConfigArgs.builder()
                .keyValueStoreAssociation(ConnectionFunctionConnectionFunctionConfigKeyValueStoreAssociationArgs.builder()
                    .keyValueStoreArn(example.arn())
                    .build())
                .runtime("cloudfront-js-2.0")
                .comment("Example connection function")
                .build())
            .name("example-connection-function")
            .connectionFunctionCode("function handler(event) { return event.request; }")
            .build());

    }
}

resources:
  example:
    type: aws:cloudfront:KeyValueStore
    properties:
      name: example-kvs
      comment: Example key value store
  exampleConnectionFunction:
    type: aws:cloudfront:ConnectionFunction
    name: example
    properties:
      connectionFunctionConfig:
        keyValueStoreAssociation:
          keyValueStoreArn: ${example.arn}
        runtime: cloudfront-js-2.0
        comment: Example connection function
      name: example-connection-function
      connectionFunctionCode: function handler(event) { return event.request; }

With Tags

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudfront.ConnectionFunction("example", {
    connectionFunctionConfig: {
        runtime: "cloudfront-js-2.0",
        comment: "Example connection function",
    },
    name: "example-connection-function",
    connectionFunctionCode: "function handler(event) { return event.request; }",
    tags: {
        Environment: "production",
        Team: "web",
    },
});

import pulumi
import pulumi_aws as aws

example = aws.cloudfront.ConnectionFunction("example",
    connection_function_config={
        "runtime": "cloudfront-js-2.0",
        "comment": "Example connection function",
    },
    name="example-connection-function",
    connection_function_code="function handler(event) { return event.request; }",
    tags={
        "Environment": "production",
        "Team": "web",
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.CloudFront.ConnectionFunction("example", new()
    {
        ConnectionFunctionConfig = new Aws.CloudFront.Inputs.ConnectionFunctionConnectionFunctionConfigArgs
        {
            Runtime = "cloudfront-js-2.0",
            Comment = "Example connection function",
        },
        Name = "example-connection-function",
        ConnectionFunctionCode = "function handler(event) { return event.request; }",
        Tags =
        {
            { "Environment", "production" },
            { "Team", "web" },
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloudfront"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudfront.NewConnectionFunction(ctx, "example", &cloudfront.ConnectionFunctionArgs{
			ConnectionFunctionConfig: &cloudfront.ConnectionFunctionConnectionFunctionConfigArgs{
				Runtime: pulumi.String("cloudfront-js-2.0"),
				Comment: pulumi.String("Example connection function"),
			},
			Name:                   pulumi.String("example-connection-function"),
			ConnectionFunctionCode: pulumi.String("function handler(event) { return event.request; }"),
			Tags: pulumi.StringMap{
				"Environment": pulumi.String("production"),
				"Team":        pulumi.String("web"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_cloudfront_connectionfunction" "example" {
  connection_function_config = {
    runtime = "cloudfront-js-2.0"
    comment = "Example connection function"
  }
  name                     = "example-connection-function"
  connection_function_code = "function handler(event) { return event.request; }"
  tags = {
    "Environment" = "production"
    "Team"        = "web"
  }
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudfront.ConnectionFunction;
import com.pulumi.aws.cloudfront.ConnectionFunctionArgs;
import com.pulumi.aws.cloudfront.inputs.ConnectionFunctionConnectionFunctionConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new ConnectionFunction("example", ConnectionFunctionArgs.builder()
            .connectionFunctionConfig(ConnectionFunctionConnectionFunctionConfigArgs.builder()
                .runtime("cloudfront-js-2.0")
                .comment("Example connection function")
                .build())
            .name("example-connection-function")
            .connectionFunctionCode("function handler(event) { return event.request; }")
            .tags(Map.ofEntries(
                Map.entry("Environment", "production"),
                Map.entry("Team", "web")
            ))
            .build());

    }
}

resources:
  example:
    type: aws:cloudfront:ConnectionFunction
    properties:
      connectionFunctionConfig:
        runtime: cloudfront-js-2.0
        comment: Example connection function
      name: example-connection-function
      connectionFunctionCode: function handler(event) { return event.request; }
      tags:
        Environment: production
        Team: web

Import

Using pulumi import, import CloudFront Connection Function using the function ID. For example:

$ pulumi import aws:cloudfront/connectionFunction:ConnectionFunction example E1PA6795UKMFR9