AWS Python SDK(boto3)のリソース・インターフェースが改修凍結されました

AWS Python SDK(boto3)のドキュメントに、リソース・インターフェースの改修凍結の案内があったので、共有します。

注意

AWS Python SDKチームは、boto3のリソースインターフェイスに新しい機能を追加するつもりはありません。 既存のインターフェイスは、boto3のライフサイクルの間は引き続き機能します。顧客は、クライアントインターフェイスを通じて新しいサービスの機能にアクセスすることができます。

※ChatGPT翻訳

AWS Python SDK(boto3)のインターフェースについて

AWS Python SDK(boto3)には主に次の2インターフェースがあります。

1 : REST APIを呼び出すクライアント・インターフェース

import boto3
s3 = boto3.client('s3')
s3.list_buckets()

2 : ORMっぽくAWSリソースを操作するリソース・インターフェース

s3 = boto3.resource('s3')
obj = s3.Object(bucket_name='boto3', key='test.py')

AWS Python SDKチームによると、後者のリソース・インターフェースに対する機能追加や重要でないバグ修正は今後行われなくなる予定です。 改修凍結されるだけであり、既存コードが動かなくなることはありません。

新しいAPIは、クライアント・インターフェース経由でお使いください。

当初の非推奨警告をフカヨミする

2023/01/09 ごろから、boto3 の Pull Request #3539により、次の警告文が記載されていました

警告

AWS Python SDKチームは、boto3のリソースインターフェイスをサポートすることをもう計画していません。リソースモデルを含む新しい変更の要求はもう受け付けられなくなり、次の主要バージョンのAWS SDK for Pythonではリソースインターフェイスがサポートされません。AWS SDKチームは、SDK間の機能の一貫性を達成するために努力しており、個別のSDKでカスタマイズされた抽象化を実装することは今後の継続可能な解決策ではありません。将来の新機能の要求は、クロスSDKレベルで検討する必要があります。

※ChatGPT翻訳

リソース・インターフェースに対して機能追加は今後行われず、次のメジャーバージョンでは廃止というインパクトの大きな告知です。警告(Warning)も納得です。

Reddit(スレッド1, スレッド2)でも多くの開発者が反応していました。

GitHubのboto3のDiscussionでのやり取りを経て、AWS Python SDKチームの真意は異なり、boto3のリソース・インターフェースは残り続けると判明します。

元の警告文を再確認すると、AWS Python SDKとboto3(現在のAWS Python SDKのライブラリ名)を使い分けていることに気づきます。

• boto3のリソース・インターフェースのメンテナンス方針について
• 次のバージョンのAWS Python SDKではリソース・インターフェースをサポートしない

多くの人は、AWS Python SDKの次のメジャーバージョンとboto3の次のメジャーバージョンを同一視し、boto3のバージョンアップでアプリケーションが動かなくなることを懸念していましたが、AWS Python SDKチームは、次のメジャーバージョン向けにboto3とは異なる新しいライブラリを開発予定のため、このように表現したものと思われます。

一方で、次期バージョンの AWS Python SDK は boto3 との互換性を重要視しない可能性が高いです。 リソース・インターフェースがなくなる以外にも、どのような影響があるのか、AWS Python SDKの今後のアナウンスを注視したいと思います。

AWS Python SDK の変遷

参考

• Resources — Boto3 Docs 1.26.51 documentation
• Add resource interface deprecation warning by tim-finnigan · Pull Request #3539 · boto/boto3
• More info about resource deprecation? · Discussion #3563 · boto/boto3