AWS Budgets examples using AWS CLI - AWS Command Line Interface
アクション

AWS Budgets examples using AWS CLI

次のコード例では、AWS Budgets で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

トピック

アクション

次のコード例では、create-budget を使用する方法を示しています。

AWS CLI

使用量の予算を作成する方法

次の create-budget コマンドは、コストと使用状況の予算を作成します。

aws budgets create-budget \
    --account-id 111122223333 \
    --budget file://budget.json \
    --notifications-with-subscribers file://notifications-with-subscribers.json

budget.json の内容:

{
    "BudgetLimit": {
        "Amount": "100",
        "Unit": "USD"
    },
    "BudgetName": "Example Tag Budget",
    "BudgetType": "COST",
    "CostFilters": {
        "TagKeyValue": [
            "user:Key$value1",
            "user:Key$value2"
        ]
    },
    "CostTypes": {
        "IncludeCredit": true,
        "IncludeDiscount": true,
        "IncludeOtherSubscription": true,
        "IncludeRecurring": true,
        "IncludeRefund": true,
        "IncludeSubscription": true,
        "IncludeSupport": true,
        "IncludeTax": true,
        "IncludeUpfront": true,
        "UseBlended": false
    },
    "TimePeriod": {
        "Start": 1477958399,
        "End": 3706473600
    },
    "TimeUnit": "MONTHLY"
}

notifications-with-subscribers.json の内容:

[
    {
        "Notification": {
            "ComparisonOperator": "GREATER_THAN",
            "NotificationType": "ACTUAL",
            "Threshold": 80,
            "ThresholdType": "PERCENTAGE"
        },
        "Subscribers": [
            {
                "Address": "example@example.com",
                "SubscriptionType": "EMAIL"
            }
        ]
    }
]

  • API の詳細については、「AWS CLI コマンドリファレンス」の「CreateBudget」を参照してください。

次のコード例では、create-notification を使用する方法を示しています。

AWS CLI

指定されたコストと使用量の予算の通知を作成する方法

この例では、指定されたコストと使用量の予算の通知を作成します。

コマンド:

aws budgets create-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

  • API の詳細については、「AWS CLI コマンドリファレンス」の「CreateNotification」を参照してください。

次のコード例では、create-subscriber を使用する方法を示しています。

AWS CLI

コストと使用量の予算に関連付けられた通知のサブスクライバーを作成する方法

この例では、指定された通知のサブスクライバーを作成します。

コマンド:

aws budgets create-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

  • API の詳細については、「AWS CLI コマンドレットリファレンス」の「CreateSubscriber」を参照してください。

次のコード例では、delete-budget を使用する方法を示しています。

AWS CLI

使用量の予算を削除する方法

この例では、指定されたコストと使用量の予算を削除します。

コマンド:

aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget"

  • API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteBudget」を参照してください。

次のコード例では、delete-notification を使用する方法を示しています。

AWS CLI

予算から通知を削除する方法

この例では、指定された予算から指定された通知を削除します。

コマンド:

aws budgets delete-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE

  • API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteNotification」を参照してください。

次のコード例では、delete-subscriber を使用する方法を示しています。

AWS CLI

通知からサブスクライバーを削除する方法

この例では、指定された通知から指定されたサブスクライバーを削除します。

コマンド:

aws budgets delete-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

  • API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteSubscriber」を参照してください。

次のコード例では、describe-budget を使用する方法を示しています。

AWS CLI

アカウントに関連付けられた予算を取得する方法

この例では、指定されたコストと使用量の予算を取得します。

コマンド:

aws budgets describe-budget --account-id 111122223333 --budget-name "Example Budget"

出力:

{
   "Budget": {
       "CalculatedSpend": {
           "ForecastedSpend": {
               "Amount": "2641.54800000000022919266484677791595458984375",
               "Unit": "USD"
           },
           "ActualSpend": {
               "Amount": "604.4560000000000172803993336856365203857421875",
               "Unit": "USD"
           }
       },
       "BudgetType": "COST",
       "BudgetLimit": {
           "Amount": "100",
           "Unit": "USD"
       },
       "BudgetName": "Example Budget",
       "CostTypes": {
           "IncludeOtherSubscription": true,
           "IncludeUpfront": true,
           "IncludeRefund": true,
           "UseBlended": false,
           "IncludeDiscount": true,
           "UseAmortized": false,
           "IncludeTax": true,
           "IncludeCredit": true,
           "IncludeSupport": true,
           "IncludeRecurring": true,
           "IncludeSubscription": true
       },
       "TimeUnit": "MONTHLY",
       "TimePeriod": {
           "Start": 1477958399.0,
           "End": 3706473600.0
       },
       "CostFilters": {
           "AZ": [
               "us-east-1"
           ]
       }
   }
}

  • API の詳細については、「AWS CLI コマンドリファレンス」の「DescribeBudget」を参照してください。

