[アップデート]AWSの無料利用枠の利用状況をAPIで確認できるようになりました #AWSreinvent

コンニチハ、千葉です。

AWSの無料利用枠をどれくらい利用してるか、残りどれくらいかの利用枠の利用状況をAPIで確認できるようになりました。もともとマネジメントコンソールから確認できましたが今回のアップデートで、AWS CLI、各種SDKなどからアクセスできるようになりました。

やってみた

さっそく試してみます。今回は、CloudShell を使って AWS CLI で確認しました。

$ aws --version
aws-cli/2.13.39 Python/3.11.6 Linux/6.1.59-84.139.amzn2023.x86_64 exec-env/CloudShell exe/x86_64.amzn.2 prompt/off

バージョンは、AWS CLI version2は「2.13.39」、AWS CLI version1は「1.30.7」で対応しているので適宜アップデートしましょう。 参考：https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

コマンドを実行してみましょう。 ※手元の環境で無料枠がある環境が用意できなかったので、AWSドキュメントから引用しています。 引用：https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/using-free-tier-api.html

$ aws freetier get-free-tier-usage --filter '{"Dimensions": {"Key": "SERVICE", "Values": ["EC2"], "MatchOptions": {
    "freeTierUsages": [
        {
            "actualUsageAmount": 287.0,
            "description": "1000000.0 Request are always free per month as part of AWS Free Usage Tier (Global-Catalog-Request)",
            "forecastedUsageAmount": 2224.25,
            "freeTierType": "Always Free",            
            "limit": 1000000.0,
            "operation": "Request",   
            "region": "global",   
            "service": "AWS Glue",                              
            "unit": "Request",
            "usageType": "Catalog-Request"            
        },
        {
            "actualUsageAmount": 176.36827958,
            "description": "1000000.0 Obj-Month are always free per month as part of AWS Free Usage Tier (Global-Catalog-Storage)",            
            "forecastedUsageAmount": 1366.8541667450002,
            "freeTierType": "Always Free",                                
            "limit": 1000000.0,
            "operation": "Storage", 
            "region": "global",
            "service": "AWS Glue",
            "unit": "Obj-Month",
            "usageType": "Catalog-Storage"            
        }
    ]
}

CLIやSDKから情報取得できるようになったので、独自のプログラムによるデータ蓄積や分析に利用できます。

無料枠について改めて確認する場合は、こちらの記事が詳しいです。

改めてAWSの「無料利用枠」を知ろう

https://dev.classmethod.jp/articles/overall-summary-about-aws-free-tier

さいごに

今までは、無料枠はマネージメントコンソールからのみ確認できました。 今回のアップデートで、SDKやCLIなどのプログラムからアクセスし分析することで、意図しない従量課金が発生しないよう予測や予防するようなプログラムを作成できますね。

また参考として現在提供されている無料枠は以下より確認できます。

https://aws.amazon.com/free/?all-free-tier.sort-by=item.additionalFields.SortRank&all-free-tier.sort-order=asc&awsf.Free%20Tier%20Types=*all&awsf.Free%20Tier%20Categories=*all

それではまた!

参考

https://aws.amazon.com/about-aws/whats-new/2023/11/aws-free-tier-usage-getfreetierusage-api/ https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/using-free-tier-api.html https://aws.amazon.com/jp/blogs/aws/check-your-aws-free-tier-usage-programmatically-with-a-new-api/ https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst