O OpenAPI Portal não oferece mais suporte ao SDK V1.0. Se você usa o SDK V1.0, consulte a documentação para acessar os guias de migração.
Para obter assistência, participe do nosso grupo no DingTalk (ID: 60965016010).
1. Visão geral
Os SDKs da Alibaba Cloud seguem políticas de manutenção que abrangem lançamentos de versões, atualizações e fim de suporte.
2. Ciclo de vida e políticas de manutenção
Os SDKs da Alibaba Cloud passam por três estágios de ciclo de vida: disponibilidade geral, manutenção básica de segurança e fim de suporte.
|
Estágio do ciclo de vida |
Política de manutenção |
Cobertura de API e ciclo de lançamento |
Recomendação |
Suporte em plataformas da Alibaba Cloud, como Help Center e OpenAPI Portal |
Suporte em plataformas de terceiros, como repositórios de código hospedados e comunidades |
|
Estágio de disponibilidade geral
|
Novos recursos, otimizações de desempenho, correções de bugs e patches de segurança. |
Suporte a todas as operações de API. Atualização automática em até 24 horas após o lançamento da API. |
Recomendado para todos os usuários e projetos. |
Marcado como Recommend. Documentação completa e código de exemplo disponíveis, com atualizações frequentes. |
Marcado como Recommend. |
|
Estágio de manutenção básica de segurança |
Sem novos recursos. Apenas patches de segurança e correções críticas de estabilidade. |
Cobertura de API não garantida. Atualizações para novas operações de API ocorrem apenas quando necessário. |
Adequado apenas para sistemas estáveis. Não recomendado para novos projetos ou iniciantes. |
Marcado como Not recommend. Documentação e código de exemplo disponíveis, mas sem garantia de atualizações. Referências de migração disponíveis para orientar a atualização para as versões mais recentes do SDK. |
Marcado como Not recommend. Referências de migração disponíveis para orientar os usuários a atualizar ou adotar as versões mais recentes do SDK. |
|
Estágio de fim de suporte
|
Nenhum tipo de atualização, incluindo patches de segurança. Relatórios de problemas não aceitos. |
Não haverá novos lançamentos do SDK. |
Não recomendado. Migre os sistemas existentes para as versões mais recentes do SDK para garantir continuidade dos negócios e segurança. |
SDKs desativados ou ocultados de todos os pontos de entrada. |
Marcado como End-of-support. Referências de migração disponíveis para orientar os usuários a atualizar ou adotar as versões mais recentes do SDK. Relatórios de problemas não aceitos. |
3. Política de lançamento
Os pacotes do SDK estão disponíveis em gerenciadores de pacotes oficiais, como Maven, npm, PyPI, NuGet, CocoaPods e Packagist. O código source é publicado no GitHub. Para mais informações, consulte a Matriz de suporte a versões do SDK.
3,1 Gerações do SDK da Alibaba Cloud
A Alibaba Cloud oferece duas gerações de SDK: V1.0 e V2.0. A versão V2.0 resolve problemas da V1.0 e adiciona recursos que simplificam o uso, reduzem custos e aumentam a robustez. Para saber mais sobre as diferenças entre o SDK da Alibaba Cloud V1.0 e V2.0, consulte SDK da Alibaba Cloud V1.0 e V2.0.
As políticas de manutenção estão descritas na seção Ciclo de vida e políticas de manutenção. Para detalhes sobre o status de fim de suporte dos SDKs de cada geração em diferentes linguagens, veja a Matriz de suporte a versões do SDK.
3,2 Especificação de numeração de versão
Os números de versão de todas as gerações do SDK seguem a Especificação de Versionamento Semântico.
|
O número de versão segue o formato Major.Minor.Patch.
|
Um incremento na versão major indica alterações disruptivas nas interfaces públicas, como nomes de classes, métodos, parâmetros, tipos de parâmetros ou semântica. Após o lançamento de uma versão major, atualize seu cliente para o SDK mais recente. Verifique o relatório de lançamento do SDK para obter detalhes sobre a atualização, como o Release Report do ECS SDK for Java V3.1.17.
3,3 Garantia de compatibilidade
Os SDKs V1.0 e V2.0 não são compatíveis entre si. Para saber como atualizar o SDK da Alibaba Cloud V1.0 para V2.0, consulte Atualizar o SDK da Alibaba Cloud V1.0 para V2.0.
Dentro da mesma geração, os SDKs seguem a Especificação de Versionamento Semântico. Versões minor e patch mantêm compatibilidade com versões anteriores. Apenas versões major podem introduzir alterações disruptivas.
4. Política de atualização
A Alibaba Cloud atualiza regularmente os SDKs e suas dependências. As dependências de terceiros dividem-se em três categorias:
Sistemas operacionais como CentOS 7, Windows 7, Windows 10 e macOS 12.x
Runtimes de linguagem como Java 8, Java 11, .NET Core, PHP7, PHP8 e Node.js 14.x
Bibliotecas e frameworks de terceiros como OpenSSL, .NET Framework 4.5 e Java EE
A comunidade da linguagem ou o fornecedor gerencia o ciclo de vida de cada dependência e publica seu próprio cronograma de fim de vida útil.
Políticas de manutenção das comunidades de linguagem:
Node.js: github.com
Python: devguide.python.org
Ruby: www.ruby-lang.org
Java: www.oracle.com
Go: golang.org
.NET Core: dotnet.microsoft.com
PHP: www.php.net
Após uma comunidade ou fornecedor encerrar o suporte a uma versão da linguagem, a Alibaba Cloud continua a oferecer suporte a essa versão nos SDKs por pelo menos um ano.
Uma versão de linguagem refere-se a um lançamento específico de uma linguagem de programação, como Java 8 ou Python 3.7.
5. Política de fim de suporte
5,1 Ponto de gatilho
Quando a comunidade de uma linguagem anuncia o fim do suporte para uma versão ou dependência, a Alibaba Cloud emite um aviso de fim de suporte dentro de aproximadamente um ano e encerra o suporte seis meses depois. Os SDKs existentes continuam funcionando, mas não recebem patches de segurança nem novos recursos.
5,2 Conteúdo do anúncio
Motivos específicos para o encerramento do suporte
Data específica para o fim do suporte
Passos para continuar usando os SDKs existentes e atualizar para versões suportadas
Referências de migração
5,3 Métodos de notificação
A Alibaba Cloud explica o motivo do fim do suporte e notifica os usuários pelos seguintes canais:
Publicação de um anúncio de fim de suporte com um ano de antecedência por meio das referências do SDK no OpenAPI Portal e no Help Center, além do envio de mensagens internas no OpenAPI Portal e no console da Alibaba Cloud.
Disponibilização de referências de migração no OpenAPI Portal e no Help Center.
Inclusão de avisos internos no SDK para algumas linguagens. Por exemplo, um alerta é exibido ao instalar uma versão do SDK sem suporte.