次のコード例では、describe-budgets を使用する方法を示しています。

AWS CLI

アカウントに関連付けられた予算を取得する方法

この例では、アカウントのコストと使用状況の予算を取得します。

コマンド:

aws budgets describe-budgets --account-id 111122223333 --max-results 20

出力:

{
   "Budgets": [
       {
           "CalculatedSpend": {
               "ForecastedSpend": {
                   "Amount": "2641.54800000000022919266484677791595458984375",
                   "Unit": "USD"
               },
               "ActualSpend": {
                   "Amount": "604.4560000000000172803993336856365203857421875",
                   "Unit": "USD"
               }
           },
           "BudgetType": "COST",
           "BudgetLimit": {
               "Amount": "100",
               "Unit": "USD"
           },
           "BudgetName": "Example Budget",
           "CostTypes": {
               "IncludeOtherSubscription": true,
               "IncludeUpfront": true,
               "IncludeRefund": true,
               "UseBlended": false,
               "IncludeDiscount": true,
               "UseAmortized": false,
               "IncludeTax": true,
               "IncludeCredit": true,
               "IncludeSupport": true,
               "IncludeRecurring": true,
               "IncludeSubscription": true
           },
           "TimeUnit": "MONTHLY",
           "TimePeriod": {
               "Start": 1477958399.0,
               "End": 3706473600.0
           },
           "CostFilters": {
               "AZ": [
                   "us-east-1"
               ]
           }
       }
   ]
}

  • API の詳細については、「AWS CLI コマンドリファレンス」の「DescribeBudgets」を参照してください。

次のコード例では、describe-notifications-for-budget を使用する方法を示しています。

AWS CLI

予算の通知を取得する方法

この例では、コストと使用状況の予算の通知を取得します。

コマンド:

aws budgets describe-notifications-for-budget --account-id 111122223333 --budget-name "Example Budget" --max-results 5

出力:

{
   "Notifications": [
       {
           "Threshold": 80.0,
           "ComparisonOperator": "GREATER_THAN",
           "NotificationType": "ACTUAL"
       }
   ]
}

次のコード例では、describe-subscribers-for-notification を使用する方法を示しています。

AWS CLI

予算の通知のサブスクライバーを取得する方法

この例では、コストと使用状況の予算通知のサブスクライバーを取得します。

コマンド:

aws budgets describe-subscribers-for-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5

出力:

{
   "Subscribers": [
       {
           "SubscriptionType": "EMAIL",
           "Address": "example2@example.com"
       },
       {
           "SubscriptionType": "EMAIL",
           "Address": "example@example.com"
       }
   ]
}

次のコード例では、update-budget を使用する方法を示しています。

AWS CLI

コストと使用状況の予算の予算を置き換える方法

この例では、コストと使用量の予算を新しい予算に置き換えます。

コマンド:

aws budgets update-budget --account-id 111122223333 --new-budget file://new-budget.json

new-budget.json:

{
    "BudgetLimit": {
       "Amount": "100",
       "Unit": "USD"
    },
    "BudgetName": "Example Budget",
    "BudgetType": "COST",
    "CostFilters": {
       "AZ" : [ "us-east-1" ]
    },
    "CostTypes": {
       "IncludeCredit": false,
       "IncludeDiscount": true,
       "IncludeOtherSubscription": true,
       "IncludeRecurring": true,
       "IncludeRefund": true,
       "IncludeSubscription": true,
       "IncludeSupport": true,
       "IncludeTax": true,
       "IncludeUpfront": true,
       "UseBlended": false,
       "UseAmortized": true
    },
    "TimePeriod": {
       "Start": 1477958399,
       "End": 3706473600
    },
    "TimeUnit": "MONTHLY"
 }

  • API の詳細については、「AWS CLI コマンドリファレンス」の「UpdateBudget」を参照してください。

次のコード例では、update-notification を使用する方法を示しています。

AWS CLI

コストと使用量の予算の通知を置き換える方法

この例では、コストと使用状況の予算の 80% の通知を 90% の通知に置き換えます。

コマンド:

aws budgets update-notification --account-id 111122223333 --budget-name "Example Budget" --old-notification  NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --new-notification  NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE

  • API の詳細については、「AWS CLI コマンドリファレンス」の「UpdateNotification」を参照してください。

次のコード例では、update-subscriber を使用する方法を示しています。

AWS CLI

コストと使用状況の予算のサブスクライバーを置き換える方法

この例では、サブスクライバーをコストと使用量の予算に置き換えます。

コマンド:

aws budgets update-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --old-subscriber SubscriptionType=EMAIL,Address=example@example.com --new-subscriber SubscriptionType=EMAIL,Address=example2@example.com

  • API の詳細については、「AWS CLI コマンドリファレンス」の「UpdateSubscriber」を参照してください。