You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: python/example_code/s3/scenarios/conditional_requests/README.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
2
-
# Amazon S3 Object Lock Workflow for the SDK for Python (boto3)
2
+
# Amazon S3 Conditional Requests Feature Scenario for the SDK for Python (boto3)
3
3
4
4
## Overview
5
5
6
-
This example demonstrates how to use the AWS SDK for Python (boto3) to work with Amazon Simple Storage Service (Amazon S3) object locking features. The workflow shows how to create, update, view, and modify object locks, as well as how locked objects behave regarding requests to delete and overwrite.
6
+
This example demonstrates how to use the AWS SDK for Python (boto3) to work with Amazon Simple Storage Service (Amazon S3) conditional request features. The scenario demonstrates how to add preconditions to S3 operations, and how those operations will succeed or fail based on the conditional requests.
7
7
8
-
[Amazon S3 Object Lock](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html)can help prevent Amazon S3 objects from being deleted or overwritten for a fixed amount of time or indefinitely. Object Lock can help meet regulatory requirements or protect against object changes or deletion.
8
+
[Amazon S3 Conditional Requests](https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html)are used to add preconditions to S3 read, copy, or write requests.
9
9
10
10
## ⚠ Important
11
11
@@ -24,25 +24,25 @@ To run these examples, you need:
24
24
- Run `python pip install -r requirements.txt`
25
25
- AWS credentials configured. For more information, see [Configuring the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).
26
26
27
-
### Scenarios
27
+
### Scenario
28
28
29
-
This example uses a workflow approach to demonstrate various aspects of S3 Object Locking. The workflow is divided into three stages:
29
+
This example uses a feature scenario to demonstrate various aspects of S3 conditional requests. The scenario is divided into three stages:
30
30
31
-
1.**Deploy**: Create buckets with different object locking configurations, populate buckets with objects, and set object lock and retention policies.
32
-
2.**Demo**: Explore S3 locking features by listing objects, attempting to delete or overwrite locked objects, and viewing retention and legal hold settings.
33
-
3.**Clean**: Remove object locks and retention periods, delete all objects and buckets.
31
+
1.**Setup**: Create test buckets and objects.
32
+
2.**Conditional Reads and Writes**: Explore S3 conditional requests by listing objects, attempting to read or write with conditional requests, and viewing request results.
33
+
3.**Clean**: Delete all objects and buckets.
34
34
35
-
#### Running the workflow
36
-
To run this workflow, pull AWS tokens and run the command below:
35
+
#### Running the scenario
36
+
To run this feature scenario, run the command below from this directory:
0 commit comments