pulumi-alicloud-kotlin/com.pulumi.alicloud.oss.kotlin/BucketReplication

BucketReplication

class BucketReplication : KotlinCustomResource

Provides an independent replication configuration resource for OSS bucket. For information about OSS replication and how to use it, see What is cross-region replication and What is same-region replication.

NOTE: Available in v1.161.0+.

Example Usage

Set bucket replication configuration

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.oss.BucketReplication;
import com.pulumi.alicloud.oss.BucketReplicationArgs;
import com.pulumi.alicloud.oss.inputs.BucketReplicationDestinationArgs;
import com.pulumi.alicloud.oss.inputs.BucketReplicationPrefixSetArgs;
import com.pulumi.alicloud.oss.inputs.BucketReplicationEncryptionConfigurationArgs;
import com.pulumi.alicloud.oss.inputs.BucketReplicationSourceSelectionCriteriaArgs;
import com.pulumi.alicloud.oss.inputs.BucketReplicationSourceSelectionCriteriaSseKmsEncryptedObjectsArgs;
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 cross_region_replication = new BucketReplication("cross-region-replication", BucketReplicationArgs.builder()
            .action("ALL")
            .bucket("bucket-in-hangzhou")
            .destination(BucketReplicationDestinationArgs.builder()
                .bucket("bucket-in-beijing")
                .location("oss-cn-beijing")
                .build())
            .build());
        var same_region_replication = new BucketReplication("same-region-replication", BucketReplicationArgs.builder()
            .action("ALL")
            .bucket("bucket-in-hangzhou")
            .destination(BucketReplicationDestinationArgs.builder()
                .bucket("bucket-in-hangzhou-1")
                .location("oss-cn-hangzhou")
                .build())
            .build());
        var replication_with_prefix = new BucketReplication("replication-with-prefix", BucketReplicationArgs.builder()
            .action("ALL")
            .bucket("bucket-1")
            .destination(BucketReplicationDestinationArgs.builder()
                .bucket("bucket-2")
                .location("oss-cn-hangzhou")
                .build())
            .historicalObjectReplication("disabled")
            .prefixSet(BucketReplicationPrefixSetArgs.builder()
                .prefixes(
                    "prefix1/",
                    "prefix2/")
                .build())
            .build());
        var replication_with_specific_action = new BucketReplication("replication-with-specific-action", BucketReplicationArgs.builder()
            .action("PUT")
            .bucket("bucket-1")
            .destination(BucketReplicationDestinationArgs.builder()
                .bucket("bucket-2")
                .location("oss-cn-hangzhou")
                .build())
            .historicalObjectReplication("disabled")
            .build());
        var replication_with_kms_encryption = new BucketReplication("replication-with-kms-encryption", BucketReplicationArgs.builder()
            .action("ALL")
            .bucket("bucket-1")
            .destination(BucketReplicationDestinationArgs.builder()
                .bucket("bucket-2")
                .location("oss-cn-hangzhou")
                .build())
            .encryptionConfiguration(BucketReplicationEncryptionConfigurationArgs.builder()
                .replicaKmsKeyId("<your kms key id>")
                .build())
            .historicalObjectReplication("disabled")
            .sourceSelectionCriteria(BucketReplicationSourceSelectionCriteriaArgs.builder()
                .sseKmsEncryptedObjects(BucketReplicationSourceSelectionCriteriaSseKmsEncryptedObjectsArgs.builder()
                    .status("Enabled")
                    .build())
                .build())
            .syncRole("<your ram role>")
            .build());
    }
}

Import

Timeouts The `timeouts` block allows you to specify timeouts for certain actions* `delete` - (Defaults to 30 mins) Used when delete a data replication rule (until the data replication task is cleared).

Properties

action

val action: Output<String>?

The operations that can be synchronized to the destination bucket. You can set action to one or more of the following operation types. Valid values: ALL(contains PUT, DELETE, and ABORT), PUT, DELETE and ABORT. Defaults to ALL.

bucket

val bucket: Output<String>

The name of the bucket.

destination

val destination: Output<BucketReplicationDestination>

Specifies the destination for the rule(See the following block destination).

encryptionConfiguration

val encryptionConfiguration: Output<BucketReplicationEncryptionConfiguration>?

Specifies the encryption configuration for the objects replicated to the destination bucket(See the following block encryption_configuration).

historicalObjectReplication

val historicalObjectReplication: Output<String>?

Specifies whether to replicate historical data from the source bucket to the destination bucket before data replication is enabled. Can be enabled or disabled. Defaults to enabled.

val id: Output<String>

prefixSet

val prefixSet: Output<BucketReplicationPrefixSet>?

The prefixes used to specify the object to replicate. Only objects that match the prefix are replicated to the destination bucket(See the following block prefix_set).

progress

val progress: Output<BucketReplicationProgress>

Retrieves the progress of the data replication task. This status is returned only when the data replication task is in the doing state.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

ruleId

val ruleId: Output<String>

The ID of the data replication rule.

sourceSelectionCriteria

val sourceSelectionCriteria: Output<BucketReplicationSourceSelectionCriteria>?

Specifies other conditions used to filter the source objects to replicate(See the following block source_selection_criteria).

status

val status: Output<String>

Specifies whether to replicate objects encrypted by using SSE-KMS. Can be Enabled or Disabled.

syncRole

val syncRole: Output<String>?

Specifies the role that you authorize OSS to use to replicate data. If SSE-KMS is specified to encrypt the objects replicated to the destination bucket, it must be specified.

urn

val urn: Output<String>

BucketReplication

Example Usage

Import

Timeouts The timeouts block allows you to specify timeouts for certain actions* delete - (Defaults to 30 mins) Used when delete a data replication rule (until the data replication task is cleared).

Properties

Timeouts The `timeouts` block allows you to specify timeouts for certain actions* `delete` - (Defaults to 30 mins) Used when delete a data replication rule (until the data replication task is cleared).