Skip to content

Commit 9383cf8

Browse files
committed
Document required S3 bucket policy
Signed-off-by: Andreas Lindhé <7773090+lindhe@users.noreply.github.com>
1 parent d1ca8ed commit 9383cf8

1 file changed

Lines changed: 40 additions & 0 deletions

File tree

web/docs/object_stores.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,46 @@ These strategies help you safeguard backups without requiring broad delete
129129
permissions, ensuring both security and compliance with minimal operational
130130
overhead.
131131

132+
### S3 Lifecycle Policy
133+
134+
Barman Cloud requires the following permissions in the S3 bucket:
135+
136+
- [`s3:AbortMultipartUpload`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
137+
- [`s3:CreateBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
138+
- [`s3:DeleteObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
139+
- [`s3:GetObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
140+
- [`s3:ListBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)
141+
- [`s3:PutObject`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
142+
143+
Here's an example of what such a bucket policy may look like:
144+
145+
```json
146+
{
147+
"Statement": [
148+
{
149+
"Action": [
150+
"s3:AbortMultipartUpload",
151+
"s3:CreateBucket",
152+
"s3:DeleteObject",
153+
"s3:GetObject",
154+
"s3:ListBucket",
155+
"s3:PutObject"
156+
],
157+
"Effect": "Allow",
158+
"Principal": {
159+
"AWS": "arn:aws:iam::123456789012:user/MaryMajor"
160+
},
161+
"Resource": [
162+
"arn:aws:s3:::amzn-s3-demo-bucket1",
163+
"arn:aws:s3:::amzn-s3-demo-bucket1/*"
164+
],
165+
"Sid": "statement1",
166+
}
167+
],
168+
"Version":"2012-10-17"
169+
}
170+
```
171+
132172
### S3-Compatible Storage Providers
133173

134174
You can use S3-compatible services like **MinIO**, **Linode (Akamai) Object Storage**,

0 commit comments

Comments
 (0)