这个项目能做什么

该仓库由 AWS 维护,收集了展示如何使用 AWS SDK 与 AWS 服务交互的代码示例。许多示例被直接注入到 AWS 官方文档和 SDK 开发者指南中。 内容按语言和 SDK 版本组织。每种语言都有自己的子目录,部分语言为较旧和较新的 SDK 代际分别设置了文件夹: - .NET:dotnetv3(SDK 3.5+)和 dotnet(3.5 以下) - C++:cpp(SDK 1) - Go:gov2(SDK 2)和 go(SDK 1) - Java:javav2(SDK 2)和 java(SDK 1) - JavaScript:javascriptv3(SDK 3)和 javascript(SDK 2) - Kotlin:kotlin(SDK 1) - PHP:php(SDK 3) - Python:pythonv4(SDK 4)和 python(SDK 3) - Ruby:ruby(SDK 3) - Rust:rustv1(SDK 1) - Swift:swift(预览版) 每个目录都包含特定于 SDK 的说明,用于理解和运行示例。README 指出,AWS SDK for Java v1.x 已于 2024 年 7 月 31 日进入维护模式,并将于 2025 年 12 月 31 日结束支持。 除按语言划分的文件夹外,还有其他目录: - applications:示例应用中与语言无关的组件,展示 SDK 在生产级场景中的使用。与语言相关的部分位于各语言的 cross-service 文件夹中。 - test:支持自定义测试自动化框架的组件,该框架会定期测试仓库代码,并作为基于多语言容器的集成测试解决方案部署到 AWS。README 指出,截至 2023 年,该部分仍在积极建设中。 - resources:许多示例使用的共享组件,作为前端客户端或后端 CDK/CloudFormation 组件部署。 运行这些示例需要 AWS 账户并配置 AWS 凭证,例如通过 AWS CLI 配置。README 包含使用免责声明:示例会与可能产生费用的服务交互,并可能创建或删除 AWS 资源。它建议用户注意已创建或删除的资源、潜在费用,并备份重要数据。 欢迎通过 CONTRIBUTING.md 指南贡献代码。示例请求可通过 issue tracker 使用增强模板提交。团队会根据清晰度、相关性和可行性评估请求,并要求尽早提出请求,对于较大的示例,最好至少提前两个月。错误修复和安全问题优先于新示例,同时附上高质量的 pull request 会提高请求得到处理的机会。 README 还提到了“tributaries”:即代码示例流入 AWS 文档的其他来源,包括本仓库、aws-samples/serverless-snippets 和 aws/aws-tools-for-powershell。 许可:内容版权归 Amazon Web Services, Inc. 或其关联公司所有。除非另有说明,示例均根据 Apache License 2.0 许可,完整文本见 LICENSE 文件。README 要求贡献者在可能的情况下,在文件顶部包含版权声明和 SPDX-License-Identifier: Apache-2.0 注释。