Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS
  3. API Docs
  4. s3
  5. BucketPolicy
AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi
pulumi/pulumi-aws

aws.s3.BucketPolicy

Explore with Pulumi AI

aws logo
AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi
pulumi/pulumi-aws

    Attaches a policy to an S3 bucket resource.

    Policies can be attached to both S3 general purpose buckets and S3 directory buckets.

    Example Usage

    Basic Usage

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

const example = new aws.s3.Bucket("example", {bucket: "my-tf-test-bucket"});
const allowAccessFromAnotherAccount = aws.iam.getPolicyDocumentOutput({
    statements: [{
        principals: [{
            type: "AWS",
            identifiers: ["123456789012"],
        }],
        actions: [
            "s3:GetObject",
            "s3:ListBucket",
        ],
        resources: [
            example.arn,
            pulumi.interpolate`${example.arn}/*`,
        ],
    }],
});
const allowAccessFromAnotherAccountBucketPolicy = new aws.s3.BucketPolicy("allow_access_from_another_account", {
    bucket: example.id,
    policy: allowAccessFromAnotherAccount.apply(allowAccessFromAnotherAccount => allowAccessFromAnotherAccount.json),
});

    import pulumi
import pulumi_aws as aws

example = aws.s3.Bucket("example", bucket="my-tf-test-bucket")
allow_access_from_another_account = aws.iam.get_policy_document_output(statements=[{
    "principals": [{
        "type": "AWS",
        "identifiers": ["123456789012"],
    }],
    "actions": [
        "s3:GetObject",
        "s3:ListBucket",
    ],
    "resources": [
        example.arn,
        example.arn.apply(lambda arn: f"{arn}/*"),
    ],
}])
allow_access_from_another_account_bucket_policy = aws.s3.BucketPolicy("allow_access_from_another_account",
    bucket=example.id,
    policy=allow_access_from_another_account.json)

    package main

import (
	"fmt"

	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/iam"
	"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 {
		example, err := s3.NewBucket(ctx, "example", &s3.BucketArgs{
			Bucket: pulumi.String("my-tf-test-bucket"),
		})
		if err != nil {
			return err
		}
		allowAccessFromAnotherAccount := iam.GetPolicyDocumentOutput(ctx, iam.GetPolicyDocumentOutputArgs{
			Statements: iam.GetPolicyDocumentStatementArray{
				&iam.GetPolicyDocumentStatementArgs{
					Principals: iam.GetPolicyDocumentStatementPrincipalArray{
						&iam.GetPolicyDocumentStatementPrincipalArgs{
							Type: pulumi.String("AWS"),
							Identifiers: pulumi.StringArray{
								pulumi.String("123456789012"),
							},
						},
					},
					Actions: pulumi.StringArray{
						pulumi.String("s3:GetObject"),
						pulumi.String("s3:ListBucket"),
					},
					Resources: pulumi.StringArray{
						example.Arn,
						example.Arn.ApplyT(func(arn string) (string, error) {
							return fmt.Sprintf("%v/*", arn), nil
						}).(pulumi.StringOutput),
					},
				},
			},
		}, nil)
		_, err = s3.NewBucketPolicy(ctx, "allow_access_from_another_account", &s3.BucketPolicyArgs{
			Bucket: example.ID(),
			Policy: pulumi.String(allowAccessFromAnotherAccount.ApplyT(func(allowAccessFromAnotherAccount iam.GetPolicyDocumentResult) (*string, error) {
				return &allowAccessFromAnotherAccount.Json, nil
			}).(pulumi.StringPtrOutput)),
		})
		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.S3.Bucket("example", new()
    {
        BucketName = "my-tf-test-bucket",
    });

    var allowAccessFromAnotherAccount = Aws.Iam.GetPolicyDocument.Invoke(new()
    {
        Statements = new[]
        {
            new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
            {
                Principals = new[]
                {
                    new Aws.Iam.Inputs.GetPolicyDocumentStatementPrincipalInputArgs
                    {
                        Type = "AWS",
                        Identifiers = new[]
                        {
                            "123456789012",
                        },
                    },
                },
                Actions = new[]
                {
                    "s3:GetObject",
                    "s3:ListBucket",
                },
                Resources = new[]
                {
                    example.Arn,
                    $"{example.Arn}/*",
                },
            },
        },
    });

    var allowAccessFromAnotherAccountBucketPolicy = new Aws.S3.BucketPolicy("allow_access_from_another_account", new()
    {
        Bucket = example.Id,
        Policy = allowAccessFromAnotherAccount.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json),
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.aws.iam.IamFunctions;
import com.pulumi.aws.iam.inputs.GetPolicyDocumentArgs;
import com.pulumi.aws.s3.BucketPolicy;
import com.pulumi.aws.s3.BucketPolicyArgs;
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 Bucket("example", BucketArgs.builder()
            .bucket("my-tf-test-bucket")
            .build());

        final var allowAccessFromAnotherAccount = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
            .statements(GetPolicyDocumentStatementArgs.builder()
                .principals(GetPolicyDocumentStatementPrincipalArgs.builder()
                    .type("AWS")
                    .identifiers("123456789012")
                    .build())
                .actions(                
                    "s3:GetObject",
                    "s3:ListBucket")
                .resources(                
                    example.arn(),
                    example.arn().applyValue(_arn -> String.format("%s/*", _arn)))
                .build())
            .build());

        var allowAccessFromAnotherAccountBucketPolicy = new BucketPolicy("allowAccessFromAnotherAccountBucketPolicy", BucketPolicyArgs.builder()
            .bucket(example.id())
            .policy(allowAccessFromAnotherAccount.applyValue(_allowAccessFromAnotherAccount -> _allowAccessFromAnotherAccount.json()))
            .build());

    }
}

    resources:
  example:
    type: aws:s3:Bucket
    properties:
      bucket: my-tf-test-bucket
  allowAccessFromAnotherAccountBucketPolicy:
    type: aws:s3:BucketPolicy
    name: allow_access_from_another_account
    properties:
      bucket: ${example.id}
      policy: ${allowAccessFromAnotherAccount.json}
