OpenAPI Portal ne prend plus en charge le SDK V1.0. Si vous utilisez le SDK V1.0, consultez la documentation pour accéder aux guides de migration.
Pour obtenir de l'aide, rejoignez notre groupe DingTalk (ID : 60965016010).
1. Présentation
Les SDK d'Alibaba Cloud suivent des politiques de maintenance qui couvrent les publications de versions, les mises à jour et la fin de prise en charge.
2. Cycle de vie et politiques de maintenance
Les SDK d'Alibaba Cloud passent par trois phases de cycle de vie : disponibilité générale, maintenance de sécurité de base et fin de prise en charge.
|
Phase du cycle de vie |
Politique de maintenance |
Couverture API et cycle de publication |
Recommandation |
Prise en charge sur les plateformes Alibaba Cloud, telles que Help Center et OpenAPI Portal |
Prise en charge sur les plateformes tierces, telles que les dépôts de code hébergés et les communautés |
|
Phase de disponibilité générale
|
Nouvelles fonctionnalités, optimisations des performances, corrections de bogues et correctifs de sécurité. |
Toutes les opérations API sont prises en charge. Mise à jour automatique dans les 24 heures suivant la publication de l'API. |
Recommandé pour tous les utilisateurs et projets. |
Marqué comme Recommend. Documentation complète et exemples de code fournis, avec des mises à jour régulières. |
Marqué comme Recommend. |
|
Phase de maintenance de sécurité de base |
Aucune nouvelle fonctionnalité. Uniquement des correctifs de sécurité et des corrections de bogues critiques de stabilité. |
La couverture API n'est pas garantie. Les mises à jour pour les nouvelles opérations API sont effectuées uniquement si nécessaire. |
Convient uniquement aux systèmes stables. Déconseillé pour les nouveaux projets ou les débutants. |
Marqué comme Not recommend. Documentation et exemples de code fournis, mais les mises à jour ne sont pas garanties. Références de migration fournies pour guider la mise à niveau vers les dernières versions du SDK. |
Marqué comme Not recommend. Références de migration fournies pour guider les utilisateurs vers la mise à niveau ou l'adoption des dernières versions du SDK. |
|
Phase de fin de prise en charge
|
Aucune mise à jour, y compris les correctifs de sécurité. Aucun signalement de problème n'est accepté. |
Plus aucune publication de SDK. |
Déconseillé. Migrez les systèmes existants vers les dernières versions du SDK pour garantir la continuité des activités et la sécurité. |
Les SDK sont mis hors ligne ou masqués de tous les points d'accès. |
Marqué comme End-of-support. Références de migration fournies pour guider les utilisateurs vers la mise à niveau ou l'adoption des dernières versions du SDK. Aucun signalement de problème n'est accepté. |
3. Politique de publication
Les packages SDK sont publiés sur des gestionnaires de packages officiels tels que Maven, npm, PyPI, NuGet, CocoaPods et Packagist. Le code source est publié sur GitHub. Pour plus d'informations, consultez Matrice de prise en charge des versions SDK.
3,1 Générations des SDK Alibaba Cloud
Alibaba Cloud propose deux générations de SDK : V1.0 et V2.0. La version V2.0 résout les problèmes de la V1.0 et ajoute des fonctionnalités qui simplifient l'utilisation, réduisent les coûts et améliorent la robustesse. Pour plus d'informations sur les différences entre les SDK Alibaba Cloud V1.0 et V2.0, consultez SDK Alibaba Cloud V1.0 et V2.0.
Les politiques de maintenance sont décrites dans la section Cycle de vie et politiques de maintenance. Pour plus d'informations sur l'état de fin de prise en charge des SDK de chaque génération dans différents langages, consultez Matrice de prise en charge des versions SDK.
3,2 Spécification des numéros de version
Les numéros de version de toutes les générations de SDK suivent la Spécification de gestion sémantique de version.
|
Un numéro de version suit le format Major.Minor.Patch.
|
Une incrémentation de version majeure indique des changements cassants dans les interfaces publiques, tels que les noms de classes, les noms de méthodes, les noms de paramètres, les types de paramètres ou la sémantique. Après la publication d'une version majeure, mettez à jour votre client vers le dernier SDK. Consultez le rapport de publication du SDK pour obtenir les détails de la mise à niveau, comme le Rapport de publication pour le SDK ECS pour Java V3.1.17.
3,3 Garantie de compatibilité
Les SDK V1.0 et V2.0 ne sont pas compatibles. Pour plus d'informations sur la mise à niveau du SDK Alibaba Cloud V1.0 vers la V2.0, consultez Mettre à niveau le SDK Alibaba Cloud V1.0 vers la V2.0.
Au sein d'une même génération, les SDK suivent la Spécification de gestion sémantique de version. Les versions mineures et les correctifs sont rétrocompatibles. Seules les versions majeures peuvent introduire des changements cassants.
4. Politique de mise à jour
Alibaba Cloud met régulièrement à jour les SDK et leurs dépendances. Les dépendances tierces se divisent en trois catégories :
Systèmes d'exploitation tels que CentOS 7, Windows 7, Windows 10 et macOS 12.x
Environnements d'exécution de langage tels que Java 8, Java 11, .NET Core, PHP7, PHP8 et Node.js 14.x
Bibliothèques et frameworks tiers tels que OpenSSL, .NET Framework 4.5 et Java EE
Le cycle de vie de chaque dépendance est géré par sa communauté linguistique ou son éditeur, qui publie son propre calendrier de fin de vie.
Politiques de maintenance des communautés linguistiques :
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
Lorsqu'une communauté ou un éditeur met fin à la prise en charge d'une version de langage, Alibaba Cloud continue de prendre en charge cette version dans les SDK pendant au moins un an.
Une version de langage fait référence à une publication spécifique d'un langage de programmation, telle que Java 8 ou Python 3.7.
5. Politique de fin de prise en charge
5,1 Point de déclenchement
Lorsqu'une communauté linguistique annonce la fin de prise en charge d'une version de langage ou d'une dépendance, Alibaba Cloud publie une annonce de fin de prise en charge dans un délai d'environ un an et met fin à la prise en charge six mois plus tard. Les SDK existants continuent de fonctionner, mais aucun correctif de sécurité ni aucune nouvelle fonctionnalité n'est fourni.
5,2 Contenu de l'annonce
Raisons spécifiques de la fin de prise en charge
Date précise de la fin de prise en charge
Étapes pour continuer à utiliser les SDK existants et mettre à jour vers les SDK pris en charge
Références de migration
5,3 Méthodes de notification
Alibaba Cloud explique la raison de la fin de prise en charge et notifie les utilisateurs via les canaux suivants :
Publication d'une annonce de fin de prise en charge un an à l'avance via les références SDK dans OpenAPI Portal et Help Center, et envoi de messages internes dans OpenAPI Portal et la console Alibaba Cloud.
Mise à disposition de références de migration dans OpenAPI Portal et Help Center.
Ajout d'avertissements internes au SDK pour certains langages. Par exemple, un avertissement s'affiche lorsque vous installez une version de SDK non prise en charge.