Sobre o projeto

Este repositório é mantido pela AWS e reúne exemplos de código que mostram como usar os SDKs da AWS para interagir com os serviços da AWS. Muitos dos exemplos são injetados diretamente na documentação oficial da AWS e nos guias de desenvolvedor dos SDKs. A organização é por linguagem e versão do SDK. Cada linguagem tem seu próprio subdiretório, e algumas linguagens têm pastas separadas para gerações mais antigas e mais novas do SDK: - .NET: dotnetv3 (SDK 3.5+) e dotnet (abaixo de 3.5) - C++: cpp (SDK 1) - Go: gov2 (SDK 2) e go (SDK 1) - Java: javav2 (SDK 2) e java (SDK 1) - JavaScript: javascriptv3 (SDK 3) e javascript (SDK 2) - Kotlin: kotlin (SDK 1) - PHP: php (SDK 3) - Python: pythonv4 (SDK 4) e python (SDK 3) - Ruby: ruby (SDK 3) - Rust: rustv1 (SDK 1) - Swift: swift (preview) Cada diretório contém instruções específicas do SDK para entender e executar os exemplos. O README observa que o AWS SDK for Java v1.x entrou em modo de manutenção em 31 de julho de 2024 e chega ao fim do suporte em 31 de dezembro de 2025. Além das pastas por linguagem, há diretórios adicionais: - applications: componentes não específicos de linguagem de aplicações de exemplo que mostram o uso do SDK em cenários semelhantes aos de produção. As partes específicas de linguagem ficam na pasta cross-service de cada linguagem. - test: componentes que suportam um framework personalizado de automação de testes que testa rotineiramente o código do repositório, implantado na AWS como uma solução de teste de integração baseada em contêineres e poliglota. O README marca isso como ainda em construção ativa em 2023. - resources: componentes compartilhados usados por muitos exemplos, implantados como clientes frontend ou componentes backend em CDK/CloudFormation. Executar os exemplos exige uma conta da AWS e credenciais da AWS configuradas, por exemplo via AWS CLI. O README inclui um aviso de uso: os exemplos interagem com serviços que podem gerar cobranças e podem criar ou excluir recursos da AWS. Ele orienta os usuários a estarem cientes dos recursos criados ou excluídos, dos custos potenciais e a fazer backup de dados importantes. Contribuições são bem-vindas por meio do guia CONTRIBUTING.md. Solicitações de exemplos podem ser registradas pelo issue tracker usando um template de enhancement. A equipe avalia as solicitações quanto a clareza, relevância e viabilidade, e pede que as solicitações sejam feitas o mais cedo possível, idealmente com pelo menos dois meses de antecedência para exemplos maiores. Correções de bugs e problemas de segurança têm prioridade sobre novos exemplos, e um pull request de alta qualidade que o acompanhe aumenta a chance de uma solicitação ser atendida. O README também menciona "tributaries": fontes adicionais cujos exemplos de código fluem para a documentação da AWS, incluindo este repositório, aws-samples/serverless-snippets e aws/aws-tools-for-powershell. Licenciamento: o conteúdo é copyright da Amazon Web Services, Inc. ou de suas afiliadas. Salvo indicação em contrário, os exemplos são licenciados sob a Apache License 2.0, com o texto completo no arquivo LICENSE. O README pede que os contribuidores incluam um comentário de copyright e SPDX-License-Identifier: Apache-2.0 no topo dos arquivos quando possível.