AWS code-library documentation change
Summary
Added PowerShell V5 examples for configuring S3 bucket replication rules
Security assessment
Focuses on data replication configuration without security-specific content or vulnerability references.
Diff
diff --git a/code-library/latest/ug/s3_example_s3_PutBucketReplication_section.md b/code-library/latest/ug/s3_example_s3_PutBucketReplication_section.md index 82160efb9..6b5a771c8 100644 --- a//code-library/latest/ug/s3_example_s3_PutBucketReplication_section.md +++ b//code-library/latest/ug/s3_example_s3_PutBucketReplication_section.md @@ -265,0 +266,68 @@ PowerShell +**Tools for PowerShell V5** + + +**Example 1: This example sets a replication configuration with a single rule enabling replication to the 'amzn-s3-demo-bucket' bucket any new objects created with the key name prefix "TaxDocs" in the bucket 'amzn-s3-demo-bucket'.** + + + $rule1 = New-Object Amazon.S3.Model.ReplicationRule + $rule1.ID = "Rule-1" + $rule1.Status = "Enabled" + $rule1.Prefix = "TaxDocs" + $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } + + $params = @{ + BucketName = "amzn-s3-demo-bucket" + Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" + Configuration_Rule = $rule1 + } + + Write-S3BucketReplication @params + + +**Example 2: This example sets a replication configuration with multiple rules enabling replication to the 'amzn-s3-demo-bucket' bucket any new objects created with either the key name prefix "TaxDocs" or "OtherDocs". The key prefixes must not overlap.** + + + $rule1 = New-Object Amazon.S3.Model.ReplicationRule + $rule1.ID = "Rule-1" + $rule1.Status = "Enabled" + $rule1.Prefix = "TaxDocs" + $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } + + $rule2 = New-Object Amazon.S3.Model.ReplicationRule + $rule2.ID = "Rule-2" + $rule2.Status = "Enabled" + $rule2.Prefix = "OtherDocs" + $rule2.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } + + $params = @{ + BucketName = "amzn-s3-demo-bucket" + Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" + Configuration_Rule = $rule1,$rule2 + } + + Write-S3BucketReplication @params + + +**Example 3: This example updates the replication configuration on the specified bucket to disable the rule controlling replication of objects with the key name prefix "TaxDocs" to the bucket 'amzn-s3-demo-bucket'.** + + + $rule1 = New-Object Amazon.S3.Model.ReplicationRule + $rule1.ID = "Rule-1" + $rule1.Status = "Disabled" + $rule1.Prefix = "TaxDocs" + $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } + + $params = @{ + BucketName = "amzn-s3-demo-bucket" + Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" + Configuration_Rule = $rule1 + } + + Write-S3BucketReplication @params + + + * For API details, see [PutBucketReplication](https://docs.aws.amazon.com/powershell/v5/reference) in _AWS Tools for PowerShell Cmdlet Reference (V5)_. + + + +