Beispiele für die Verwendung der AWS CLI mit AWS Budgets - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit AWS Budgets

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit AWS Budgets nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-budget verwendet wird.

AWS CLI

So erstellen Sie ein Kosten- und Nutzungsbudget

Mit dem folgenden create-budget-Befehl wird ein Kosten- und Nutzungsbudget erstellt.

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

Inhalt von 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"
}

Inhalt von notifications-with-subscribers.json:

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

  • API-Details finden Sie unter CreateBudget in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-notification verwendet wird.

AWS CLI

So erstellen Sie eine Benachrichtigung für das angegebene Kosten- und Nutzungsbudget

In diesem Beispiel wird eine Benachrichtigung für das angegebene Kosten- und Nutzungsbudget erstellt.

Befehl:

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

Das folgende Codebeispiel zeigt, wie create-subscriber verwendet wird.

AWS CLI

So erstellen einen Abonnenten für eine Benachrichtigung, die einem Kosten- und Nutzungsbudget zugeordnet ist

In diesem Beispiel wird ein Abonnent für die angegebene Benachrichtigung erstellt.

Befehl:

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

Das folgende Codebeispiel zeigt, wie delete-budget verwendet wird.

AWS CLI

So löschen Sie ein Kosten- und Nutzungsbudget

In diesem Beispiel wird das angegebene Kosten- und Nutzungsbudget gelöscht.

Befehl:

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

  • API-Details finden Sie unter DeleteBudget in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-notification verwendet wird.

AWS CLI

So löschen Sie eine Benachrichtigung aus einem Budget

In diesem Beispiel wird die angegebene Benachrichtigung aus dem spezifizierten Budget gelöscht.

Befehl:

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

Das folgende Codebeispiel zeigt, wie delete-subscriber verwendet wird.

AWS CLI

So löschen Sie einen Abonnenten aus einer Benachrichtigung

In diesem Beispiel wird der angegebene Abonnent aus der spezifizierten Benachrichtigung gelöscht.

Befehl:

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

Das folgende Codebeispiel zeigt, wie describe-budget verwendet wird.

AWS CLI

So rufen Sie ein einem Konto zugeordnetes Budget ab

In diesem Beispiel wird das angegebene Kosten- und Nutzungsbudget abgerufen.

Befehl:

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

Ausgabe:

{
   "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-Details finden Sie unter DescribeBudget in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-budgets verwendet wird.

AWS CLI

So rufen Sie die einem Konto zugeordneten Budgets ab

In diesem Beispiel werden die Kosten- und Nutzungsbudgets für ein Konto abgerufen.

Befehl:

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

Ausgabe:

{
   "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-Details finden Sie unter DescribeBudgets in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-notifications-for-budget verwendet wird.

AWS CLI

So rufen Sie die Benachrichtigungen für ein Budget ab

In diesem Beispiel werden die Benachrichtigungen für ein Kosten- und Nutzungsbudget abgerufen.

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-subscribers-for-notification verwendet wird.

AWS CLI

So rufen Sie die Abonnenten für eine Budgetbenachrichtigung ab

In diesem Beispiel werden die Abonnenten für eine Kosten- und Nutzungsbudgetbenachrichtigung abgerufen.

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie update-budget verwendet wird.

AWS CLI

So ersetzen Sie ein Budget für ein Kosten- und Nutzungsbudget

In diesem Beispiel wird ein Kosten- und Nutzungsbudget durch ein neues Budget ersetzt.

Befehl:

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-Details finden Sie unter UpdateBudget in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-notification verwendet wird.

AWS CLI

So ersetzen Sie eine Benachrichtigung für ein Kosten- und Nutzungsbudget

In diesem Beispiel wird eine 80-%-Benachrichtigung für ein Kosten- und Nutzungsbudget durch eine 90-%-Benachrichtigung ersetzt.

Befehl:

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

Das folgende Codebeispiel zeigt, wie update-subscriber verwendet wird.

AWS CLI

So ersetzen Sie einen Abonnenten für ein Kosten- und Nutzungsbudget

In diesem Beispiel wird ein Abonnent für ein Kosten- und Nutzungsbudget ersetzt.

Befehl:

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