Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
113 changes: 102 additions & 11 deletions .doc_gen/metadata/s3-control_metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,15 @@ s3-control_Hello:
- description:
snippet_tags:
- s3control.java2.list_jobs.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.list_jobs
services:
s3-control: {ListJobs}

Expand All @@ -29,15 +38,24 @@ s3-control_CreateJob:
- s3control.java2.create_job.async.main
- description: Create a compliance retention job.
snippet_tags:
- s3control.java2.create_job.compliance.main
- s3control.java2.create_job.compliance.main
- description: Create a legal hold off job.
snippet_tags:
- s3control.java2.create_job.compliance.main
- s3control.java2.create_job.compliance.main
- description: Create a new governance retention job.
snippet_tags:
- s3.java2.create_governance_retemtion.main
- s3.java2.create_governance_retemtion.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.create_job
services:
s3-control: {CreateJob}
s3-control: {CreateJob}
s3-control_PutJobTagging:
languages:
Java:
Expand All @@ -49,8 +67,17 @@ s3-control_PutJobTagging:
- description:
snippet_tags:
- s3control.java2.job.put.tags.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.put_job_tagging
services:
s3-control: {PutJobTagging}
s3-control: {PutJobTagging}
s3-control_DescribeJob:
languages:
Java:
Expand All @@ -62,8 +89,17 @@ s3-control_DescribeJob:
- description:
snippet_tags:
- s3control.java2.describe_job.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.describe_job
services:
s3-control: {DescribeJob}
s3-control: {DescribeJob}
s3-control_DeleteJobTagging:
languages:
Java:
Expand All @@ -75,8 +111,17 @@ s3-control_DeleteJobTagging:
- description:
snippet_tags:
- s3control.java2.del_job_tagging.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.delete_job_tagging
services:
s3-control: {DeleteJobTagging}
s3-control: {DeleteJobTagging}
s3-control_GetJobTagging:
languages:
Java:
Expand All @@ -88,8 +133,17 @@ s3-control_GetJobTagging:
- description:
snippet_tags:
- s3control.java2.get_job_tagging.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.get_job_tagging
services:
s3-control: {GetJobTagging}
s3-control: {GetJobTagging}
s3-control_UpdateJobStatus:
languages:
Java:
Expand All @@ -101,8 +155,17 @@ s3-control_UpdateJobStatus:
- description:
snippet_tags:
- s3control.java2.cancel_job.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.update_job_status
services:
s3-control: {UpdateJobStatus}
s3-control: {UpdateJobStatus}
s3-control_UpdateJobPriority:
languages:
Java:
Expand All @@ -114,8 +177,17 @@ s3-control_UpdateJobPriority:
- description:
snippet_tags:
- s3control.java2.update_job.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description:
snippet_tags:
- python.example_code.s3control.update_job_priority
services:
s3-control: {UpdateJobPriority}
s3-control: {UpdateJobPriority}
s3-control_Basics:
synopsis: learn core operations for &S3Control;.
category: Basics
Expand All @@ -132,5 +204,24 @@ s3-control_Basics:
- description: An action class that wraps operations.
snippet_tags:
- s3control.java2.job.actions.main
Python:
versions:
- sdk_version: 3
github: python/example_code/s3/scenarios/batch
sdkguide:
excerpts:
- description: Learn S3 Batch Basics Scenario.
snippet_tags:
- python.example_code.s3control.helper.S3BatchScenario
services:
s3-control: {CreateJob, DeleteJobTagging, DescribeJob, GetJobTagging, ListJobs, PutJobTagging, UpdateJobPriority, UpdateJobStatus}
s3-control:
{
CreateJob,
DeleteJobTagging,
DescribeJob,
GetJobTagging,
ListJobs,
PutJobTagging,
UpdateJobPriority,
UpdateJobStatus,
}
2 changes: 1 addition & 1 deletion javav2/example_code/dynamodb/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,4 +160,4 @@ in the `javav2` folder.

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0
SPDX-License-Identifier: Apache-2.0
29 changes: 29 additions & 0 deletions javav2/example_code/dynamodb/adaptive_retry_docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# AWS Java SDK AdaptiveRetryStrategy Guide

This guide provides comprehensive documentation and examples for implementing AWS Java SDK's `AdaptiveRetryStrategy` with AWS service clients.

> **⚠️ Important**: AdaptiveRetryStrategy is designed for specialized use cases with high resource constraints and single-resource clients. AWS recommends StandardRetryStrategy for most applications.

## Documentation Structure

| Document | Purpose | When to Use |
|----------|---------|-------------|
| **[Concepts](concepts.md)** | Conceptual foundation and theory | Understanding when/why to use AdaptiveRetryStrategy |
| **[Migration Guide](migration-guide.md)** | Step-by-step migration instructions | Converting from older retry policies |
| **[Configuration Reference](configuration-reference.md)** | Complete parameter reference | Fine-tuning and optimization |

## Getting Started

1. **Quick Start**: Check the `examples/` directory for ready-to-use code
2. **Learn Concepts**: Read [Concepts](concepts.md) to understand when AdaptiveRetryStrategy is appropriate
3. **Migration**: Use [Migration Guide](migration-guide.md) if converting existing code
4. **Fine-tuning**: Consult [Configuration Reference](configuration-reference.md) for parameter optimization

## Documentation Sources

This guide is based on official AWS SDK for Java 2.x documentation and follows AWS best practices as documented in:

- [AWS SDK for Java 2.x Developer Guide - Configure retry behavior](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/retry-strategy.html)
- [AWS SDK for Java 2.x API Reference](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/retries/package-summary.html)

All examples and recommendations align with AWS's official guidance on retry strategy implementation.
Loading