AWS v7.2.0, Jul 31 25

AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi

Migrating from 6.x to 7.x

AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi

Upstream Changes

The upstream target has been changed from v5.100.0 to targeting v5.11.0. That means that the upstream migration guide as well as the following CHANGELOGs are relevant:

Prerequisites to Upgrade to v7.0.0

-> Before upgrading to version 7.0.0, first upgrade to the latest available 6.x version of the provider. Run pulumi preview and confirm that:

Your preview completes without errors or unexpected changes.
There are no deprecation warnings related to the changes described in this guide.

It is also recommended that you run pulumi up --refresh prior to upgrading to ensure that your Pulumi state is up to date.

If you use version constraints in your package.json or requirements.txt (recommended), update them to allow the 7.x series and run npm install or pip install --upgrade to download the new version.

Example

Before:

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

// In package.json dependencies:
// "@pulumi/aws": "^6.92.0"

After:

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

// In package.json dependencies:
// "@pulumi/aws": "^7.0.0"

Performing the Upgrade

After you have upgraded the AWS provider library to v7 you need to run Pulumi with the --refresh and --run-program CLI flags in order to migrate the state to be compatible with the new major version.

$ pulumi up --refresh --run-program

Removed Provider Arguments

Remove the following from your provider configuration—they are no longer supported:

endpoints.opsworks – removed following AWS OpsWorks Stacks End of Life.
endpoints.simpledb and endpoints.sdb – removed due to the removal of Amazon SimpleDB support.
endpoints.worklink – removed due to the removal of Amazon Worklink support.

Enhanced Region Support

Version 7.0.0 adds region to most resources making it significantly easier to manage infrastructure across AWS Regions without requiring multiple provider configurations. See Enhanced Region Support.

Provider role chaining

v7 adds support for IAM role chaining by changing the assumeRole property to a list that accepts multiple assumeRole arguments.

This feature was added to the upstream provider in the previous major version, but since it required a breaking change in the Pulumi AWS SDK the change was backed out.

If you are providing the assumeRole property on the Provider, you will need to update your code. See the below example.

This (v6)

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

const baseRole = new aws.iam.Role("baseRole", {assumeRolePolicy: JSON.stringify({
    Version: "2012-10-17",
    Statement: [{
        Action: "sts:AssumeRole",
        Effect: "Allow",
        Sid: "",
        Principal: {
            Service: "ec2.amazonaws.com",
        },
    }],
})});
const provider = new aws.Provider("provider", {assumeRole: {
    roleArn: baseRole.arn,
}});

import pulumi
import json
import pulumi_aws as aws

base_role = aws.iam.Role("baseRole", assume_role_policy=json.dumps({
    "Version": "2012-10-17",
    "Statement": [{
        "Action": "sts:AssumeRole",
        "Effect": "Allow",
        "Sid": "",
        "Principal": {
            "Service": "ec2.amazonaws.com",
        },
    }],
}))
provider = aws.Provider("provider", assume_role={
    "role_arn": base_role.arn,
})

package main