variables:
  allowAccessFromAnotherAccount:
    fn::invoke:
      function: aws:iam:getPolicyDocument
      arguments:
        statements:
          - principals:
              - type: AWS
                identifiers:
                  - '123456789012'
            actions:
              - s3:GetObject
              - s3:ListBucket
            resources:
              - ${example.arn}
              - ${example.arn}/*

    Only one aws.s3.BucketPolicy resource should be defined per S3 bucket. Defining multiple aws.s3.BucketPolicy resources with different Pulumi names but the same bucket value may result in unexpected policy overwrites. Each resource uses the PutBucketPolicy API, which replaces the entire existing policy without error or warning. Because Pulumi treats each resource independently, the policy applied last will silently override any previously applied policy.

    Create BucketPolicy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new BucketPolicy(name: string, args: BucketPolicyArgs, opts?: CustomResourceOptions);
    @overload
def BucketPolicy(resource_name: str,
                 args: BucketPolicyArgs,
                 opts: Optional[ResourceOptions] = None)

@overload
def BucketPolicy(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 bucket: Optional[str] = None,
                 policy: Optional[Union[str, PolicyDocumentArgs]] = None,
                 region: Optional[str] = None)
    func NewBucketPolicy(ctx *Context, name string, args BucketPolicyArgs, opts ...ResourceOption) (*BucketPolicy, error)
    public BucketPolicy(string name, BucketPolicyArgs args, CustomResourceOptions? opts = null)
    public BucketPolicy(String name, BucketPolicyArgs args)
public BucketPolicy(String name, BucketPolicyArgs args, CustomResourceOptions options)

    type: aws:s3:BucketPolicy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args BucketPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args BucketPolicyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args BucketPolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BucketPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BucketPolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var bucketPolicyResource = new Aws.S3.BucketPolicy("bucketPolicyResource", new()
{
    Bucket = "string",
    Policy = "string",
    Region = "string",
});

    example, err := s3.NewBucketPolicy(ctx, "bucketPolicyResource", &s3.BucketPolicyArgs{
	Bucket: pulumi.String("string"),
	Policy: pulumi.Any("string"),
	Region: pulumi.String("string"),
})

    var bucketPolicyResource = new com.pulumi.aws.s3.BucketPolicy("bucketPolicyResource", com.pulumi.aws.s3.BucketPolicyArgs.builder()
    .bucket("string")
    .policy("string")
    .region("string")
    .build());

    bucket_policy_resource = aws.s3.BucketPolicy("bucketPolicyResource",
    bucket="string",
    policy="string",
    region="string")

    const bucketPolicyResource = new aws.s3.BucketPolicy("bucketPolicyResource", {
    bucket: "string",
    policy: "string",
    region: "string",
});

    type: aws:s3:BucketPolicy
properties:
    bucket: string
    policy: string
    region: string

    BucketPolicy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The BucketPolicy resource accepts the following input properties:

    Bucket string
    Name of the bucket to which to apply the policy.
    Policy string | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Bucket string
    Name of the bucket to which to apply the policy.
    Policy string | PolicyDocumentArgs
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    Name of the bucket to which to apply the policy.
    policy String | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket string
    Name of the bucket to which to apply the policy.
    policy string | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket str
    Name of the bucket to which to apply the policy.
    policy str | PolicyDocumentArgs
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    Name of the bucket to which to apply the policy.
    policy String | Property Map
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the BucketPolicy resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing BucketPolicy Resource

    Get an existing BucketPolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: BucketPolicyState, opts?: CustomResourceOptions): BucketPolicy
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        bucket: Optional[str] = None,
        policy: Optional[Union[str, PolicyDocumentArgs]] = None,
        region: Optional[str] = None) -> BucketPolicy
    func GetBucketPolicy(ctx *Context, name string, id IDInput, state *BucketPolicyState, opts ...ResourceOption) (*BucketPolicy, error)
    public static BucketPolicy Get(string name, Input<string> id, BucketPolicyState? state, CustomResourceOptions? opts = null)
    public static BucketPolicy get(String name, Output<String> id, BucketPolicyState state, CustomResourceOptions options)
    resources:  _:    type: aws:s3:BucketPolicy    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Bucket string
    Name of the bucket to which to apply the policy.
    Policy string | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Bucket string
    Name of the bucket to which to apply the policy.
    Policy string | PolicyDocumentArgs
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    Name of the bucket to which to apply the policy.
    policy String | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket string
    Name of the bucket to which to apply the policy.
    policy string | PolicyDocument
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket str
    Name of the bucket to which to apply the policy.
    policy str | PolicyDocumentArgs
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    Name of the bucket to which to apply the policy.
    policy String | Property Map
    Text of the policy. Although this is a bucket policy rather than an IAM policy, the aws.iam.getPolicyDocument data source may be used, so long as it specifies a principal. For more information about building AWS IAM policy documents, see the AWS IAM Policy Document Guide. Note: Bucket policies are limited to 20 KB in size.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    Supporting Types

    AWSPrincipal, AWSPrincipalArgs

    AWS string | List<string>
    AWS account identifier or ARN.
    AWS string | []string
    AWS account identifier or ARN.
    AWS String | List<String>
    AWS account identifier or ARN.
    AWS string | string[]
    AWS account identifier or ARN.
    aws str | Sequence[str]
    AWS account identifier or ARN.
    AWS String | List<String>
    AWS account identifier or ARN.

    FederatedPrincipal, FederatedPrincipalArgs

    Federated string | List<string>
    The federated principal identifier.
    Federated string | []string
    The federated principal identifier.
    Federated String | List<String>
    The federated principal identifier.
    Federated string | string[]
    The federated principal identifier.
    federated str | Sequence[str]
    The federated principal identifier.
    Federated String | List<String>
    The federated principal identifier.

    PolicyDocument, PolicyDocumentArgs

    PolicyDocumentVersion, PolicyDocumentVersionArgs

    PolicyDocumentVersion_2012_10_17
    2012-10-17
    PolicyDocumentVersion_2008_10_17
    2008-10-17
    PolicyDocumentVersion_2012_10_17
    2012-10-17
    PolicyDocumentVersion_2008_10_17
    2008-10-17
    _20121017
    2012-10-17
    _20081017
    2008-10-17
    PolicyDocumentVersion_2012_10_17
    2012-10-17
    PolicyDocumentVersion_2008_10_17
    2008-10-17
    POLICY_DOCUMENT_VERSION_2012_10_17
    2012-10-17
    POLICY_DOCUMENT_VERSION_2008_10_17
    2008-10-17
    "2012-10-17"
    2012-10-17
    "2008-10-17"
    2008-10-17

    PolicyStatement, PolicyStatementArgs

    Effect Pulumi.Aws.Iam.PolicyStatementEffect
    Indicate whether the policy allows or denies access.
    Action string | List<string>
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    Condition Dictionary<string, object>
    Specify the circumstances under which the policy grants permission.
    NotAction string | List<string>
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    NotPrincipal string | Pulumi.Aws.Iam.Inputs.AWSPrincipal | Pulumi.Aws.Iam.Inputs.ServicePrincipal | Pulumi.Aws.Iam.Inputs.FederatedPrincipal
    Indicate the account, user, role, or federated user to which this policy does not apply.
    NotResource string | List<string>
    A list of resources that are specifically excluded by this policy.
    Principal string | Pulumi.Aws.Iam.Inputs.AWSPrincipal | Pulumi.Aws.Iam.Inputs.ServicePrincipal | Pulumi.Aws.Iam.Inputs.FederatedPrincipal
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    Resource string | List<string>
    A list of resources to which the actions apply.
    Sid string
    An optional statement ID to differentiate between your statements.
    Effect PolicyStatementEffect
    Indicate whether the policy allows or denies access.
    Action string | []string
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    Condition map[string]interface{}
    Specify the circumstances under which the policy grants permission.
    NotAction string | []string
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    NotPrincipal string | AWSPrincipal | ServicePrincipal | FederatedPrincipal
    Indicate the account, user, role, or federated user to which this policy does not apply.
    NotResource string | []string
    A list of resources that are specifically excluded by this policy.
    Principal string | AWSPrincipal | ServicePrincipal | FederatedPrincipal
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    Resource string | []string
    A list of resources to which the actions apply.
    Sid string
    An optional statement ID to differentiate between your statements.
    Effect PolicyStatementEffect
    Indicate whether the policy allows or denies access.
    Action String | List<String>
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    Condition Map<String,Object>
    Specify the circumstances under which the policy grants permission.
    NotAction String | List<String>
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    NotPrincipal String | AWSPrincipal | ServicePrincipal | FederatedPrincipal
    Indicate the account, user, role, or federated user to which this policy does not apply.
    NotResource String | List<String>
    A list of resources that are specifically excluded by this policy.
    Principal String | AWSPrincipal | ServicePrincipal | FederatedPrincipal
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    Resource String | List<String>
    A list of resources to which the actions apply.
    Sid String
    An optional statement ID to differentiate between your statements.
    Effect iam.PolicyStatementEffect
    Indicate whether the policy allows or denies access.
    Action string | string[]
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    Condition {[key: string]: any}
    Specify the circumstances under which the policy grants permission.
    NotAction string | string[]
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    NotPrincipal string | iam.AWSPrincipal | iam.ServicePrincipal | iam.FederatedPrincipal
    Indicate the account, user, role, or federated user to which this policy does not apply.
    NotResource string | string[]
    A list of resources that are specifically excluded by this policy.
    Principal string | iam.AWSPrincipal | iam.ServicePrincipal | iam.FederatedPrincipal
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    Resource string | string[]
    A list of resources to which the actions apply.
    Sid string
    An optional statement ID to differentiate between your statements.
    effect iam.PolicyStatementEffect
    Indicate whether the policy allows or denies access.
    action str | Sequence[str]
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    condition Mapping[str, Any]
    Specify the circumstances under which the policy grants permission.
    not_action str | Sequence[str]
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    not_principal str | iam.AWSPrincipal | iam.ServicePrincipal | iam.FederatedPrincipal
    Indicate the account, user, role, or federated user to which this policy does not apply.
    not_resource str | Sequence[str]
    A list of resources that are specifically excluded by this policy.
    principal str | iam.AWSPrincipal | iam.ServicePrincipal | iam.FederatedPrincipal
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    resource str | Sequence[str]
    A list of resources to which the actions apply.
    sid str
    An optional statement ID to differentiate between your statements.
    Effect "Allow" | "Deny"
    Indicate whether the policy allows or denies access.
    Action String | List<String>
    Include a list of actions that the policy allows or denies. Required (either Action or NotAction)
    Condition Map<Any>
    Specify the circumstances under which the policy grants permission.
    NotAction String | List<String>
    Include a list of actions that are not covered by this policy. Required (either Action or NotAction)
    NotPrincipal String | Property Map | Property Map | Property Map
    Indicate the account, user, role, or federated user to which this policy does not apply.
    NotResource String | List<String>
    A list of resources that are specifically excluded by this policy.
    Principal String | Property Map | Property Map | Property Map
    Indicate the account, user, role, or federated user to which you would like to allow or deny access. If you are creating a policy to attach to a user or role, you cannot include this element. The principal is implied as that user or role.
    Resource String | List<String>
    A list of resources to which the actions apply.
    Sid String
    An optional statement ID to differentiate between your statements.

    PolicyStatementEffect, PolicyStatementEffectArgs

    ALLOW
    Allow
    DENY
    Deny
    PolicyStatementEffectALLOW
    Allow
    PolicyStatementEffectDENY
    Deny
    ALLOW
    Allow
    DENY
    Deny
    ALLOW
    Allow
    DENY
    Deny
    ALLOW
    Allow
    DENY
    Deny
    "Allow"
    Allow
    "Deny"
    Deny

    ServicePrincipal, ServicePrincipalArgs

    Service string | List<string>
    The service principal identifier.
    Service string | []string
    The service principal identifier.
    Service String | List<String>
    The service principal identifier.
    Service string | string[]
    The service principal identifier.
    service str | Sequence[str]
    The service principal identifier.
    Service String | List<String>
    The service principal identifier.

    Import

    Using pulumi import, import S3 bucket policies using the bucket name. For example:

    $ pulumi import aws:s3/bucketPolicy:BucketPolicy allow_access_from_another_account my-tf-test-bucket

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi
    pulumi/pulumi-aws