1. Packages
  2. AWS
  3. API Docs
  4. s3
  5. getBucketReplicationConfiguration
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.s3.getBucketReplicationConfiguration

aws logo
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Data source for managing an AWS S3 (Simple Storage) Bucket Replication Configuration.

    Example Usage

    Basic Usage

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

const example = aws.s3.getBucketReplicationConfiguration({
    bucket: "example-bucket",
});

    import pulumi
import pulumi_aws as aws

example = aws.s3.get_bucket_replication_configuration(bucket="example-bucket")

    package main

import (
	"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 {
		_, err := s3.GetBucketReplicationConfiguration(ctx, &s3.GetBucketReplicationConfigurationArgs{
			Bucket: "example-bucket",
		}, nil)
		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 = Aws.S3.GetBucketReplicationConfiguration.Invoke(new()
    {
        Bucket = "example-bucket",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.S3Functions;
import com.pulumi.aws.s3.inputs.GetBucketReplicationConfigurationArgs;
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 example = S3Functions.getBucketReplicationConfiguration(GetBucketReplicationConfigurationArgs.builder()
            .bucket("example-bucket")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:s3:getBucketReplicationConfiguration
      arguments:
        bucket: example-bucket

    Using getBucketReplicationConfiguration

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getBucketReplicationConfiguration(args: GetBucketReplicationConfigurationArgs, opts?: InvokeOptions): Promise<GetBucketReplicationConfigurationResult>
function getBucketReplicationConfigurationOutput(args: GetBucketReplicationConfigurationOutputArgs, opts?: InvokeOptions): Output<GetBucketReplicationConfigurationResult>
    def get_bucket_replication_configuration(bucket: Optional[str] = None,
                                         region: Optional[str] = None,
                                         opts: Optional[InvokeOptions] = None) -> GetBucketReplicationConfigurationResult
def get_bucket_replication_configuration_output(bucket: Optional[pulumi.Input[str]] = None,
                                         region: Optional[pulumi.Input[str]] = None,
                                         opts: Optional[InvokeOptions] = None) -> Output[GetBucketReplicationConfigurationResult]
    func GetBucketReplicationConfiguration(ctx *Context, args *GetBucketReplicationConfigurationArgs, opts ...InvokeOption) (*GetBucketReplicationConfigurationResult, error)
func GetBucketReplicationConfigurationOutput(ctx *Context, args *GetBucketReplicationConfigurationOutputArgs, opts ...InvokeOption) GetBucketReplicationConfigurationResultOutput

    > Note: This function is named GetBucketReplicationConfiguration in the Go SDK.

    public static class GetBucketReplicationConfiguration 
{
    public static Task<GetBucketReplicationConfigurationResult> InvokeAsync(GetBucketReplicationConfigurationArgs args, InvokeOptions? opts = null)
    public static Output<GetBucketReplicationConfigurationResult> Invoke(GetBucketReplicationConfigurationInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetBucketReplicationConfigurationResult> getBucketReplicationConfiguration(GetBucketReplicationConfigurationArgs args, InvokeOptions options)
public static Output<GetBucketReplicationConfigurationResult> getBucketReplicationConfiguration(GetBucketReplicationConfigurationArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:s3/getBucketReplicationConfiguration:getBucketReplicationConfiguration
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Bucket string
    The name of the bucket to get the replication configuration for.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Bucket string
    The name of the bucket to get the replication configuration for.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    The name of the bucket to get the replication configuration for.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket string
    The name of the bucket to get the replication configuration for.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket str
    The name of the bucket to get the replication configuration for.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    bucket String
    The name of the bucket to get the replication configuration for.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    getBucketReplicationConfiguration Result

    The following output properties are available:

    Bucket string
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    Role string
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    Rules List<GetBucketReplicationConfigurationRule>
    An unordered list of configuration blocks that define the rules managing replication.
    Bucket string
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    Role string
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    Rules []GetBucketReplicationConfigurationRule
    An unordered list of configuration blocks that define the rules managing replication.
    bucket String
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    role String
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    rules List<GetBucketReplicationConfigurationRule>
    An unordered list of configuration blocks that define the rules managing replication.
    bucket string
    id string
    The provider-assigned unique ID for this managed resource.
    region string
    role string
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    rules GetBucketReplicationConfigurationRule[]
    An unordered list of configuration blocks that define the rules managing replication.
    bucket str
    id str
    The provider-assigned unique ID for this managed resource.
    region str
    role str
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    rules Sequence[GetBucketReplicationConfigurationRule]
    An unordered list of configuration blocks that define the rules managing replication.
    bucket String
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    role String
    The ARN of the IAM role that Amazon S3 assumes when replicating objects.
    rules List<Property Map>
    An unordered list of configuration blocks that define the rules managing replication.

    Supporting Types

    GetBucketReplicationConfigurationRule

    GetBucketReplicationConfigurationRuleDeleteMarkerReplication

    Status string
    Status string
    status String
    status string
    status str
    status String

    GetBucketReplicationConfigurationRuleDestination

    GetBucketReplicationConfigurationRuleDestinationAccessControlTranslation

    Owner string
    Owner string
    owner String
    owner string
    owner str
    owner String

    GetBucketReplicationConfigurationRuleDestinationEncryptionConfiguration

    GetBucketReplicationConfigurationRuleDestinationMetric

    GetBucketReplicationConfigurationRuleDestinationMetricEventThreshold

    minutes Integer
    minutes number
    minutes Number

    GetBucketReplicationConfigurationRuleDestinationReplicationTime

    GetBucketReplicationConfigurationRuleDestinationReplicationTimeTime

    minutes Integer
    minutes number
    minutes Number

    GetBucketReplicationConfigurationRuleExistingObjectReplication

    Status string
    Status string
    status String
    status string
    status str
    status String

    GetBucketReplicationConfigurationRuleFilter

    Ands List<GetBucketReplicationConfigurationRuleFilterAnd>
    Prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    Tags List<GetBucketReplicationConfigurationRuleFilterTag>
    An unordered list of tags that identify a subset of objects to which the rule applies.
    Ands []GetBucketReplicationConfigurationRuleFilterAnd
    Prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    Tags []GetBucketReplicationConfigurationRuleFilterTag
    An unordered list of tags that identify a subset of objects to which the rule applies.
    ands List<GetBucketReplicationConfigurationRuleFilterAnd>
    prefix String
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags List<GetBucketReplicationConfigurationRuleFilterTag>
    An unordered list of tags that identify a subset of objects to which the rule applies.
    ands GetBucketReplicationConfigurationRuleFilterAnd[]
    prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags GetBucketReplicationConfigurationRuleFilterTag[]
    An unordered list of tags that identify a subset of objects to which the rule applies.
    ands Sequence[GetBucketReplicationConfigurationRuleFilterAnd]
    prefix str
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags Sequence[GetBucketReplicationConfigurationRuleFilterTag]
    An unordered list of tags that identify a subset of objects to which the rule applies.
    ands List<Property Map>
    prefix String
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags List<Property Map>
    An unordered list of tags that identify a subset of objects to which the rule applies.

    GetBucketReplicationConfigurationRuleFilterAnd

    Prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    Tags List<GetBucketReplicationConfigurationRuleFilterAndTag>
    An unordered list of tags that identify a subset of objects to which the rule applies.
    Prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    Tags []GetBucketReplicationConfigurationRuleFilterAndTag
    An unordered list of tags that identify a subset of objects to which the rule applies.
    prefix String
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags List<GetBucketReplicationConfigurationRuleFilterAndTag>
    An unordered list of tags that identify a subset of objects to which the rule applies.
    prefix string
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags GetBucketReplicationConfigurationRuleFilterAndTag[]
    An unordered list of tags that identify a subset of objects to which the rule applies.
    prefix str
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags Sequence[GetBucketReplicationConfigurationRuleFilterAndTag]
    An unordered list of tags that identify a subset of objects to which the rule applies.
    prefix String
    The object key name prefix that identifies the subset of objects to which the rule applies.
    tags List<Property Map>
    An unordered list of tags that identify a subset of objects to which the rule applies.

    GetBucketReplicationConfigurationRuleFilterAndTag

    Key string
    The key of the tag.
    Value string
    The value of the tag.
    Key string
    The key of the tag.
    Value string
    The value of the tag.
    key String
    The key of the tag.
    value String
    The value of the tag.
    key string
    The key of the tag.
    value string
    The value of the tag.
    key str
    The key of the tag.
    value str
    The value of the tag.
    key String
    The key of the tag.
    value String
    The value of the tag.

    GetBucketReplicationConfigurationRuleFilterTag

    Key string
    The key of the tag.
    Value string
    The value of the tag.
    Key string
    The key of the tag.
    Value string
    The value of the tag.
    key String
    The key of the tag.
    value String
    The value of the tag.
    key string
    The key of the tag.
    value string
    The value of the tag.
    key str
    The key of the tag.
    value str
    The value of the tag.
    key String
    The key of the tag.
    value String
    The value of the tag.

    GetBucketReplicationConfigurationRuleSourceSelectionCriteria

    GetBucketReplicationConfigurationRuleSourceSelectionCriteriaReplicaModification

    Status string
    Status string
    status String
    status string
    status str
    status String

    GetBucketReplicationConfigurationRuleSourceSelectionCriteriaSseKmsEncryptedObject

    Status string
    Status string
    status String
    status string
    status str
    status String

    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
    Viewing docs for AWS v7.22.0
    published on Wednesday, Mar 11, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.