import (
	"encoding/json"

	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Version": "2012-10-17",
			"Statement": []map[string]interface{}{
				map[string]interface{}{
					"Action": "sts:AssumeRole",
					"Effect": "Allow",
					"Sid":    "",
					"Principal": map[string]interface{}{
						"Service": "ec2.amazonaws.com",
					},
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		baseRole, err := iam.NewRole(ctx, "baseRole", &iam.RoleArgs{
			AssumeRolePolicy: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		_, err = aws.NewProvider(ctx, "provider", &aws.ProviderArgs{
			AssumeRole: &aws.ProviderAssumeRoleArgs{
				RoleArn: baseRole.Arn,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var baseRole = new Aws.Iam.Role("baseRole", new()
    {
        AssumeRolePolicy = JsonSerializer.Serialize(new Dictionary<string, object?>
        {
            ["Version"] = "2012-10-17",
            ["Statement"] = new[]
            {
                new Dictionary<string, object?>
                {
                    ["Action"] = "sts:AssumeRole",
                    ["Effect"] = "Allow",
                    ["Sid"] = "",
                    ["Principal"] = new Dictionary<string, object?>
                    {
                        ["Service"] = "ec2.amazonaws.com",
                    },
                },
            },
        }),
    });

    var provider = new Aws.Provider("provider", new()
    {
        AssumeRole = new Aws.Inputs.ProviderAssumeRoleArgs
        {
            RoleArn = baseRole.Arn,
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iam.Role;
import com.pulumi.aws.iam.RoleArgs;
import com.pulumi.aws.Provider;
import com.pulumi.aws.ProviderArgs;
import com.pulumi.aws.inputs.ProviderAssumeRoleArgs;
import static com.pulumi.codegen.internal.Serialization.*;
import java.util.List;
import java.util.ArrayList;
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 baseRole = new Role("baseRole", RoleArgs.builder()
            .assumeRolePolicy(serializeJson(
                jsonObject(
                    jsonProperty("Version", "2012-10-17"),
                    jsonProperty("Statement", jsonArray(jsonObject(
                        jsonProperty("Action", "sts:AssumeRole"),
                        jsonProperty("Effect", "Allow"),
                        jsonProperty("Sid", ""),
                        jsonProperty("Principal", jsonObject(
                            jsonProperty("Service", "ec2.amazonaws.com")
                        ))
                    )))
                )))
            .build());

        var provider = new Provider("provider", ProviderArgs.builder()
            .assumeRole(ProviderAssumeRoleArgs.builder()
                .roleArn(baseRole.arn())
                .build())
            .build());

    }
}

name: example
runtime: yaml
resources:
  baseRole:
    type: aws:iam:Role
    properties:
      assumeRolePolicy:
        fn::toJSON:
          Version: 2012-10-17
          Statement:
            - Action: sts:AssumeRole
              Effect: Allow
              Sid: ""
              Principal:
                Service: ec2.amazonaws.com
  provider:
    type: pulumi:providers:aws
    properties:
      assumeRole:
        roleArn: ${baseRole.arn}

Becomes this (v7)

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

const baseRole = new aws.iam.Role("baseRole", {assumeRolePolicy: JSON.stringify({
    Version: "2012-10-17",
    Statement: [{
        Action: "sts:AssumeRole",
        Effect: "Allow",
        Sid: "",
        Principal: {
            Service: "ec2.amazonaws.com",
        },
    }],
})});
const provider = new aws.Provider("provider", {assumeRoles: [{
    roleArn: baseRole.arn,
}]});

import pulumi
import json
import pulumi_aws as aws

base_role = aws.iam.Role("baseRole", assume_role_policy=json.dumps({
    "Version": "2012-10-17",
    "Statement": [{
        "Action": "sts:AssumeRole",
        "Effect": "Allow",
        "Sid": "",
        "Principal": {
            "Service": "ec2.amazonaws.com",
        },
    }],
}))
provider = aws.Provider("provider", assume_roles=[{
    "role_arn": base_role.arn,
}])

package main

import (
	"encoding/json"

	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/iam"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Version": "2012-10-17",
			"Statement": []map[string]interface{}{
				map[string]interface{}{
					"Action": "sts:AssumeRole",
					"Effect": "Allow",
					"Sid":    "",
					"Principal": map[string]interface{}{
						"Service": "ec2.amazonaws.com",
					},
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		baseRole, err := iam.NewRole(ctx, "baseRole", &iam.RoleArgs{
			AssumeRolePolicy: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		_, err = aws.NewProvider(ctx, "provider", &aws.ProviderArgs{
			AssumeRoles: aws.ProviderAssumeRoleArray{
				&aws.ProviderAssumeRoleArgs{
					RoleArn: baseRole.Arn,
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var baseRole = new Aws.Iam.Role("baseRole", new()
    {
        AssumeRolePolicy = JsonSerializer.Serialize(new Dictionary<string, object?>
        {
            ["Version"] = "2012-10-17",
            ["Statement"] = new[]
            {
                new Dictionary<string, object?>
                {
                    ["Action"] = "sts:AssumeRole",
                    ["Effect"] = "Allow",
                    ["Sid"] = "",
                    ["Principal"] = new Dictionary<string, object?>
                    {
                        ["Service"] = "ec2.amazonaws.com",
                    },
                },
            },
        }),
    });

    var provider = new Aws.Provider("provider", new()
    {
        AssumeRoles = new[]
        {
            new Aws.Inputs.ProviderAssumeRoleArgs
            {
                RoleArn = baseRole.Arn,
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iam.Role;
import com.pulumi.aws.iam.RoleArgs;
import com.pulumi.aws.Provider;
import com.pulumi.aws.ProviderArgs;
import com.pulumi.aws.inputs.ProviderAssumeRoleArgs;
import static com.pulumi.codegen.internal.Serialization.*;
import java.util.List;
import java.util.ArrayList;
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 baseRole = new Role("baseRole", RoleArgs.builder()
            .assumeRolePolicy(serializeJson(
                jsonObject(
                    jsonProperty("Version", "2012-10-17"),
                    jsonProperty("Statement", jsonArray(jsonObject(
                        jsonProperty("Action", "sts:AssumeRole"),
                        jsonProperty("Effect", "Allow"),
                        jsonProperty("Sid", ""),
                        jsonProperty("Principal", jsonObject(
                            jsonProperty("Service", "ec2.amazonaws.com")
                        ))
                    )))
                )))
            .build());

        var provider = new Provider("provider", ProviderArgs.builder()
            .assumeRoles(ProviderAssumeRoleArgs.builder()
                .roleArn(baseRole.arn())
                .build())
            .build());

    }
}

name: example
runtime: yaml
resources:
  baseRole:
    type: aws:iam:Role
    properties:
      assumeRolePolicy:
        fn::toJSON:
          Version: 2012-10-17
          Statement:
            - Action: sts:AssumeRole
              Effect: Allow
              Sid: ""
              Principal:
                Service: ec2.amazonaws.com
  provider:
    type: pulumi:providers:aws
    properties:
      assumeRoles:
        - roleArn: ${baseRole.arn}

S3 Bucket/BucketV2 Changes

In v6 of the Pulumi AWS Provider the s3.Bucket and s3.BucketV2 resources represent different resource implementations. s3.BucketV2 represents the latest version of the upstream Terraform resources, while s3.Bucket is a separate resource maintained by Pulumi to keep backwards compatibility with the v4 release of the upstream Terraform Provider.

In v7 we are taking the first step in unifying these two resources by moving the s3.Bucket resource to the latest upstream implementation. As a result, in v7 both s3.Bucket and s3.BucketV2 will represent the latest version of the upstream Terraform S3 Bucket resource. As part of this change, there are a couple of SDK level breaking changes to s3.Bucket.

The loggings input property has been renamed to logging and the type has changed from a list to a single object.
The website.routingRules now only accepts a string input property.

We have also introduced new Bucket configuration resources that are alternatives to their V2 counterparts. The V2 versions will be removed in v8 of the Pulumi AWS Provider.

aws.s3.BucketAccelerateConfigurationV2 => aws.s3.BucketAccelerateConfiguration
aws.s3.BucketRequestPaymentConfigurationV2 => aws.s3.BucketRequestPaymentConfiguration
aws.s3.BucketAclV2 => aws.s3.BucketAcl
aws.s3.BucketCorsConfigurationV2 => aws.s3.BucketCorsConfiguration
aws.s3.BucketLifecycleConfigurationV2 => aws.s3.BucketLifecycleConfiguration
aws.s3.BucketLoggingV2 => aws.s3.BucketLogging
aws.s3.BucketObjectLockConfigurationV2 => aws.s3.BucketObjectLockConfiguration
aws.s3.BucketServerSideEncryptionConfigurationV2 => aws.s3.BucketServerSideEncryptionConfiguration
aws.s3.BucketVersioningV2 => aws.s3.BucketVersioning
aws.s3.BucketWebsiteConfigurationV2 => aws.s3.BucketWebsiteConfiguration

Migration

In order to perform this migration first update your code to use the new resource or property names and then run pulumi with the --refresh and --run-program arguments. Make sure you have installed the latest version of the Pulumi CLI.

Fix any differences in property types (e.g. Bucket.loggings (array) to Bucket.logging (object))
Run pulumi up --refresh --run-program
Ensure there is no diff in the update. If there is, go back to step 1

You may see a refresh diff as Pulumi migrates the state to the new structure, but you should not see an update diff.

Example

Before (v6)

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

const provider = new aws.Provider("provider", {});
const loggingBucket = new aws.s3.Bucket("loggingBucket", {});
const migrationBucket = new aws.s3.Bucket("migrationBucket", {
    loggings: [{
        targetBucket: loggingBucket.bucket,
        targetPrefix: "/log",
    }],
    website: {
        indexDocument: "index.html",
        errorDocument: "error.html",
        routingRules: [{
          Condition: {
            KeyPrefixEquals: "docs"
          },
          Redirect: {
            ReplaceKeyPrefixWith: "documents/"
          }
        }],
    },
}, {
    provider: provider,
});

import pulumi
import pulumi_aws as aws

provider = aws.Provider("provider")
logging_bucket = aws.s3.Bucket("loggingBucket")
migration_bucket = aws.s3.Bucket("migrationBucket",
    loggings=[{
        "target_bucket": logging_bucket.bucket,
        "target_prefix": "/log",
    }],
    website={
        "index_document": "index.html",
        "error_document": "error.html",
        "routing_rules": """[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
""",
    },
    opts = pulumi.ResourceOptions(provider=provider))

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		provider, err := aws.NewProvider(ctx, "provider", nil)
		if err != nil {
			return err
		}
		loggingBucket, err := s3.NewBucket(ctx, "loggingBucket", nil)
		if err != nil {
			return err
		}
		_, err = s3.NewBucket(ctx, "migrationBucket", &s3.BucketArgs{
			Loggings: s3.BucketLoggingArray{
				&s3.BucketLoggingArgs{
					TargetBucket: loggingBucket.Bucket,
					TargetPrefix: pulumi.String("/log"),
				},
			},
			Website: &s3.BucketWebsiteArgs{
				IndexDocument: pulumi.String("index.html"),
				ErrorDocument: pulumi.String("error.html"),
				RoutingRules: pulumi.Any(`[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
`),
			},
		}, pulumi.Provider(provider))
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var provider = new Aws.Provider("provider");

    var loggingBucket = new Aws.S3.Bucket("loggingBucket");

    var migrationBucket = new Aws.S3.Bucket("migrationBucket", new()
    {
        Loggings = new[]
        {
            new Aws.S3.Inputs.BucketLoggingArgs
            {
                TargetBucket = loggingBucket.BucketName,
                TargetPrefix = "/log",
            },
        },
        Website = new Aws.S3.Inputs.BucketWebsiteArgs
        {
            IndexDocument = "index.html",
            ErrorDocument = "error.html",
            RoutingRules = @"[{
  ""Condition"": {
    ""KeyPrefixEquals"": ""docs""
  },
  ""Redirect"": {
    ""ReplaceKeyPrefixWith"": ""documents/""
  }
}]
",
        },
    }, new CustomResourceOptions
    {
        Provider = provider,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.Provider;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.aws.s3.inputs.BucketLoggingArgs;
import com.pulumi.aws.s3.inputs.BucketWebsiteArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
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 provider = new Provider("provider");

        var loggingBucket = new Bucket("loggingBucket");

        var migrationBucket = new Bucket("migrationBucket", BucketArgs.builder()
            .loggings(BucketLoggingArgs.builder()
                .targetBucket(loggingBucket.bucket())
                .targetPrefix("/log")
                .build())
            .website(BucketWebsiteArgs.builder()
                .indexDocument("index.html")
                .errorDocument("error.html")
                .routingRules("""
[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
                """)
                .build())
            .build(), CustomResourceOptions.builder()
                .provider(provider)
                .build());

    }
}

name: example
runtime: yaml
resources:
  provider:
    type: pulumi:providers:aws
  loggingBucket:
    type: aws:s3:Bucket
  migrationBucket:
    type: aws:s3:Bucket
    properties:
      loggings:
        - targetBucket: ${loggingBucket.bucket}
          targetPrefix: /log
      website:
        indexDocument: index.html
        errorDocument: error.html
        routingRules: |
          [{
            "Condition": {
              "KeyPrefixEquals": "docs"
            },
            "Redirect": {
              "ReplaceKeyPrefixWith": "documents/"
            }
          }]          
    options:
      provider: ${provider}

After (v7)

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

const provider = new aws.Provider("provider", {});
const loggingBucket = new aws.s3.Bucket("loggingBucket", {});
const migrationBucket = new aws.s3.Bucket("migrationBucket", {
    logging: {
        targetBucket: loggingBucket.bucket,
        targetPrefix: "/log",
    },
    website: {
        indexDocument: "index.html",
        errorDocument: "error.html",
        routingRules: `[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
`,
    },
}, {
    provider: provider,
});

import pulumi
import pulumi_aws as aws

provider = aws.Provider("provider")
logging_bucket = aws.s3.Bucket("loggingBucket")
migration_bucket = aws.s3.Bucket("migrationBucket",
    logging={
        "target_bucket": logging_bucket.bucket,
        "target_prefix": "/log",
    },
    website={
        "index_document": "index.html",
        "error_document": "error.html",
        "routing_rules": """[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
""",
    },
    opts = pulumi.ResourceOptions(provider=provider))

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		provider, err := aws.NewProvider(ctx, "provider", nil)
		if err != nil {
			return err
		}
		loggingBucket, err := s3.NewBucket(ctx, "loggingBucket", nil)
		if err != nil {
			return err
		}
		_, err = s3.NewBucket(ctx, "migrationBucket", &s3.BucketArgs{
			Logging: &s3.BucketLoggingTypeArgs{
				TargetBucket: loggingBucket.Bucket,
				TargetPrefix: pulumi.String("/log"),
			},
			Website: &s3.BucketWebsiteArgs{
				IndexDocument: pulumi.String("index.html"),
				ErrorDocument: pulumi.String("error.html"),
				RoutingRules: pulumi.String(`[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
`),
			},
		}, pulumi.Provider(provider))
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var provider = new Aws.Provider("provider");

    var loggingBucket = new Aws.S3.Bucket("loggingBucket");

    var migrationBucket = new Aws.S3.Bucket("migrationBucket", new()
    {
        Logging = new Aws.S3.Inputs.BucketLoggingArgs
        {
            TargetBucket = loggingBucket.BucketName,
            TargetPrefix = "/log",
        },
        Website = new Aws.S3.Inputs.BucketWebsiteArgs
        {
            IndexDocument = "index.html",
            ErrorDocument = "error.html",
            RoutingRules = @"[{
  ""Condition"": {
    ""KeyPrefixEquals"": ""docs""
  },
  ""Redirect"": {
    ""ReplaceKeyPrefixWith"": ""documents/""
  }
}]
",
        },
    }, new CustomResourceOptions
    {
        Provider = provider,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.Provider;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.aws.s3.inputs.BucketLoggingArgs;
import com.pulumi.aws.s3.inputs.BucketWebsiteArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
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 provider = new Provider("provider");

        var loggingBucket = new Bucket("loggingBucket");

        var migrationBucket = new Bucket("migrationBucket", BucketArgs.builder()
            .logging(BucketLoggingArgs.builder()
                .targetBucket(loggingBucket.bucket())
                .targetPrefix("/log")
                .build())
            .website(BucketWebsiteArgs.builder()
                .indexDocument("index.html")
                .errorDocument("error.html")
                .routingRules("""
[{
  "Condition": {
    "KeyPrefixEquals": "docs"
  },
  "Redirect": {
    "ReplaceKeyPrefixWith": "documents/"
  }
}]
                """)
                .build())
            .build(), CustomResourceOptions.builder()
                .provider(provider)
                .build());

    }
}

name: example
runtime: yaml
resources:
  provider:
    type: pulumi:providers:aws
  loggingBucket:
    type: aws:s3:Bucket
  migrationBucket:
    type: aws:s3:Bucket
    properties:
      logging:
        targetBucket: ${loggingBucket.bucket}
        targetPrefix: /log
      website:
        indexDocument: index.html
        errorDocument: error.html
        routingRules: |
          [{
            "Condition": {
              "KeyPrefixEquals": "docs"
            },
            "Redirect": {
              "ReplaceKeyPrefixWith": "documents/"
            }
          }]          
    options:
      provider: ${provider}

Tags Changes

This release some changes to the way tags work in the Pulumi AWS Provider. In v6 of the Pulumi AWS Provider we customized the tagging behavior of the provider through Pulumi level patches to the upstream Terraform provider along with other Pulumi level customizations. This resulted in tagging behavior that diverged from the upstream Terraform provider and has been difficult to maintain as the upstream Terraform provider has made changes to tagging.

In v7 we are removing the Pulumi level customizations and going back to relying on the upstream provider’s tagging behavior. This should only impact you if you were previously using the tags property of a resource to get all the tags on the resource. In v7 you will need to use the tagsAll property.

Before (v6)

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

const provider = new aws.Provider("provider", {defaultTags: {
    tags: {
        globalTag: "value",
    },
}});
const bucket = new aws.s3.Bucket("bucket", {tags: {
    resourceTag: "value",
}}, {
    provider: provider,
});
export const tags = bucket.tags;

import pulumi
import pulumi_aws as aws

provider = aws.Provider("provider", default_tags={
    "tags": {
        "globalTag": "value",
    },
})
bucket = aws.s3.Bucket("bucket", tags={
    "resourceTag": "value",
},
opts = pulumi.ResourceOptions(provider=provider))
pulumi.export("tags", bucket.tags)

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		provider, err := aws.NewProvider(ctx, "provider", &aws.ProviderArgs{
			DefaultTags: &aws.ProviderDefaultTagsArgs{
				Tags: pulumi.StringMap{
					"globalTag": pulumi.String("value"),
				},
			},
		})
		if err != nil {
			return err
		}
		bucket, err := s3.NewBucket(ctx, "bucket", &s3.BucketArgs{
			Tags: pulumi.StringMap{
				"resourceTag": pulumi.String("value"),
			},
		}, pulumi.Provider(provider))
		if err != nil {
			return err
		}
		ctx.Export("tags", bucket.Tags)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var provider = new Aws.Provider("provider", new()
    {
        DefaultTags = new Aws.Inputs.ProviderDefaultTagsArgs
        {
            Tags = 
            {
                { "globalTag", "value" },
            },
        },
    });

    var bucket = new Aws.S3.Bucket("bucket", new()
    {
        Tags = 
        {
            { "resourceTag", "value" },
        },
    }, new CustomResourceOptions
    {
        Provider = provider,
    });

    return new Dictionary<string, object?>
    {
        ["tags"] = bucket.Tags,
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.Provider;
import com.pulumi.aws.ProviderArgs;
import com.pulumi.aws.inputs.ProviderDefaultTagsArgs;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
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 provider = new Provider("provider", ProviderArgs.builder()
            .defaultTags(ProviderDefaultTagsArgs.builder()
                .tags(Map.of("globalTag", "value"))
                .build())
            .build());

        var bucket = new Bucket("bucket", BucketArgs.builder()
            .tags(Map.of("resourceTag", "value"))
            .build(), CustomResourceOptions.builder()
                .provider(provider)
                .build());

        ctx.export("tags", bucket.tags());
    }
}

name: example
runtime: yaml
resources:
  provider:
    type: pulumi:providers:aws
    properties:
      defaultTags:
        tags:
          globalTag: value
  bucket:
    type: aws:s3:Bucket
    properties:
      tags:
        resourceTag: value
    options:
      provider: ${provider}
outputs:
  tags: ${bucket.tags}

After (v7)

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

const provider = new aws.Provider("provider", {defaultTags: {
    tags: {
        globalTag: "value",
    },
}});
const bucket = new aws.s3.Bucket("bucket", {}, {
    provider: provider,
});
export const tags = bucket.tags;
export const allTags = bucket.tagsAll;

import pulumi
import pulumi_aws as aws

provider = aws.Provider("provider", default_tags={
    "tags": {
        "globalTag": "value",
    },
})
bucket = aws.s3.Bucket("bucket", opts = pulumi.ResourceOptions(provider=provider))
pulumi.export("tags", bucket.tags)
pulumi.export("allTags", bucket.tags_all)

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		provider, err := aws.NewProvider(ctx, "provider", &aws.ProviderArgs{
			DefaultTags: &aws.ProviderDefaultTagsArgs{
				Tags: pulumi.StringMap{
					"globalTag": pulumi.String("value"),
				},
			},
		})
		if err != nil {
			return err
		}
		bucket, err := s3.NewBucket(ctx, "bucket", nil, pulumi.Provider(provider))
		if err != nil {
			return err
		}
		ctx.Export("tags", bucket.Tags)
		ctx.Export("allTags", bucket.TagsAll)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var provider = new Aws.Provider("provider", new()
    {
        DefaultTags = new Aws.Inputs.ProviderDefaultTagsArgs
        {
            Tags = 
            {
                { "globalTag", "value" },
            },
        },
    });

    var bucket = new Aws.S3.Bucket("bucket", new()
    {
    }, new CustomResourceOptions
    {
        Provider = provider,
    });

    return new Dictionary<string, object?>
    {
        ["tags"] = bucket.Tags,
        ["allTags"] = bucket.TagsAll,
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.Provider;
import com.pulumi.aws.ProviderArgs;
import com.pulumi.aws.inputs.ProviderDefaultTagsArgs;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
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 provider = new Provider("provider", ProviderArgs.builder()
            .defaultTags(ProviderDefaultTagsArgs.builder()
                .tags(Map.of("globalTag", "value"))
                .build())
            .build());

        var bucket = new Bucket("bucket", BucketArgs.Empty, CustomResourceOptions.builder()
            .provider(provider)
            .build());

        ctx.export("tags", bucket.tags());
        ctx.export("allTags", bucket.tagsAll());
    }
}

name: example
runtime: yaml
resources:
  provider:
    type: pulumi:providers:aws
    properties:
      defaultTags:
        tags:
          globalTag: value
  bucket:
    type: aws:s3:Bucket
    options:
      provider: ${provider}
outputs:
  tags: ${bucket.tags}
  allTags: ${bucket.tagsAll}

We previously had Pulumi level patches to the upstream Terraform provider to address issues/limitations that existed in the upstream provider. Several of those issues/limitations have now been addressed in the upstream Terraform provider and we are removing the Pulumi level patch. Users will need to migrate their code to use the new features.

Resource `aws.eks.Cluster`

We are removing the defaultAddonsToRemoves property. This property does not exist in the upstream terraform-provider-aws provider and was added to workaround some limitations. Since then the upstream provider has added the bootstrapSelfManagedAddons field which can be used instead.

Users can replicate the behavior of defaultAddonsToRemoves by setting bootstrapSelfManagedAddons to false and then adding platform addons that they actually want as aws.eks.Addon resources.

Function `aws.ecr.getCredentials`

The ecr.getCredentials function was added to address a functionality that did not exist in the upstream provider. The upstream Terraform provider now has a aws.ecr.getAuthorizationToken function that should be used instead.

Before (v6)

const credentials = await aws.ecr.getCredentials({ registryId: registryId });
const decodedCredentials = Buffer.from(credentials.authorizationToken, "base64").toString();
const [username, password] = decodedCredentials.split(":");
if (!password || !username) {
    throw new Error("Invalid credentials");
}

After (v7)

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

const registry = new aws.ecr.Repository("registry", {});
const credentials = aws.ecr.getAuthorizationTokenOutput({
    registryId: registry.id,
});
const username = credentials.apply(credentials => credentials.userName);
const password = pulumi.secret(credentials.apply(credentials => credentials.password));

import pulumi
import pulumi_aws as aws

registry = aws.ecr.Repository("registry")
credentials = aws.ecr.get_authorization_token_output(registry_id=registry.id)
username = credentials.user_name
password = pulumi.Output.secret(credentials.password)

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecr"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		registry, err := ecr.NewRepository(ctx, "registry", nil)
		if err != nil {
			return err
		}
		credentials := ecr.GetAuthorizationTokenOutput(ctx, ecr.GetAuthorizationTokenOutputArgs{
			RegistryId: registry.ID(),
		}, nil)
		_ = credentials.ApplyT(func(credentials ecr.GetAuthorizationTokenResult) (*string, error) {
			return &credentials.UserName, nil
		}).(pulumi.StringPtrOutput)
		_ = pulumi.ToSecret(credentials.ApplyT(func(credentials ecr.GetAuthorizationTokenResult) (*string, error) {
			return &credentials.Password, nil
		}).(pulumi.StringPtrOutput)).(pulumi.StringOutput)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var registry = new Aws.Ecr.Repository("registry");

    var credentials = Aws.Ecr.GetAuthorizationToken.Invoke(new()
    {
        RegistryId = registry.Id,
    });

    var username = credentials.Apply(getAuthorizationTokenResult => getAuthorizationTokenResult.UserName);

    var password = Output.CreateSecret(credentials.Apply(getAuthorizationTokenResult => getAuthorizationTokenResult.Password));

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.EcrFunctions;
import com.pulumi.aws.ecr.inputs.GetAuthorizationTokenArgs;
import java.util.List;
import java.util.ArrayList;
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 registry = new Repository("registry");

        final var credentials = EcrFunctions.getAuthorizationToken(GetAuthorizationTokenArgs.builder()
            .registryId(registry.id())
            .build());

        final var username = credentials.applyValue(_credentials -> _credentials.userName());

        final var password = Output.ofSecret(credentials.applyValue(_credentials -> _credentials.password()));

    }
}

name: example
runtime: yaml
resources:
  registry:
    type: aws:ecr:Repository
variables:
  credentials:
    fn::invoke:
      function: aws:ecr:getAuthorizationToken
      arguments:
        registryId: ${registry.id}
  username: ${credentials.userName}
  password:
    fn::secret: ${credentials.password}

Amazon Elastic Transcoder Deprecation

Amazon Elastic Transcoder will be discontinued on November 13, 2025.

The following resources are deprecated and will be removed in a future major release:

aws.elastictranscoder.Pipeline
aws.elastictranscoder.Preset

Use AWS Elemental MediaConvert instead.

CloudWatch Evidently Deprecation

AWS will end support for CloudWatch Evidently on October 17, 2025.

The following resources are deprecated and will be removed in a future major release:

aws.evidently.Feature
aws.evidently.Launch
aws.evidently.Project
aws.evidently.Segment

Migrate to AWS AppConfig Feature Flags.

OpsWorks Stacks Removal

The AWS OpsWorks Stacks service has reached End of Life. The following resources have been removed:

aws.opsworks.Application
aws.opsworks.CustomLayer
aws.opsworks.EcsClusterLayer
aws.opsworks.GangliaLayer
aws.opsworks.HaproxyLayer
aws.opsworks.Instance
aws.opsworks.JavaAppLayer
aws.opsworks.MemcachedLayer
aws.opsworks.MysqlLayer
aws.opsworks.NodejsAppLayer
aws.opsworks.Permission
aws.opsworks.PhpAppLayer
aws.opsworks.RailsAppLayer
aws.opsworks.RdsDbInstance
aws.opsworks.Stack
aws.opsworks.StaticWebLayer
aws.opsworks.UserProfile

SimpleDB Support Removed

The aws.simpledb.Domain resource has been removed, as the AWS SDK for Go v2 no longer supports Amazon SimpleDB.

Worklink Support Removed

The following resources have been removed due to dropped support for Amazon Worklink in the AWS SDK for Go v2:

aws.worklink.Fleet
aws.worklink.WebsiteCertificateAuthorityAssociation

S3 Global Endpoint Deprecation

Support for the global S3 endpoint is deprecated. This affects S3 resources in us-east-1 (excluding directory buckets) when s3UsEast1RegionalEndpoint is set to legacy.

s3UsEast1RegionalEndpoint will be removed in v8.0.0.

To prepare:

Remove s3UsEast1RegionalEndpoint from your provider configuration, or
Set its value to regional and verify functionality.

Function `aws.ec2.getAmi`

When using mostRecent = true, your configuration must now include an owner or a filter that identifies the image by image-id or owner-id.

Before (v6 and earlier): Pulumi allowed this setup and showed only a warning.
Now (v7+): Pulumi will stop with an error to prevent unsafe or ambiguous AMI lookups.

How to fix it

Do one of the following:

Add owner:

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

const ami = aws.ec2.getAmiOutput({
    mostRecent: true,
    owners: ["amazon"],
});

import pulumi
import pulumi_aws as aws

ami = aws.ec2.get_ami_output(most_recent=True,
    owners=["amazon"])

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_ = ec2.LookupAmiOutput(ctx, ec2.GetAmiOutputArgs{
			MostRecent: pulumi.Bool(true),
			Owners: pulumi.StringArray{
				pulumi.String("amazon"),
			},
		}, nil)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var ami = Aws.Ec2.GetAmi.Invoke(new()
    {
        MostRecent = true,
        Owners = new[]
        {
            "amazon",
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetAmiArgs;
import java.util.List;
import java.util.ArrayList;
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) {
        final var ami = Ec2Functions.getAmi(GetAmiArgs.builder()
            .mostRecent(true)
            .owners("amazon")
            .build());

    }
}

name: example
runtime: yaml
variables:
  ami:
    fn::invoke:
      function: aws:ec2:getAmi
      arguments:
        mostRecent: true
        owners: ["amazon"]

Or add a filter block that includes either image-id or owner-id:

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

const ami = aws.ec2.getAmiOutput({
    mostRecent: true,
    filters: [{
        name: "owner-id",
        values: ["123456789012"],
    }],
});

import pulumi
import pulumi_aws as aws

ami = aws.ec2.get_ami_output(most_recent=True,
    filters=[{
        "name": "owner-id",
        "values": ["123456789012"],
    }])

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_ = ec2.LookupAmiOutput(ctx, ec2.GetAmiOutputArgs{
			MostRecent: pulumi.Bool(true),
			Filters: ec2.GetAmiFilterArray{
				&ec2.GetAmiFilterArgs{
					Name: pulumi.String("owner-id"),
					Values: pulumi.StringArray{
						pulumi.String("123456789012"),
					},
				},
			},
		}, nil)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var ami = Aws.Ec2.GetAmi.Invoke(new()
    {
        MostRecent = true,
        Filters = new[]
        {
            new Aws.Ec2.Inputs.GetAmiFilterInputArgs
            {
                Name = "owner-id",
                Values = new[]
                {
                    "123456789012",
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetAmiArgs;
import java.util.List;
import java.util.ArrayList;
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) {
        final var ami = Ec2Functions.getAmi(GetAmiArgs.builder()
            .mostRecent(true)
            .filters(GetAmiFilterArgs.builder()
                .name("owner-id")
                .values("123456789012")
                .build())
            .build());

    }
}

runtime: yaml
name: example
variables:
  ami:
    fn::invoke:
      function: aws:ec2:getAmi
      arguments:
        mostRecent: true
        filters:
          - name: owner-id
            values:
              - "123456789012"

Unsafe option (not recommended)

To override this check, you can set:

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

const ami = aws.ec2.getAmiOutput({
    allowUnsafeFilter: true,
});

import pulumi
import pulumi_aws as aws

ami = aws.ec2.get_ami_output(allow_unsafe_filter=True)

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_ = ec2.LookupAmiOutput(ctx, ec2.GetAmiOutputArgs{
			AllowUnsafeFilter: pulumi.Bool(true),
		}, nil)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var ami = Aws.Ec2.GetAmi.Invoke(new()
    {
        AllowUnsafeFilter = true,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetAmiArgs;
import java.util.List;
import java.util.ArrayList;
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) {
        final var ami = Ec2Functions.getAmi(GetAmiArgs.builder()
            .allowUnsafeFilter(true)
            .build());

    }
}

runtime: yaml
name: example
variables:
  ami:
    fn::invoke:
      function: aws:ec2:getAmi
      arguments:
        allowUnsafeFilter: true

However, this may lead to unreliable results and should be avoided unless absolutely necessary.

Function `aws.batch.getComputeEnvironment`

computeEnvironmentName has been renamed to name.

Update your configurations to replace any usage of computeEnvironmentName with name to use this version.

Function `aws.ecs.getTaskDefinition`

Remove inferenceAccelerator—it is no longer supported. Amazon Elastic Inference reached end of life in April 2024.

Function `aws.ecs.getTaskExecution`

Remove inferenceAcceleratorOverrides—it is no longer supported. Amazon Elastic Inference reached end of life in April 2024.

Function `aws.elbv2.getListenerRule`

Treat the following as lists of objects instead of objects:

action.authenticateCognito
action.authenticateOidc
action.fixedResponse
action.forward
action.forward.stickiness
action.redirect
condition.hostHeader
condition.httpHeader
condition.httpRequest_method
condition.pathPattern
condition.queryString
condition.sourceIp

The function configuration itself does not change. However, now, include an index when referencing them. For example, update action[0].authenticateCognito.scope to action[0].authenticateCognito[0].scope.

Function `aws.globalaccelerator.getAccelerator`

id is now output only and can no longer be set manually. If your configuration explicitly attempts to set a value for id, you must remove it to avoid an error.

Function `aws.identitystore.getGroup`

Remove filter—it is no longer supported. To locate a group, update your configuration to use alternateIdentifier instead.

Function `aws.identitystore.getUser`

Remove filter—it is no longer supported. To locate a user, update your configuration to use alternateIdentifier instead.

Function `aws.kms.getSecret`

The functionality for this function was removed in v3.0.0 and the data source will be removed in a future version.

Function `aws.launch.getTemplate`

Remove the following—they are no longer supported:

elasticGpuSpecifications: Amazon Elastic Graphics reached end of life in January 2024.
elasticInferenceAccelerator: Amazon Elastic Inference reached end of life in April 2024.

Function `aws.opensearch.getDomain`

Remove kibanaEndpoint—it is no longer supported. AWS OpenSearch Service no longer uses Kibana endpoints. The service now uses Dashboards, accessible at the /_dashboards/ path on the domain endpoint. For more details, refer to the AWS OpenSearch Dashboards documentation.

Function `aws.opensearchserverless.getSecurityConfig`

Treat samlOptions as a list of nested objects instead of an object. The function configuration itself does not change. However, now, include an index when referencing it. For example, update samlOptions.sessionTimeout to samlOptions[0].sessionTimeout.

Function `aws.quicksight.getDataSet`

Remove tagsAll—it is no longer supported.

Function `aws.getRegion`

name has been deprecated. Use region instead.

Function `aws.s3.getBucket`

bucketRegion has been added and should be used instead of region, which is now used for Enhanced Region Support.

Function `aws.service.getDiscoveryService`

Remove tagsAll—it is no longer supported.

Function `aws.servicequotas.getTemplates`

region has been deprecated. Use awsRegion instead.

Function `aws.ssmincidents.getReplicationSet`

region has been deprecated. Use regions instead.

Function `aws.vpc.getEndpointService`

region has been deprecated. Use serviceRegion instead.

Function `aws.vpc.getPeeringConnection`

region has been deprecated. Use requesterRegion instead.

Resource `aws.apigateway.Account`

Remove resetOnDelete—it is no longer supported. The destroy operation will now always reset the API Gateway account settings by default.

If you want to retain the previous behavior (where the account settings were not changed upon destruction), use the retainOnDelete resource option.

Resource `aws.apigateway.Deployment`

Use the aws.apigateway.Stage resource if your configuration uses any of the following, which have been removed from the aws.apigateway.Deployment resource:
- stageName
- stageDescription
- canarySettings
invokeUrl and executionArn from aws.apigateway.Deployment have been removed—they are no longer supported. Use the invokeUrl and executionArn from the aws.apigateway.Stage resource instead.

Migration Example

Before (v6 and earlier, using implicit stage):

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

const exampleDeployment = new aws.apigateway.Deployment("exampleDeployment", {
    restApi: exampleRestApi.id,
    stageName: "prod",
});
export const invokeUrl = exampleDeployment.invokeUrl;
export const executionArn = exampleDeployment.executionArn;

import pulumi
import pulumi_aws as aws

example_deployment = aws.apigateway.Deployment("exampleDeployment",
    rest_api=example_rest_api["id"],
    stage_name="prod")
pulumi.export("invokeUrl", example_deployment.invoke_url)
pulumi.export("executionArn", example_deployment.execution_arn)

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/apigateway"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleDeployment, err := apigateway.NewDeployment(ctx, "exampleDeployment", &apigateway.DeploymentArgs{
			RestApi:   pulumi.Any(exampleRestApi.Id),
			StageName: pulumi.String("prod"),
		})
		if err != nil {
			return err
		}
		ctx.Export("invokeUrl", exampleDeployment.InvokeUrl)
		ctx.Export("executionArn", exampleDeployment.ExecutionArn)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleDeployment = new Aws.ApiGateway.Deployment("exampleDeployment", new()
    {
        RestApi = exampleRestApi.Id,
        StageName = "prod",
    });

    return new Dictionary<string, object?>
    {
        ["invokeUrl"] = exampleDeployment.InvokeUrl,
        ["executionArn"] = exampleDeployment.ExecutionArn,
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.apigateway.Deployment;
import com.pulumi.aws.apigateway.DeploymentArgs;
import java.util.List;
import java.util.ArrayList;
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 exampleDeployment = new Deployment("exampleDeployment", DeploymentArgs.builder()
            .restApi(exampleRestApi.id())
            .stageName("prod")
            .build());

        ctx.export("invokeUrl", exampleDeployment.invokeUrl());
        ctx.export("executionArn", exampleDeployment.executionArn());
    }
}

name: example
runtime: yaml
resources:
  exampleDeployment:
    type: aws:apigateway:Deployment
    properties:
      restApi: ${exampleRestApi.id}
      stageName: prod
outputs:
  invokeUrl: ${exampleDeployment.invokeUrl}
  executionArn: ${exampleDeployment.executionArn}

After (v7+, using explicit stage):

If your previous configuration relied on an implicitly created stage, you must now define and manage that stage explicitly using the aws.apigateway.Stage resource. Create a corresponding resource and import the existing stage into your configuration.

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

const exampleDeployment = new aws.apigateway.Deployment("exampleDeployment", {restApi: exampleRestApi.id});
const prodStage = new aws.apigateway.Stage("prodStage", {
    stageName: "prod",
    restApi: exampleRestApi.id,
    deployment: exampleDeployment.id,
});
export const invokeUrl = prodStage.invokeUrl;
export const executionArn = prodStage.executionArn;

import pulumi
import pulumi_aws as aws

example_deployment = aws.apigateway.Deployment("exampleDeployment", rest_api=example_rest_api["id"])
prod_stage = aws.apigateway.Stage("prodStage",
    stage_name="prod",
    rest_api=example_rest_api["id"],
    deployment=example_deployment.id)
pulumi.export("invokeUrl", prod_stage.invoke_url)
pulumi.export("executionArn", prod_stage.execution_arn)

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleDeployment, err := apigateway.NewDeployment(ctx, "exampleDeployment", &apigateway.DeploymentArgs{
			RestApi: pulumi.Any(exampleRestApi.Id),
		})
		if err != nil {
			return err
		}
		prodStage, err := apigateway.NewStage(ctx, "prodStage", &apigateway.StageArgs{
			StageName:  pulumi.String("prod"),
			RestApi:    pulumi.Any(exampleRestApi.Id),
			Deployment: exampleDeployment.ID(),
		})
		if err != nil {
			return err
		}
		ctx.Export("invokeUrl", prodStage.InvokeUrl)
		ctx.Export("executionArn", prodStage.ExecutionArn)
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleDeployment = new Aws.ApiGateway.Deployment("exampleDeployment", new()
    {
        RestApi = exampleRestApi.Id,
    });

    var prodStage = new Aws.ApiGateway.Stage("prodStage", new()
    {
        StageName = "prod",
        RestApi = exampleRestApi.Id,
        Deployment = exampleDeployment.Id,
    });

    return new Dictionary<string, object?>
    {
        ["invokeUrl"] = prodStage.InvokeUrl,
        ["executionArn"] = prodStage.ExecutionArn,
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.apigateway.Deployment;
import com.pulumi.aws.apigateway.DeploymentArgs;
import com.pulumi.aws.apigateway.Stage;
import com.pulumi.aws.apigateway.StageArgs;
import java.util.List;
import java.util.ArrayList;
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 exampleDeployment = new Deployment("exampleDeployment", DeploymentArgs.builder()
            .restApi(exampleRestApi.id())
            .build());

        var prodStage = new Stage("prodStage", StageArgs.builder()
            .stageName("prod")
            .restApi(exampleRestApi.id())
            .deployment(exampleDeployment.id())
            .build());

        ctx.export("invokeUrl", prodStage.invokeUrl());
        ctx.export("executionArn", prodStage.executionArn());
    }
}

name: example
runtime: yaml
resources:
  exampleDeployment:
    type: aws:apigateway:Deployment
    properties:
      restApi: ${exampleRestApi.id}
  prodStage:
    type: aws:apigateway:Stage
    properties:
      stageName: prod
      restApi: ${exampleRestApi.id}
      deployment: ${exampleDeployment.id}
outputs:
  invokeUrl: ${prodStage.invokeUrl}
  executionArn: ${prodStage.executionArn}

Import the existing stage:

Replace restApi and stageName with your actual values:

pulumi import aws:apigateway/stage:Stage prod restApi/stageName

Resource `aws.appflow.ConnectorProfile`

Importing an aws.appflow.ConnectorProfile resource now uses the name of the Connector Profile.

Resource `aws.appflow.Flow`

Importing an aws.appflow.Flow resource now uses the name of the Flow.

Resource `aws.batch.ComputeEnvironment`

Replace any usage of computeEnvironmentName with name and computeEnvironmentNamePrefix with namePrefix as they have been renamed.

Resource `aws.batch.JobQueue`

Remove computeEnvironments—it is no longer supported. Use computeEnvironmentOrders property instead. While you must update your configuration, Pulumi will upgrade states with computeEnvironments to computeEnvironmentOrders.

Before (v6 and earlier):

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

const example = new aws.batch.JobQueue("example", {
    computeEnvironments: [exampleComputeEnvironment.arn],
    name: "patagonia",
    priority: 1,
    state: "ENABLED",
});

import pulumi
import pulumi_aws as aws

example = aws.batch.JobQueue("example",
    compute_environments=[example_compute_environment["arn"]],
    name="patagonia",
    priority=1,
    state="ENABLED")

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/batch"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := batch.NewJobQueue(ctx, "example", &batch.JobQueueArgs{
			ComputeEnvironments: pulumi.StringArray{
				exampleComputeEnvironment.Arn,
			},
			Name:     pulumi.String("patagonia"),
			Priority: pulumi.Int(1),
			State:    pulumi.String("ENABLED"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Batch.JobQueue("example", new()
    {
        ComputeEnvironments = new[]
        {
            exampleComputeEnvironment.Arn,
        },
        Name = "patagonia",
        Priority = 1,
        State = "ENABLED",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.batch.JobQueue;
import com.pulumi.aws.batch.JobQueueArgs;
import java.util.List;
import java.util.ArrayList;
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 JobQueue("example", JobQueueArgs.builder()
            .computeEnvironments(exampleComputeEnvironment.arn())
            .name("patagonia")
            .priority(1)
            .state("ENABLED")
            .build());

    }
}

name: example
runtime: yaml
resources:
  example:
    type: aws:batch:JobQueue
    properties:
      computeEnvironments: 
        - ${exampleComputeEnvironment.arn}
      name: patagonia
      priority: 1
      state: ENABLED

After (v7+):

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

const example = new aws.batch.JobQueue("example", {
    computeEnvironmentOrders: [{
        computeEnvironment: exampleComputeEnvironment.arn,
        order: 0,
    }],
    name: "patagonia",
    priority: 1,
    state: "ENABLED",
});

import pulumi
import pulumi_aws as aws

example = aws.batch.JobQueue("example",
    compute_environment_orders=[{
        "compute_environment": example_compute_environment["arn"],
        "order": 0,
    }],
    name="patagonia",
    priority=1,
    state="ENABLED")

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := batch.NewJobQueue(ctx, "example", &batch.JobQueueArgs{
			ComputeEnvironmentOrders: batch.JobQueueComputeEnvironmentOrderArray{
				&batch.JobQueueComputeEnvironmentOrderArgs{
					ComputeEnvironment: pulumi.Any(exampleComputeEnvironment.Arn),
					Order:              pulumi.Int(0),
				},
			},
			Name:     pulumi.String("patagonia"),
			Priority: pulumi.Int(1),
			State:    pulumi.String("ENABLED"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Batch.JobQueue("example", new()
    {
        ComputeEnvironmentOrders = new[]
        {
            new Aws.Batch.Inputs.JobQueueComputeEnvironmentOrderArgs
            {
                ComputeEnvironment = exampleComputeEnvironment.Arn,
                Order = 0,
            },
        },
        Name = "patagonia",
        Priority = 1,
        State = "ENABLED",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.batch.JobQueue;
import com.pulumi.aws.batch.JobQueueArgs;
import com.pulumi.aws.batch.inputs.JobQueueComputeEnvironmentOrderArgs;
import java.util.List;
import java.util.ArrayList;
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 JobQueue("example", JobQueueArgs.builder()
            .computeEnvironmentOrders(JobQueueComputeEnvironmentOrderArgs.builder()
                .computeEnvironment(exampleComputeEnvironment.arn())
                .order(0)
                .build())
            .name("patagonia")
            .priority(1)
            .state("ENABLED")
            .build());

    }
}

name: example
runtime: yaml
resources:
  example:
    type: aws:batch:JobQueue
    properties:
      computeEnvironmentOrders:
        - computeEnvironment: ${exampleComputeEnvironment.arn}
          order: 0
      name: patagonia
      priority: 1
      state: ENABLED

Resource `aws.bedrockmodel.InvocationLoggingConfiguration`

Treat the following as lists of object instead of an object:

loggingConfig
loggingConfig.cloudwatchConfig
loggingConfig.cloudwatchConfig.largeDataDeliveryS3Config
loggingConfig.s3Config

The resource configuration itself does not change, but you must now include an index when referencing them. For example, update loggingConfig.cloudwatchConfig.logGroup_name to loggingConfig[0].cloudwatchConfig[0].logGroupName.

Resource `aws.cloudformation.StackSetInstance`

region has been deprecated. Use stackSetInstanceRegion instead.

Resource `aws.cloudfront.KeyValueStore`

Use name to reference the resource name. id represents the ID value returned by the AWS API.

Resource `aws.cloudfront.ResponseHeadersPolicy`

Do not set a value for etag as it is now computed only.

Resource `aws.cognito.UserInGroup`

For the id, use a comma-delimited string concatenating userPoolId, groupName, and username. For example, in an import command, use comma-delimiting for the composite id.

Resource `aws.cfg.AggregateAuthorization`

region has been deprecated. Use authorizedAwsRegion instead.

Resource `aws.rds.Instance`

Do not use characterSetName with replicateSourceDb, restoreToPointInTime, s3Import, or snapshotIdentifier. The combination is no longer valid.

name was deprecated in v6 and has been removed in v7. Use dbName instead.

Resource `aws.dms.Endpoint`

s3Settings has been removed. Use the aws.dms.S3Endpoint resource rather than s3Settings of aws.dms.Endpoint.

Resource `aws.directconnect.GatewayAssociation`

Remove vpnGatewayId—it is no longer supported. Use associatedGatewayId instead.

Resource `aws.directconnect.HostedConnection`

region has been deprecated. Use connectionRegion instead.

Resource `aws.ecs.TaskDefinition`

Remove inferenceAccelerator—it is no longer supported. Amazon Elastic Inference reached end of life in April 2024.

Resource `aws.ec2.Eip`

Remove vpc—it is no longer supported. Use domain instead.

Resource `aws.eks.Addon`

Remove resolveConflicts—it is no longer supported. Use resolveConflictsOnCreate and resolveConflictsOnUpdate instead.

Resource `aws.eks.Cluster`

certificateAuthority is no longer supported. Use certificateAuthorities instead.

Resource `aws.elasticache.ReplicationGroup`

authTokenUpdateStrategy no longer has a default value. If authToken is set, it must also be explicitly configured.
The ability to provide an uppercase engine value is deprecated. In v7.0.0, plan-time validation of engine will require an entirely lowercase value to match the returned value from the AWS API without diff suppression.

Resource `aws.elasticache.User`

The ability to provide an uppercase engine value is deprecated. In v7.0.0, plan-time validation of engine will require an entirely lowercase value to match the returned value from the AWS API without diff suppression.

Resource `aws.elasticache.UserGroup`

Resource `aws.ec2.FlowLog`

Remove logGroupName—it is no longer supported. Use logDestination instead.

Resource `aws.guardduty.Detector`

datasources is deprecated. Use the awsGuarddutyDetectorFeature resource instead.

Resource `aws.guardduty.OrganizationConfiguration`

Remove autoEnable—it is no longer supported.
autoEnableOrganizationMembers is now required.
datasources is deprecated.

Resource `aws.ec2.Instance`

userData no longer applies hashing and is now stored in clear text. Do not include passwords or sensitive information in userData, as it will be visible in plaintext. Follow AWS Best Practices to secure your instance metadata. If you need to provide base64-encoded user data, use userDataBase64 instead.
Remove cpuCoreCount and cpuThreadsPerCore—they are no longer supported. Instead, use the cpuOptions configuration block with coreCount and threadsPerCore.

Resource `aws.kinesis.AnalyticsApplication`

This resource is deprecated and will be removed in a future version. Effective January 27, 2026, AWS will no longer support Amazon Kinesis Data Analytics for SQL. Use the aws.kinesisanalyticsv2.Application resource instead to manage Amazon Kinesis Data Analytics for Apache Flink applications. AWS provides guidance for migrating from Amazon Kinesis Data Analytics for SQL Applications to Amazon Managed Service for Apache Flink Studio including examples.

Resource `aws.ec2.LaunchTemplate`

Remove elasticGpuSpecifications—it is no longer supported. Amazon Elastic Graphics reached end of life in January 2024.
Remove elasticInferenceAccelerator—it is no longer supported. Amazon Elastic Inference reached end of life in April 2024.

Resource `aws.lb.Listener`

For mutualAuthentication, advertiseTrustStoreCaNames, ignoreClientCertificateExpiry, and trustStoreArn can now only be set when mode is verify.
trustStoreArn is required when mode is verify.

Resource `aws.mediastore.Container`

This resource is deprecated and will be removed in a future version. AWS has announced the discontinuation of AWS Elemental MediaStore, effective November 13, 2025. Users should begin transitioning to alternative solutions as soon as possible. For simple live streaming workflows, AWS recommends migrating to Amazon S3. For advanced use cases that require features such as packaging, DRM, or cross-region redundancy, consider using AWS Elemental MediaPackage.

Resource `aws.mediastore.ContainerPolicy`

Resource `aws.networkmanager.CoreNetwork`

Remove basePolicyRegion—it is no longer supported. Use basePolicyRegions instead.

Resource `aws.opensearch.Domain`

Remove kibanaEndpoint—it is no longer supported. AWS OpenSearch Service does not use Kibana endpoints (i.e., _plugin/kibana). Instead, OpenSearch uses Dashboards, accessible at the path /_dashboards/ on the domain endpoint. The terminology has shifted from “Kibana” to “Dashboards.”

For more information, see the AWS OpenSearch Dashboards documentation.

Resource `aws.opensearch.ServerlessSecurityConfig`

Treat samlOptions as a list of nested blocks instead of a single-nested block. The resource configuration itself does not change. However, now, include an index when referencing it. For example, update samlOptions.sessionTimeout to samlOptions[0].sessionTimeout.

Resource `aws.paymentcryptography.Key`

Treat the keyAttributes and keyAttributes.keyModesOfUse as lists of nested blocks instead of single-nested blocks. The resource configuration itself does not change. However, now, include an index when referencing them. For example, update keyAttributes.keyModesOfUse.decrypt to keyAttributes[0].keyModesOfUse[0].decrypt.

Resource `aws.redshift.Cluster`

encrypted now defaults to true.
publiclyAccessible now defaults to false.
Remove snapshotCopy—it is no longer supported. Use the awsRedshiftSnapshotCopy resource instead.
Remove logging—it is no longer supported. Use the awsRedshiftLogging resource instead.
clusterPublicKey, clusterRevisionNumber, and endpoint are now read only and should not be set.

Resource `aws.redshift.ServiceAccount`

The aws.Redshift.ServiceAccount resource has been removed. AWS recommends that a service principal name should be used instead of an AWS account ID in any relevant IAM policy.

Resource `aws.rekognition.StreamProcessor`

Treat regionsOfInterest.boundingBox as a list of nested blocks instead of a single-nested block. The resource configuration itself does not change. However, now, include an index when referencing it. For example, update regionsOfInterest[0].boundingBox.height to regionsOfInterest[0].boundingBox[0].height.

Resource `aws.resiliencehub.ResiliencyPolicy`

Treat the following as lists of objects instead of an object.

policy
policy.az
policy.hardware
policy.software
policy.region

The resource configuration itself does not change. However, now, include an index when referencing them. For example, update policy.az.rpo to policy[0].az[0].rpo.

Resource `aws.s3.Bucket`

bucketRegion has been added and should be used instead of region, which is now used for Enhanced Region Support.

Resource `aws.sagemaker.ImageVersion`

For the id, use a comma-delimited string concatenating imageName and version. For example, in an import command, use comma-delimiting for the composite id. Use imageName to reference the image name.

Resource `aws.sagemaker.NotebookInstance`

Remove acceleratorTypes—it is no longer supported. Instead, use instanceType to use Inferentia.

Resource `aws.servicequotas.Template`

region has been deprecated. Use awsRegion instead.

Resource `aws.ec2.SpotInstanceRequest`

Remove blockDurationMinutes—it is no longer supported.

Resource `aws.ssm.Association`

Remove instanceId—it is no longer supported. Use targets instead.

Resource `aws.ssmincidents.ReplicationSet`

region has been deprecated. Use regions instead.

Resource `aws.verifiedpermissions.Schema`

Treat definition as a list of objects instead of an object. The resource configuration itself does not change. However, now, include an index when referencing it. For example, update definition.value to definition[0].value.

Resource `aws.wafv2.WebAcl`

The default value for rule.statement.managedRuleGroupStatement.managedRuleGroupConfigs.awsManagedRulesBotControlRuleSet.enableMachineLearning is now false. To retain the previous behavior where the argument was omitted, explicitly set the value to true.

Node Only Changes

The following changes only affect users of the nodejs SDK.

applicationloadbalancing

Removed Ipv4
- Use IpAddressType.Ipv4 instead
Removed Dualstack
- Use IpAddressType.Dualstack instead
Removed ApplicationLoadBalancer
- Use LoadBalancerType.Application instead
Removed NetworkLoadBalancer
- Use LoadBalancerType.Network instead

rds

Removed InstanceTypes.*
- Use InstanceType.* instead
Removed StorageTypes.Standard
- Use StorageType.Standard instead
Removed StorageTypes.GP2
- Use StorageType.GP2 instead
Removed StorageTypes.Io1
- Use StorageType.IO1 instead
Removed ProvisionedEngine
- Use EngineMode.Provisioned instead
Removed ServerlessEngine
- Use EngineMode.Serverless instead
Removed ParallelQueryEngine
- Use EngineMode.ParallelQuery instead
Removed GlobalEngine
- Use EngineMode.Global instead
Removed AuroraEngine
- Use EngineType.Aurora instead
Removed AuroraMysqlEngine
- Use EngineType.AuroraMysql instead
Removed AuroraPostgresqlEngine
- Use EngineType.AuroraPostgresql instead

iam

Removed ManagedPolicies.*
- Use ManagedPolicy.* instead

route53

Removed RecordTypes.A
- Use RecordType.A instead
Removed RecordTypes.AAAA
- Use RecordType.AAAA instead
Removed RecordTypes.CNAME
- Use RecordType.CNAME instead
Removed RecordTypes.CAA
- Use RecordType.CAA instead
Removed RecordTypes.MX
- Use RecordType.MX instead
Removed RecordTypes.NAPTR
- Use RecordType.NAPTR instead
Removed RecordTypes.NS
- Use RecordType.NS instead
Removed RecordTypes.PTR
- Use RecordType.PTR instead
Removed RecordTypes.SOA
- Use RecordType.SOA instead
Removed RecordTypes.SPF
- Use RecordType.SPF instead
Removed RecordTypes.SRV
- Use RecordType.SRV instead
Removed RecordTypes.TXT
- Use RecordType.TXT instead

s3

Removed PrivateAcl
- Use CannedAcl.Private instead
Removed PublicReadAcl
- Use CannedAcl.PublicRead instead
Removed PublicReadWriteAcl
- Use CannedAcl.PublicReadWrite instead
Removed AwsExecReadAcl
- Use CannedAcl.AwsExecRead instead
Removed AuthenticatedReadAcl
- Use CannedAcl.AuthenticatedRead instead
Removed BucketOwnerReadAcl
- Use CannedAcl.BucketOwnerRead instead
Removed BucketOwnerFullControlAcl
- Use CannedAcl.BucketOwnerFullControl instead
Removed LogDeliveryWriteAcl
- Use CannedAcl.LogDeliveryWrite instead

ec2

Removed InstanceTypes.*
- Use InstanceType.* instead
Removed InstancePlatforms.LinuxUnixPlatform
- Use InstancePlatform.LinuxUnix instead
Removed InstancePlatforms.RedHatEnterpriseLinuxPlatform
- Use InstancePlatform.RedHatEnterpriseLinux instead
Removed InstancePlatforms.SuseLinuxPlatform
- Use InstancePlatform.SuseLinux instead
Removed InstancePlatforms.WindowsPlatform
- Use InstancePlatform.Windows instead
Removed InstancePlatforms.WindowsWithSqlServerPlatform
- Use InstancePlatform.WindowsWithSqlServer instead
Removed InstancePlatforms.WindowsWithSqlServerEnterprisePlatform
- Use InstancePlatform.WindowsWithSqlServerEnterprise instead
Removed InstancePlatforms.WindowsWithSqlServerStandardPlatform
- Use InstancePlatform.WindowsWithSqlServerStandard instead
Removed InstancePlatforms.WindowsWithSqlServerWebPlatform
- Use InstancePlatform.WindowsWithSqlServerWeb instead
Removed SpreadStrategy
- Use PlacementStrategy.Spread instead
Removed ClusterStrategy
- Use PlacementStrategy.Cluster instead
Removed AllProtocols
- Use ProtocolType.All instead
Removed TCPProtocol
- Use ProtocolType.TCP instead
Removed UDPProtocol
- Use ProtocolType.UDP instead
Removed ICMPProtocol
- Use ProtocolType.ICMP instead
Removed Tenancies.DefaultTenancy
- Use Tenancy.Default instead
Removed Tenancies.DedicatedTenancy
- Use Tenancy.Dedicated instead

ecr

The rules input property of the ecr.LifecyclePolicyDocument type has changed from ecr.PolicyRule[] to pulumi.Input<pulumi.Input<ecr.PolicyRule>[]>;.

Before (v6)

const result: aws.ecr.LifecyclePolicyDocument = { rules: [] };
result.rules.push({
    action: {
        type: 'expire',
    },
    rulePriority: 1,
    selection: {
        countType: 'imageCountMoreThan',
        countNumber: 3,
        tagStatus: 'any',
    },
});

After (v7)

const result: aws.ecr.LifecyclePolicyDocument = { rules: [] };
const rules: aws.ecr.PolicyRule[] = [];
rules.push({
    action: {
        type: 'expire',
    },
    rulePriority: 1,
    selection: {
        countType: 'imageCountMoreThan',
        countNumber: 3,
        tagStatus: 'any',
    },
});
result.rules = rules;

lambda

Removed DotnetCore2d1Runtime
- Use Runtime.DotnetCore2d1 instead
Removed DotnetCore3d1Runtime
- Use Runtime.DotnetCore3d1 instead
Removed Go1dxRuntime
- Use Runtime.Go1dx instead
Removed Java8Runtime
- Use Runtime.Java8 instead
Removed Java11Runtime
- Use Runtime.Java11 instead
Removed Ruby2d5Runtime
- Use Runtime.Ruby2d5 instead
Removed Ruby2d7Runtime
- Use Runtime.Ruby2d7 instead
Removed NodeJS10dXRuntime
- Use Runtime.NodeJS10dX instead
Removed NodeJS12dXRuntime
- Use Runtime.NodeJS12dX instead
Removed Python2d7Runtime
- Use Runtime.Python2d7 instead
Removed Python3d6Runtime
- Use Runtime.Python3d6 instead
Removed Python3d7Runtime
- Use Runtime.Python3d7 instead
Removed Python3d8Runtime
- Use Runtime.Python3d8 instead
Removed CustomRuntime
- Use Runtime.Custom instead

ssm

Removed StringParameter
- Use ParamterType.String instead
Removed StringListParameter
- Use ParamterType.StringList instead
Removed SecureStringParameter
- Use ParameterType.SecureString instead

region

Removed AFSouth1Region
- Use Region.AFSouth1 instead
Removed APEast1Region
- Use Region.AFEast1 instead
Removed APNortheast1Region
- Use Region.AFNortheast1 instead
Removed APNortheast2Region
- Use Region.APNortheast2 instead
Removed APSouth1Region
- Use Region.APSouth1 instead
Removed APSouthEast2Region
- Use Region.APSoutheast2 instead
Removed APSoutheast1Region
- Use Region.APSoutheast1 instead
Removed CACentralRegion
- Use Region.CACentral1 instead
Removed CNNorth1Region
- Use Region.CNNorth1 instead
Removed CNNorthWest1Region
- Use Region.CNNorthwest1 instead
Removed EUCentral1Region
- Use Region.EUCentral1 instead
Removed EUNorth1Region
- Use Region.EUNorth1 instead
Removed EUWest1Region
- Use Region.EUWest1 instead
Removed EUWest2Region
- Use Region.EUWest2 instead
Removed EUWest3Region
- Use Region.EUWest3 instead
Removed EUSouth1Region
- Use Region.EUSouth1 instead
Removed MESouth1Region
- Use Region.MESouth1 instead
Removed SAEast1Region
- Use Region.SAEast1 instead
Removed USGovEast1Region
- Use Region.USGovEast1 instead
Removed USGovWest1Region
- Use Region.USGovWest1 instead
Removed USEast1Region
- Use Region.USEast1 instead
Removed USEast2Region
- Use Region.USEast2 instead
Removed USWest1Region
- Use Region.USWest1 instead
Removed USWest2Region
- Use Region.USWest2 instead

Enum Removals

The following enum values have been removed.

ec2.InstanceType.U_12TB1_METAL
ec2.InstanceType.U_6TB1_METAL
ec2.InstanceType.U_9TB1_METAL
ec2.InstanceType.HS1_8_X_LARGE
ec2.InstanceType.M5AS_X_LARGE
ec2.InstanceType.C7A_METAL
ec2.InstanceType.M7A_METAL
ec2.InstanceType.CC2_8_X_LARGE
ec2.InstanceType.G2_2_X_LARGE
ec2.InstanceType.G2_8_X_LARGE
ManagedPolicy.AWS_CODE_PIPELINE_READ_ONLY_ACCESS
- Use ManagedPolicy.CodePipeline_ReadOnlyAccess instead
ManagedPolicy.AWS_CONFIG_ROLE
- Use ManagedPolicy.AWS_ConfigRole instead
ManagedPolicy.AWS_DATA_PIPELINE_ROLE
ManagedPolicy.AWS_ELASTIC_BEANSTALK_FULL_ACCESS
- Use ManagedPolicy.AdministratorAccessAWSElasticBeanstalk instead
ManagedPolicy.AWS_ELASTIC_BEANSTALK_READ_ONLY_ACCESS
- Use ManagedPolicy.AWSElasticBeanstalkReadOnly instead
ManagedPolicy.AWS_ELASTIC_BEANSTAK_WORKER_TIER
- Use ManagedPolicy.AWSElasticBeanstalkWorkerTier instead
ManagedPolicy.AWS_GREENGRASS_FULLCCESS
- Use ManagedPolicy.AWSGreengrassFullAccess instead
ManagedPolicy.AWS_LAMBDA_FULL_ACCESS
- Use ManagedPolicy.LambdaFullAccess instead
ManagedPolicy.AWS_LAMBDA_READ_ONLY_ACCESS
- Use ManagedPolicy.LambdaReadOnlyAccess instead
ManagedPolicy.AWS_MOBILE_HUB_FULL_ACCESS
ManagedPolicy.AWS_MOBILE_HUB_READ_ONLY
ManagedPolicy.AWS_MOBILE_HUB_SERVICE_USE_ONLY
ManagedPolicy.AWS_OPS_WORKS_FULL_ACCESS
- Use ManagedPolicy.OpsWorks_FullAccess instead
ManagedPolicy.AWS_OPS_WORKS_REGISTER_CLI
- Use ManagedPolicy.AWSOpsWorksRegisterCLI_EC2 or ManagedPolicy.AWSOpsWorksRegisterCLI_OnPremises instead
ManagedPolicy.AWS_OPS_WORKS_ROLE
- Use ManagedPolicy.AWSOpsWorksCMServiceRole instead
ManagedPolicy.AWS_QUICK_SIGHT_DESCRIBE_RD
- Use ManagedPolicy.AWSQuickSightDescribeRDS instead
ManagedPolicy.AMAZON_EC2_CONTAINER_SERVICE_FULL_ACCESS
- Use ManagedPolicy.AmazonECSFullAccess instead
ManagedPolicy.AMAZON_EC2_REPORTS_ACCESS
ManagedPolicy.AMAZON_EC2_SPOT_FLEET_ROLE
ManagedPolicy.AMAZON_ELASTIC_TRANSCODER_FULL_ACCESS
- Use ManagedPolicy.ElasticTranscoder_FullAccess instead
ManagedPolicy.AMAZON_ELASTIC_TRANSCODER_JOBS_SUBMITTER
- Use ManagedPolicy.ElasticTranscoder_JobsSubmitter instead
ManagedPolicy.AMAZON_ELASTIC_TRANSCODER_READ_ONLY_ACCESS
- Use ManagedPolicy.ElasticTranscoder_ReadOnlyAccess instead
ManagedPolicy.AMAZON_LAUNCH_WIZARD_FULLACCESS
ManagedPolicy.AMAZON_MACHINE_LEARNING_ROLEFOR_REDSHIFT_DATA_SOURCE
- Use ManagedPolicy.AmazonMachineLearningRoleforRedshiftDataSourceV3 instead
ManagedPolicy.AMAZON_SUMERIAN_FULL_ACCESS
ManagedPolicy.FUSION_DEV_INTERNAL_SERVICE_ROLE_POLICY
ManagedPolicy.SERVER_MIGRATION_SERVICE_ROLE
- Use ManagedPolicy.AWSServerMigration_ServiceRole instead
ManagedPolicy.SERVICE_CATALOG_ADMIN_FULL_ACCESS
- Use ManagedPolicy.AWSServiceCatalogAdminFullAccess instead
ManagedPolicy.SERVICE_CATALOG_ADMIN_READ_ONLY_ACCESS
- Use ManagedPolicy.AWSServiceCatalogAdminReadOnlyAccess instead
ManagedPolicy.SERVICE_CATALOG_END_USER_ACCESS
- Use ManagedPolicy.AWSServiceCatalogEndUserReadOnlyAccess instead
ManagedPolicy.SERVICE_CATALOG_END_USER_FULL_ACCESS
- Use ManagedPolicy.AWSServiceCatalogEndUserFullAccess instead

(Related to deprecated AWS Services)

ManagedPolicy.AmazonChimeFullAccess
ManagedPolicy.AmazonChimeReadOnly
ManagedPolicy.AmazonChimeSDK
ManagedPolicy.AmazonChimeSDKMediaPipelinesServiceLinkedRolePolicy
ManagedPolicy.AmazonChimeSDKMessagingServiceRolePolicy
ManagedPolicy.AmazonChimeServiceRolePolicy
ManagedPolicy.AmazonChimeTranscriptionServiceLinkedRolePolicy
ManagedPolicy.AmazonChimeUserManagement
ManagedPolicy.AmazonChimeVoiceConnectorServiceLinkedRolePolicy
ManagedPolicy.AWSOpsWorksCMInstanceProfileRole
ManagedPolicy.AWSOpsWorksCMServiceRole
ManagedPolicy.AWSOpsWorksCloudWatchLogs
ManagedPolicy.AWSOpsWorksInstanceRegistration
ManagedPolicy.AWSOpsWorksRegisterCLI_EC2
ManagedPolicy.AWSOpsWorksRegisterCLI_OnPremises
ManagedPolicy.OpsWorks_FullAccess
ManagedPolicy.WorkLinkServiceRolePolicy

AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi

pulumi/pulumi-aws

Migrating from 6.x to 7.x

On this page

On this page

Upstream Changes

Prerequisites to Upgrade to v7.0.0

Example

Performing the Upgrade

Removed Provider Arguments

Enhanced Region Support

Provider role chaining

S3 Bucket/BucketV2 Changes

Migration

Example

Tags Changes

Patch Related Changes

Resource aws.eks.Cluster

Function aws.ecr.getCredentials

Amazon Elastic Transcoder Deprecation

CloudWatch Evidently Deprecation

OpsWorks Stacks Removal

SimpleDB Support Removed

Worklink Support Removed

S3 Global Endpoint Deprecation

Function aws.ec2.getAmi

How to fix it

Unsafe option (not recommended)

Function aws.batch.getComputeEnvironment

Function aws.ecs.getTaskDefinition

Function aws.ecs.getTaskExecution

Function aws.elbv2.getListenerRule

Function aws.globalaccelerator.getAccelerator

Function aws.identitystore.getGroup

Function aws.identitystore.getUser

Function aws.kms.getSecret

Function aws.launch.getTemplate

Function aws.opensearch.getDomain

Function aws.opensearchserverless.getSecurityConfig

Function aws.quicksight.getDataSet

Function aws.getRegion

Function aws.s3.getBucket

Function aws.service.getDiscoveryService

Function aws.servicequotas.getTemplates

Function aws.ssmincidents.getReplicationSet

Function aws.vpc.getEndpointService

Function aws.vpc.getPeeringConnection

Resource aws.apigateway.Account

Resource aws.apigateway.Deployment

Migration Example

Resource aws.appflow.ConnectorProfile

Resource aws.appflow.Flow

Resource aws.batch.ComputeEnvironment

Resource aws.batch.JobQueue

Resource aws.bedrockmodel.InvocationLoggingConfiguration

Resource aws.cloudformation.StackSetInstance

Resource aws.cloudfront.KeyValueStore

Resource aws.cloudfront.ResponseHeadersPolicy

Resource aws.cognito.UserInGroup

Resource aws.cfg.AggregateAuthorization

Resource aws.rds.Instance

Resource aws.dms.Endpoint

Resource aws.directconnect.GatewayAssociation

Resource aws.directconnect.HostedConnection

Resource aws.ecs.TaskDefinition

Resource aws.ec2.Eip

Resource aws.eks.Addon

Resource aws.eks.Cluster

Resource aws.elasticache.ReplicationGroup

Resource aws.elasticache.User

Resource aws.elasticache.UserGroup

Resource aws.ec2.FlowLog

Resource aws.guardduty.Detector

Resource aws.guardduty.OrganizationConfiguration

Resource aws.ec2.Instance

Resource aws.kinesis.AnalyticsApplication

Resource aws.ec2.LaunchTemplate

Resource aws.lb.Listener

Resource aws.mediastore.Container

Resource aws.mediastore.ContainerPolicy

Resource aws.networkmanager.CoreNetwork

Resource aws.opensearch.Domain

Resource `aws.eks.Cluster`

Function `aws.ecr.getCredentials`

Function `aws.ec2.getAmi`

Function `aws.batch.getComputeEnvironment`

Function `aws.ecs.getTaskDefinition`

Function `aws.ecs.getTaskExecution`

Function `aws.elbv2.getListenerRule`

Function `aws.globalaccelerator.getAccelerator`

Function `aws.identitystore.getGroup`

Function `aws.identitystore.getUser`

Function `aws.kms.getSecret`

Function `aws.launch.getTemplate`

Function `aws.opensearch.getDomain`

Function `aws.opensearchserverless.getSecurityConfig`

Function `aws.quicksight.getDataSet`

Function `aws.getRegion`

Function `aws.s3.getBucket`

Function `aws.service.getDiscoveryService`

Function `aws.servicequotas.getTemplates`

Function `aws.ssmincidents.getReplicationSet`

Function `aws.vpc.getEndpointService`

Function `aws.vpc.getPeeringConnection`

Resource `aws.apigateway.Account`

Resource `aws.apigateway.Deployment`

Resource `aws.appflow.ConnectorProfile`

Resource `aws.appflow.Flow`

Resource `aws.batch.ComputeEnvironment`

Resource `aws.batch.JobQueue`

Resource `aws.bedrockmodel.InvocationLoggingConfiguration`

Resource `aws.cloudformation.StackSetInstance`

Resource `aws.cloudfront.KeyValueStore`

Resource `aws.cloudfront.ResponseHeadersPolicy`

Resource `aws.cognito.UserInGroup`

Resource `aws.cfg.AggregateAuthorization`

Resource `aws.rds.Instance`

Resource `aws.dms.Endpoint`

Resource `aws.directconnect.GatewayAssociation`

Resource `aws.directconnect.HostedConnection`

Resource `aws.ecs.TaskDefinition`

Resource `aws.ec2.Eip`

Resource `aws.eks.Addon`

Resource `aws.eks.Cluster`

Resource `aws.elasticache.ReplicationGroup`

Resource `aws.elasticache.User`

Resource `aws.elasticache.UserGroup`

Resource `aws.ec2.FlowLog`

Resource `aws.guardduty.Detector`

Resource `aws.guardduty.OrganizationConfiguration`

Resource `aws.ec2.Instance`

Resource `aws.kinesis.AnalyticsApplication`

Resource `aws.ec2.LaunchTemplate`

Resource `aws.lb.Listener`

Resource `aws.mediastore.Container`

Resource `aws.mediastore.ContainerPolicy`

Resource `aws.networkmanager.CoreNetwork`

Resource `aws.opensearch.Domain`

Resource `aws.opensearch.ServerlessSecurityConfig`

Resource `aws.paymentcryptography.Key`

Resource `aws.redshift.Cluster`

Resource `aws.redshift.ServiceAccount`

Resource `aws.rekognition.StreamProcessor`

Resource `aws.resiliencehub.ResiliencyPolicy`

Resource `aws.s3.Bucket`

Resource `aws.sagemaker.ImageVersion`

Resource `aws.sagemaker.NotebookInstance`

Resource `aws.servicequotas.Template`

Resource `aws.ec2.SpotInstanceRequest`

Resource `aws.ssm.Association`

Resource `aws.ssmincidents.ReplicationSet`

Resource `aws.verifiedpermissions.Schema`

Resource `aws.wafv2.WebAcl`