AWS Budgets 使用示例 AWS CLI

以下代码示例向您展示了如何使用with来执行操作和实现常见场景 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详细信息，请参阅 “CreateBudget AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “CreateNotification AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “CreateSubscriber AWS CLI命令参考”。

以下代码示例演示如何使用 delete-budget。

AWS CLI

删除成本和使用量预算

此示例删除了指定的成本和使用量预算。

命令:


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

有关API详细信息，请参阅 “DeleteBudget AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DeleteNotification AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DeleteSubscriber AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DescribeBudget AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DescribeBudgets AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DescribeNotificationsForBudget AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “DescribeSubscribersForNotification AWS CLI命令参考”。

以下代码示例演示如何使用 update-budget。

AWS CLI

替换成本和使用情况预算的预算

此示例将成本和使用量预算替换为新预算。

命令:


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

新预算.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详细信息，请参阅 “UpdateBudget AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “UpdateNotification AWS CLI命令参考”。

以下代码示例演示如何使用 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详细信息，请参阅 “UpdateSubscriber AWS CLI命令参考”。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

AWS Batch

Amazon Chime