Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS Budgets を使用した の例 AWS CLI 次のコード例は、 AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています AWS Budgets。 *アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。 各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。 **Topics** + [アクション](#actions) ## アクション ### `create-budget` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-budget.html)」を参照してください。 ### `create-notification` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-notification.html)」を参照してください。 ### `create-subscriber` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-subscriber.html)」を参照してください。 ### `delete-budget` 次のコード例では、`delete-budget` を使用する方法を示しています。 **AWS CLI** **使用量の予算を削除する方法** この例では、指定されたコストと使用量の予算を削除します。 コマンド: ``` aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget" ``` + API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-budget.html)」を参照してください。 ### `delete-notification` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-notification.html)」を参照してください。 ### `delete-subscriber` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-subscriber.html)」を参照してください。 ### `describe-budget` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budget.html)」を参照してください。 ### `describe-budgets` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budgets.html)」を参照してください。 ### `describe-notifications-for-budget` 次のコード例では、`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" } ] } ``` + API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeNotificationsForBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-notifications-for-budget.html)」を参照してください。 ### `describe-subscribers-for-notification` 次のコード例では、`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" } ] } ``` + API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeSubscribersForNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-subscribers-for-notification.html)」を参照してください。 ### `update-budget` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-budget.html)」を参照してください。 ### `update-notification` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-notification.html)」を参照してください。 ### `update-subscriber` 次のコード例では、`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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-subscriber.html)」を参照してください。