Exemples d’utilisation de l’AWS CLI avec AWS Budgets - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec AWS Budgets

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS Budgets.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-budget.

AWS CLI

Pour créer un budget de coûts et d’utilisation

La commande create-budget suivante crée un budget de coûts et d’utilisation.

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

Contenu de 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"
}

Contenu de notifications-with-subscribers.json :

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

  • Pour plus de détails sur l’API, consultez CreateBudget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-notification.

AWS CLI

Pour créer une notification pour le budget de coûts et d’utilisation spécifié

Cet exemple crée une notification pour le budget de coûts et d’utilisation spécifié.

Commande :

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

  • Pour plus de détails sur l’API, consultez CreateNotification dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-subscriber.

AWS CLI

Pour créer un abonné pour une notification associée à un budget de coûts et d’utilisation

Cet exemple crée un abonné pour la notification spécifiée.

Commande :

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

  • Pour plus de détails sur l’API, consultez CreateSubscriber dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-budget.

AWS CLI

Pour supprimer un budget de coûts et d’utilisation

Cet exemple supprime le budget de coûts et d’utilisation spécifié.

Commande :

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

  • Pour plus de détails sur l’API, consultez DeleteBudget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-notification.

AWS CLI

Pour supprimer une notification d’un budget

Cet exemple supprime la notification spécifiée du budget spécifié.

Commande :

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

  • Pour plus de détails sur l’API, consultez DeleteNotification dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-subscriber.

AWS CLI

Pour supprimer un abonné d’une notification

Cet exemple supprime l’abonné spécifié de la notification spécifiée.

Commande :

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

  • Pour plus de détails sur l’API, consultez DeleteSubscriber dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-budget.

AWS CLI

Pour récupérer un budget associé à un compte

Cet exemple extrait le budget de coûts et d’utilisation spécifié.

Commande :

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

Sortie :

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

  • Pour plus de détails sur l’API, consultez DescribeBudget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-budgets.

AWS CLI

Pour récupérer les budgets associés à un compte

Cet exemple extrait les budgets de coûts et d’utilisation d’un compte.

Commande :

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

Sortie :

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

  • Pour plus de détails sur l’API, consultez DescribeBudgets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-notifications-for-budget.

AWS CLI

Pour récupérer les notifications relatives à un budget

Cet exemple extrait les notifications relatives à un budget de coûts et d’utilisation.

Commande :

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

Sortie :

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

L’exemple de code suivant montre comment utiliser describe-subscribers-for-notification.

AWS CLI

Pour récupérer les abonnés à une notification relative à un budget

Cet exemple extrait les abonnés à une notification relative au budget de coûts et d’utilisation.

Commande :

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

Sortie :

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

L’exemple de code suivant montre comment utiliser update-budget.

AWS CLI

Pour remplacer un budget par un budget de coûts et d’utilisation

Cet exemple remplace un budget de coûts et d’utilisation par un nouveau budget.

Commande :

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

  • Pour plus de détails sur l’API, consultez UpdateBudget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-notification.

AWS CLI

Pour remplacer une notification relative à un budget de coûts et d’utilisation

Cet exemple remplace une notification de 80 % pour un budget de coûts et d’utilisation par une notification de 90 %.

Commande :

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

  • Pour plus de détails sur l’API, consultez UpdateNotification dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-subscriber.

AWS CLI

Pour remplacer un abonné à un budget de coûts et d’utilisation

Cet exemple remplace l’abonné à un budget de coûts et d’utilisation.

Commande :

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

  • Pour plus de détails sur l’API, consultez UpdateSubscriber dans la Référence des commandes de l’AWS CLI.