AWS Budgets 使用範例 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWS Budgets 使用範例 AWS CLI

下列程式碼範例說明如何使用 AWS Command Line Interface 與來執行動作及實作常見案例 AWS Budgets。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用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

下列程式碼範例會示範如何使用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

下列程式碼範例會示範如何使用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

新的預算:

{ "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

若要取代成本與用量預算的通知

此範例會以 90% 的通知取代「成本與用量」預算的 80% 通知。

命令:

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

下列程式碼範例會示範如何使用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中的。