Fetches and displays the monthly total AWS billing using the AWS Cost Explorer API.

aws_monthly_billing

#!/bin/sh
######################################
# NAME
#  aws_monthly_billing - Fetches and displays the monthly total AWS billing using the AWS Cost Explorer API.
#
# SYNOPSIS
#  aws_monthly_billing [AWS_CLI_OPTIONS]
#
# DESCRIPTION
#  This script retrieves the monthly total AWS billing by querying the AWS Cost Explorer API. The script defaults to the current month but allows users to specify a custom time period using environment variables START and END.
#
# AUTHOR
#  Masaki Waga
#
# LICENSE
#  Apache License, Version 2.0
######################################

set -eu

# Set default time period to the current month unless specified by the user
START=${START:-$(date +%Y-%m-01)}
if [ "$(uname)" = Darwin ]; then
    # macOS
    END=${END:-$(date -v+1d +%Y-%m-%d)}
else
    # Linux
    END=${END:-$(date -d tomorrow +%Y-%m-%d)}
fi

aws ce get-cost-and-usage "$@" \
  --time-period Start="$START",End="$END" \
  --granularity MONTHLY \
  --metrics UnblendedCost |
    jq -r '.ResultsByTime[] | "Total usage from " + .TimePeriod.Start + " to " + .TimePeriod.End + ": " + .Total.UnblendedCost.Amount + " " + .Total.UnblendedCost.Unit'