.NET v3: S3 Conditional Requests Feature Scenario Follow (#7174)

Author: rlhagerm

.doc_gen/metadata/s3_metadata.yaml

@@ -236,6 +236,10 @@ s3_CopyObject:
             - description:
               snippet_tags:
                 - S3.dotnet35.CopyObject
+            - description: Copy an object using a conditional request.
+              genai: some
+              snippet_tags:
+                - S3ConditionalRequests.dotnetv3.CopyObjectConditional
     C++:
       versions:
         - sdk_version: 1
@@ -854,6 +858,10 @@ s3_GetObject:
             - description:
               snippet_tags:
                 - S3.dotnetv3.S3_Basics-DownloadObject
+            - description: Get an object using a conditional request.
+              genai: some
+              snippet_tags:
+                - S3ConditionalRequests.dotnetv3.GetObjectConditional
     C++:
       versions:
         - sdk_version: 1
@@ -1491,6 +1499,10 @@ s3_PutObject:
             - description: Upload an object with server-side encryption.
               snippet_tags:
                 - S3.dotnetv3.ServerSideEncryptionExample
+            - description: Put an object using a conditional request.
+              genai: some
+              snippet_tags:
+                - S3ConditionalRequests.dotnetv3.PutObjectConditional
     C++:
       versions:
         - sdk_version: 1
@@ -3593,6 +3605,18 @@ s3_Scenario_ConditionalRequests:
               genai: some
               snippet_tags:
                 - python.example_code.s3.S3ConditionalRequests.wrapper
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/S3/scenarios/S3ConditionalRequestsScenario
+          sdkguide:
+          excerpts:
+            - description: Run an interactive scenario demonstrating &S3; conditional request features.
+              snippet_tags:
+                - S3ConditionalRequests.dotnetv3.Scenario
+            - description: A wrapper class for S3 functions.
+              snippet_tags:
+                - S3ConditionalRequests.dotnetv3.S3ActionsWrapper
   services:
     s3: {GetObject, PutObject, CopyObject}
 s3_Scenario_DownloadS3Directory:

dotnetv3/S3/README.md

@@ -84,6 +84,7 @@ functions within the same service.
 - [Get started with encryption](SSEClientEncryptionExample/SSEClientEncryption.cs)
 - [Get started with tags](ObjectTagExample/ObjectTag.cs)
 - [Lock Amazon S3 objects](scenarios/S3ObjectLockScenario/S3ObjectLockWorkflow/S3ObjectLockWorkflow.cs)
+- [Make conditional requests](scenarios/S3ConditionalRequestsScenario/S3ConditionalRequests/S3ConditionalRequestsScenario.cs)
 - [Manage access control lists (ACLs)](ManageACLsExample/ManageACLs.cs)
 - [Perform a multipart copy](MPUapiCopyObjExample/MPUapiCopyObj.cs)
 - [Transform data with S3 Object Lambda](../cross-service/S3ObjectLambdaFunction)
@@ -209,6 +210,18 @@ This example shows you how to work with S3 object lock features.
 <!--custom.scenarios.s3_Scenario_ObjectLock.start-->
 <!--custom.scenarios.s3_Scenario_ObjectLock.end-->
 
+#### Make conditional requests
+
+This example shows you how to add preconditions to Amazon S3 requests.
+
+
+<!--custom.scenario_prereqs.s3_Scenario_ConditionalRequests.start-->
+<!--custom.scenario_prereqs.s3_Scenario_ConditionalRequests.end-->
+
+
+<!--custom.scenarios.s3_Scenario_ConditionalRequests.start-->
+<!--custom.scenarios.s3_Scenario_ConditionalRequests.end-->
+
 #### Manage access control lists (ACLs)
 
 This example shows you how to manage access control lists (ACLs) for Amazon S3 buckets.
@@ -283,4 +296,4 @@ in the `dotnetv3` folder.
 
 Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 
-SPDX-License-Identifier: Apache-2.0
+SPDX-License-Identifier: Apache-2.0

dotnetv3/S3/scenarios/S3ConditionalRequestsScenario/README.md

@@ -0,0 +1,51 @@
+# Amazon S3 Conditional Requests Feature Scenario for the SDK for .NET
+
+## Overview
+
+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.
+
+[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.
+
+## ⚠ Important
+
+* Running this code might result in charges to your AWS account.
+* Running the tests might result in charges to your AWS account.
+* We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see [Grant least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege).
+* This code is not tested in every AWS Region. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services).
+
+## Scenario
+
+This example uses a feature scenario to demonstrate various aspects of S3 conditional requests. The scenario is divided into three stages:
+
+1. **Setup**: Create test buckets and objects.
+2. **Conditional Reads and Writes**: Explore S3 conditional requests by listing objects, attempting to read or write with conditional requests, and viewing request results.
+3. **Clean**: Delete all objects and buckets.
+
+### Prerequisites
+
+For general prerequisites, see the [README](../../../README.md) in the `dotnetv3` folder.
+
+### Resources
+
+The scenario steps create the buckets and objects needed for the example. No additional resources are required.
+
+### Instructions
+
+After the example compiles, you can run it from the command line. To do so, navigate to
+the folder that contains the .sln file and run the following command:
+
+```
+dotnet run
+```
+
+Alternatively, you can run the example from within your IDE.
+
+This starts an interactive scenario that walks you through exploring conditional requests for read, write, and copy operations.
+
+## Additional resources
+
+- [Amazon S3 Developer Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html)
+
+---
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0

dotnetv3/S3/scenarios/S3ConditionalRequestsScenario/S3ConditionalRequests/Enums.cs

@@ -0,0 +1,12 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 
+// SPDX-License-Identifier: Apache-2.0
+
+namespace S3ConditionalRequestsScenario;
+
+public enum S3ConditionType
+{
+    IfMatch,
+    IfNoneMatch,
+    IfModifiedSince,
+    IfUnmodifiedSince
+}